你正在使用哪種體驗？
這些文件同時涵蓋兩種體驗。如果 設定 → 個人 → My Okou 可用，請依照 My Okou 步驟操作。如果你使用的是有 New agent 的 Agents 頁面，請依照 Legacy Agents 步驟操作。可用性可能因成員而異；這些文件不會改變你的體驗。
在任一種體驗中，你都可以同時執行多個聊天或任務、重複使用工作流程，並與團隊分享已審核的工作。執行時子代理是執行工具，不是你需要建立的獨立產品設定檔。
設定差異： My Okou 使用位於 設定 → 個人 → My Okou 的個人 Instructions，以及工作區 Workflows。下方任何要求你選取、建立或授權具名 Agent 的步驟，僅適用於 Legacy Agents。在 My Okou 中，請使用你自己的聊天，並依照顯示的帳戶與具名權限要求操作。共享的 Workflows 不會共享憑證；Automations 會使用其擁有者的情境與存取權。
自訂連接器可讓組織管理員註冊一個不在內建目錄中的 HTTPS API，或在已啟用時註冊一個 Streamable HTTP MCP server。它會定義網路邊界與驗證方法。它不會自動為 agent 產生完整的 API 參考資料。
由誰設定什麼
- 組織管理員 建立、編輯和刪除連接器定義。
- 成員 連接自己的密鑰，或完成連接器的 OAuth 流程。
- 授權與權限 控制 Okou 可透過此連線請求哪些具名動作。Legacy Agents 也會使用 Agent 專屬授權。
此定義會在組織中共享。成員憑證仍然只限於該成員與組織。
HTTP API 連接器
- 開啟 Connectors → Custom，然後選擇 New connector。
- 選取 HTTP API，並輸入顯示名稱。
- 新增一個或多個 HTTPS Prefixes，每行一個。要求必須先符合已設定的前綴，連接器才能授權它。
- 如果 API 需要驗證，請新增驗證方式：
- API authentication：輸入標頭名稱與包含
{{secret}}的標頭範本，例如Authorization和Bearer {{secret}}。 - OAuth 2.0：輸入授權 URL、權杖 URL、用戶端 ID、用戶端密鑰、scope，以及權杖端點驗證方法。在提供者端註冊表單中顯示的精確重新導向 URL。
- API authentication：輸入標頭名稱與包含
- 建立連接器。接著每位需要它的成員都選擇 Connect，並提供自己的密鑰或完成 OAuth。
- 檢閱並授權所需的具名權限。在 Legacy Agents 中，也請選取預期的 Agent。
變更現有的 OAuth 定義或其用戶端憑證，會使目前的 OAuth 連線中斷。成員必須在變更後重新連接。
MCP 連接器
如果你的工作區中 MCP 顯示為連接器類型，請輸入 HTTPS Streamable HTTP MCP 端點，並在同一表單中設定 API 或 OAuth 驗證。如果選擇器中沒有提供 MCP，表示該工作區未啟用 MCP。
教導 agent API 程序
自訂連接器提供安全的網路存取與憑證注入。建立表單不會上傳或自動探索 OpenAPI 文件。請在請求中向 agent 提供端點、方法、參數和預期回應，或在 workflow 中記錄該程序，並附上 API 參考資料檔案。
使用針對已知端點的狹窄唯讀請求來驗證新的連接器。沒有通用的 Test connection 請求，因為許多 API 並未提供有意義的根端點。
安全邊界
- 只接受 HTTPS 前綴和 MCP 端點。
- 防火牆只會將已儲存的憑證注入符合條件的請求。
- 已儲存的密鑰會在靜態儲存時加密，且不會以環境變數形式提供給 agent。
- 不要在聊天訊息、工作流程指示或附加檔案中放入金鑰、權杖或用戶端密鑰。
- 使用所需上游 scope 最少的服務憑證，以滿足工作流程需求。
疑難排解
| 問題 | 檢查 |
|---|---|
| New connector 無法使用 | 只有組織管理員可以建立或編輯連接器定義。 |
| 代理程式看不到連接器 | 為目前成員將其連接，並檢閱所需權限。在 Legacy Agents 中，也請授權預期的 Agent。 |
| 請求在到達 API 前就被封鎖 | 確認請求 URL 以其中一個已設定的 HTTPS 前綴開頭。 |
| API 回傳 401 或 403 | 重新連接成員憑證，並驗證上游金鑰或 OAuth scope。 |
| OAuth 回傳重新導向錯誤 | 在連接器表單中註冊顯示的精確重新導向 URL，並驗證授權與權杖 URL。 |
| 代理程式猜錯端點或載荷 | 將 API 程序放入工作流程，並附上相關參考資料，而不要只依賴連接器名稱。 |
