連接器存取權有三個獨立層級:成員的連線、智能體的授權,以及授予該智能體的具名權限。連接服務並不會默默地賦予每個智能體所有操作權限。
連線、授權與權限
| 層級 | 控制內容 |
|---|---|
| 連線 | 哪個成員帳號或憑證可用於該服務。 |
| 智能體授權 | 哪個智能體可使用該已連線的服務。 |
| 權限授予 | 該智能體可請求哪些具名操作,以及可用多久。 |
對於需要每位成員各自憑證的服務,每位成員需連接自己的帳號。共用智能體仍然是透過執行者的已連線帳號與授權來操作;它不會繼承隊友的收件匣、權杖或私人對話紀錄。
授予存取權
當智能體需要尚未擁有的連接器權限時,Okou 會顯示權限請求。請在選擇 允許 或 拒絕 前,審查連接器、智能體、權限名稱及原因。
允許的權限可選擇產品中提供的有效期間:
- 允許 1 小時
- 允許 24 小時
- 允許 7 天
- 永久允許
時效性授權到期後,智能體必須再次請求。拒絕某項權限不會斷開帳號連線,也不會移除無關的權限。
你可在智能體的授權設定中管理其現有連接器存取權。連接器存取檢視會顯示哪些智能體已獲授權,以及其權限狀態為允許、拒絕或混合。
憑證處理
OAuth 權杖與手動輸入的密鑰會儲存在平台上。對於連接器請求,防火牆會在網路邊界注入憑證;密鑰不會以環境變數形式暴露給智能體程式碼。
請勿將 API 金鑰、OAuth 權杖、密碼或用戶端密鑰貼到對話、智能體指令、工作流程指令或附加檔案中。請改用連接器的連線流程。
斷開成員的連接器會使該連線不再用於未來執行。移除智能體授權則會阻止該智能體使用該連接器,但不影響其他已授權智能體。
審批邊界
可強制執行的邊界是連接器的具名權限授予。請勿僅依賴通用操作類別來保證每封郵件、貼文、付款、基礎設施變更或刪除都會以相同方式暫停。
對於必須保有人為審查的工作:
- 僅授予讀取或草稿權限,並在連接器有分開權限時,拒絕最終寫入或傳送權限。
- 在智能體或工作流程指令中明確說明審查需求。
- 將最終操作保留給人類,例如產生 Gmail 草稿或提案變更,而非直接傳送或套用。
同時也請善用上游服務的控管:限定範圍的 API 金鑰、最小權限 OAuth 範圍、儲存庫權限,以及獨立的正式憑證。
對話、日誌與管理員可見性
成員可存取自己的對話串。發佈智能體或工作流程不會公開成員的私人對話紀錄或連接器憑證。僅能透過明確的分享介面分享對話或產出物。
工作區管理員可查看用於計費與容量管理的成員層級使用量彙總。這不會自動讓管理員跨成員檢視私人對話內容。
在成員自己的對話中,活動檢視會記錄可見的執行序列、連接器活動、產出物、狀態與錯誤。你可用來驗證所請求的連接器操作是否已執行及其結果。
審查清單
- 連接器是否連結到預期的成員帳號?
- 預期的智能體是否已獲授權?
- 是否僅允許此任務所需的權限?
- 授權是否可在 1 小時、24 小時或 7 天後到期,而非永久?
- 工作流程是否將不可逆或對外操作保留在人為審查步驟?
- 上游憑證是否還能進一步限縮?

