GetMyBot 知識庫

預約與 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 儲存。因此切換夏令時間會改變建議的當地鐘點,不會改變已保存的絕對時刻。

預約流程會避免重複:

  1. 寫入前再次檢查所選時段。
  2. 以冪等鍵保存待確認預約,重複請求不會建立第二場會議。
  3. 在日曆建立事件,必要時附視訊會議連結。
  4. Google 日曆若逾時或暫時出錯,先依冪等鍵尋找預約,避免模糊逾時造成重複。
  5. 最後確認預約。提供者事件 ID 與會議連結以加密形式保存。

改期與取消採相同方法。若他人已佔用時段,操作會回報錯誤,不會重複預約。狀態包括待確認、已確認、已改期、已取消、錯誤。

授予代理人工具

在代理人編輯器的**「允許的工具」**開啟需要的動作:

  • 顯示空閒時段
  • 預約會議
  • 會議改期
  • 取消會議

每個已啟用的日曆工具都需指定至少一個目前已啟用的會議類型,否則就緒檢查不允許啟動代理人。啟用中的代理人目前只能實際執行日曆工具,其他工具尚未開放執行。

模型不能自行選日曆、客戶或任意請求,只能提出符合封閉結構的工具呼叫。機器人、訂閱者和允許的會議類型由伺服器情境填入。工具呼叫有 15 秒期限;冪等鍵由回合和呼叫序號組成;紀錄中的參數和結果會去除會議連結與聯絡資料。

報告

**「AI → 分析」將日曆動作和預約結果與其他代理人指標一起顯示;「AI → 日曆」**顯示預約本身。

遇到問題時

  • 開啟日曆工具,卻沒有啟用的會議類型:啟動代理人前建立或啟用一個類型。
  • 無法載入日曆清單:帳號可能需要重新連接;暫時也可手動輸入連接 ID。
  • 接下來一週沒有空檔:檢查每週時間、最短提前量、緩衝與日曆占用。
  • 會議類型正在使用,無法刪除:啟用中代理人的日曆工具仍引用它。

相關文章