返回文件核心概念

權限

逐個連接器控制 Okou 可執行的操作—預設值、審批、稽核、撤銷。

最後更新於2026年10月29日 · 1 min read

連接器存取權有三個獨立層級:成員的連線、智能體的授權,以及授予該智能體的具名權限。連接服務並不會默默地賦予每個智能體所有操作權限。

連線、授權與權限

層級控制內容
連線哪個成員帳號或憑證可用於該服務。
智能體授權哪個智能體可使用該已連線的服務。
權限授予該智能體可請求哪些具名操作,以及可用多久。

對於需要每位成員各自憑證的服務,每位成員需連接自己的帳號。共用智能體仍然是透過執行者的已連線帳號與授權來操作;它不會繼承隊友的收件匣、權杖或私人對話紀錄。

授予存取權

當智能體需要尚未擁有的連接器權限時,Okou 會顯示權限請求。請在選擇 允許 或 拒絕 前,審查連接器、智能體、權限名稱及原因。

允許的權限可選擇產品中提供的有效期間:

  • 允許 1 小時
  • 允許 24 小時
  • 允許 7 天
  • 永久允許

時效性授權到期後,智能體必須再次請求。拒絕某項權限不會斷開帳號連線,也不會移除無關的權限。

你可在智能體的授權設定中管理其現有連接器存取權。連接器存取檢視會顯示哪些智能體已獲授權,以及其權限狀態為允許、拒絕或混合。

憑證處理

OAuth 權杖與手動輸入的密鑰會儲存在平台上。對於連接器請求,防火牆會在網路邊界注入憑證;密鑰不會以環境變數形式暴露給智能體程式碼。

請勿將 API 金鑰、OAuth 權杖、密碼或用戶端密鑰貼到對話、智能體指令、工作流程指令或附加檔案中。請改用連接器的連線流程。

斷開成員的連接器會使該連線不再用於未來執行。移除智能體授權則會阻止該智能體使用該連接器,但不影響其他已授權智能體。

審批邊界

可強制執行的邊界是連接器的具名權限授予。請勿僅依賴通用操作類別來保證每封郵件、貼文、付款、基礎設施變更或刪除都會以相同方式暫停。

對於必須保有人為審查的工作:

  1. 僅授予讀取或草稿權限,並在連接器有分開權限時,拒絕最終寫入或傳送權限。
  2. 在智能體或工作流程指令中明確說明審查需求。
  3. 將最終操作保留給人類,例如產生 Gmail 草稿或提案變更,而非直接傳送或套用。

同時也請善用上游服務的控管:限定範圍的 API 金鑰、最小權限 OAuth 範圍、儲存庫權限,以及獨立的正式憑證。

對話、日誌與管理員可見性

成員可存取自己的對話串。發佈智能體或工作流程不會公開成員的私人對話紀錄或連接器憑證。僅能透過明確的分享介面分享對話或產出物。

工作區管理員可查看用於計費與容量管理的成員層級使用量彙總。這不會自動讓管理員跨成員檢視私人對話內容。

在成員自己的對話中,活動檢視會記錄可見的執行序列、連接器活動、產出物、狀態與錯誤。你可用來驗證所請求的連接器操作是否已執行及其結果。

審查清單

  • 連接器是否連結到預期的成員帳號?
  • 預期的智能體是否已獲授權?
  • 是否僅允許此任務所需的權限?
  • 授權是否可在 1 小時、24 小時或 7 天後到期,而非永久?
  • 工作流程是否將不可逆或對外操作保留在人為審查步驟?
  • 上游憑證是否還能進一步限縮?

下一步

  • 請參閱對話以了解對話邊界內的運作。
  • 請參閱連接器以瀏覽目錄及各連接器功能。
  • 請參閱團隊專用以設定組織層級權限。