預約與 Google 日曆
讓 AI 代理人提供諮詢時段:連接 Google 日曆、設定可預約時間,允許預約、改期或取消。
本頁內容
AI 代理人可查看 Google 日曆的空檔並替客戶預約,例如安排工作日的 30 分鐘諮詢。依你授予的權限,它也可改期或取消。
在**「AI → 日曆」連接帳號、建立會議類型並檢查空檔,再到代理人設定中開啟需要的日曆動作。介面把可供預約的時間稱為時段(slot)**。
目前只支援 Google 日曆。會議類型、預約與代理人工具使用平台共用介面,但尚不能連接其他日曆提供者。
連接帳號
按**「連接 Google 日曆」**,在 Google 視窗同意存取日曆清單、事件和忙碌狀態。若五分鐘內未完成,請重新開始。
技術上,連接使用與機器人和帳號綁定的一次性 state、PKCE 驗證及固定回呼網址。state 有效五分鐘。
續期權杖以加密形式儲存,不會再次顯示。連接卡片只顯示帳號標籤及四種狀態之一:已連接、存取過期、已斷開、錯誤。過期時請重新連接。
若啟用中的代理人仍使用日曆工具,**「斷開日曆」**會被停用,介面會列出這些代理人。先移除其日曆工具或暫停代理人。
會議類型
會議類型決定代理人可向客戶提供什麼預約:
- 名稱:顯示在你的報告與客戶的日曆事件中。
- 日曆:從已連接帳號選擇。儲存的日曆 ID 會加密且不再顯示,因此編輯類型時需重新選擇。
- 時長:5–480 分鐘。
- 時區:IANA 名稱,例如
Europe/Berlin,用來解讀以下可預約時間。 - 可預約時間:每週 1–28 個時段,按星期和
HH:MM邊界設定。時段不能重疊;結束時間早於開始時間表示跨午夜。 - 會議前最短提前量:0–1,440 分鐘,短於此時間不可預約。
- 最遠可預約日:1–366 天後。
- 會前及會後緩衝:各 0–1,440 分鐘,預約前後保持空檔。
- 啟用狀態:只有已啟用的類型可以提供和預約。
「顯示空閒時段」會查詢已連接日曆接下來一週的實際結果,不是模擬。
如何挑選時段
空檔同時取決於會議類型的每週時間、日曆中的忙碌時段、前後緩衝,以及此連接已有的預約。候選時段間隔 15 分鐘,預設回傳 10 個,最多 20 個。
時間以客戶時區顯示,以 UTC 儲存。因此切換夏令時間會改變建議的當地鐘點,不會改變已保存的絕對時刻。
預約流程會避免重複:
- 寫入前再次檢查所選時段。
- 以冪等鍵保存待確認預約,重複請求不會建立第二場會議。
- 在日曆建立事件,必要時附視訊會議連結。
- Google 日曆若逾時或暫時出錯,先依冪等鍵尋找預約,避免模糊逾時造成重複。
- 最後確認預約。提供者事件 ID 與會議連結以加密形式保存。
改期與取消採相同方法。若他人已佔用時段,操作會回報錯誤,不會重複預約。狀態包括待確認、已確認、已改期、已取消、錯誤。
授予代理人工具
在代理人編輯器的**「允許的工具」**開啟需要的動作:
- 顯示空閒時段
- 預約會議
- 會議改期
- 取消會議
每個已啟用的日曆工具都需指定至少一個目前已啟用的會議類型,否則就緒檢查不允許啟動代理人。啟用中的代理人目前只能實際執行日曆工具,其他工具尚未開放執行。
模型不能自行選日曆、客戶或任意請求,只能提出符合封閉結構的工具呼叫。機器人、訂閱者和允許的會議類型由伺服器情境填入。工具呼叫有 15 秒期限;冪等鍵由回合和呼叫序號組成;紀錄中的參數和結果會去除會議連結與聯絡資料。
報告
**「AI → 分析」將日曆動作和預約結果與其他代理人指標一起顯示;「AI → 日曆」**顯示預約本身。
遇到問題時
- 開啟日曆工具,卻沒有啟用的會議類型:啟動代理人前建立或啟用一個類型。
- 無法載入日曆清單:帳號可能需要重新連接;暫時也可手動輸入連接 ID。
- 接下來一週沒有空檔:檢查每週時間、最短提前量、緩衝與日曆占用。
- 會議類型正在使用,無法刪除:啟用中代理人的日曆工具仍引用它。