參考資料
Claude Managed Agents 的事件類型、自行託管 worker CLI 旗標、支援的 MCP 伺服器類型、速率限制以及品牌使用準則。
本頁彙整了 Claude Managed Agents 的參考資料。如需以任務為導向的指南，請依循各節中的連結。關於 session 資源的操作，請參閱 Session 操作。
事件類型
持久化的事件類型字串遵循 {domain}.{action} 命名慣例；僅限串流的事件增量（event deltas，請參閱「事件增量」分頁）則是例外。關於傳送、串流及列出事件，請參閱 Session 事件串流。Webhook 事件類型另行列於訂閱 webhook，其中部分名稱與串流中的名稱不同（例如 session.status_idled 而非 session.status_idle）。
| 類型 | 說明 |
|---|---|
user.message | 包含文字、圖片或文件內容的使用者訊息。 |
user.interrupt | 在執行途中停止代理。 |
user.custom_tool_result | 對代理發出之自訂工具呼叫的回應。 |
user.tool_confirmation | 當權限政策要求確認時，核准或拒絕代理或 MCP 工具呼叫。 |
user.define_outcome | 定義一個供代理努力達成的成果（outcome）。 |
user.tool_result | 僅適用於使用 self_hosted 環境的 session，您的整合需負責提供 agent_toolset 結果。SDK 輔助工具與 CLI 會自動處理此事。 |
自行託管 worker
以下是驅動 self_hosted 環境之預先建置 worker 的 ant beta:worker CLI 旗標。關於設定環境、執行 worker 以及 SDK 輔助工具選項，請參閱自行託管沙箱。
| 旗標 | 說明 |
|---|---|
--environment-id | 要輪詢工作的環境。也會從 ANTHROPIC_ENVIRONMENT_ID 讀取。 |
--environment-key | 以此環境驗證 worker 的身分。也會從 ANTHROPIC_ENVIRONMENT_KEY 讀取。 |
--workdir | 下載 skills 以及工具讀寫檔案的目錄。預設為 .（目前目錄）；系統預設工作目錄為 /workspace。 |
--on-work | 針對每個已領取的工作項目所呼叫的腳本，用以取代在行程內執行工具。會以環境變數的形式接收 session 詳細資訊。 |
--unrestricted-paths | 允許檔案工具讀寫 --workdir 以外的路徑。workdir 檢查僅是檔案工具的防護機制，而非沙箱；它不會限制 bash。 |
--max-idle | 在 session 以 end_turn 停止原因進入閒置狀態後，關閉前要等待多久。預設為 60s。 |
--log-format | 日誌輸出格式。使用 json 以進行結構化日誌擷取。預設為 text。 |
CLI worker 不會掛載記憶體儲存區：附加了記憶體儲存區的 session 仍會執行，但代理在儲存區的 mount_path 找不到任何內容，且不會有任何變更同步回儲存區。若要在自行託管環境上的 session 中使用記憶體儲存區，請改為執行 SDK worker；請參閱使用記憶體儲存區。
支援的 MCP 伺服器類型
Claude Managed Agents 可連線至公開 HTTP 端點的遠端 MCP 伺服器，或透過 MCP 通道連線至私有 MCP 伺服器。伺服器應支援 MCP 協定的 streamable HTTP 傳輸；僅支援已棄用之 SSE 傳輸的伺服器仍可透過自動回退機制運作。關於在代理上宣告伺服器，請參閱 MCP 連接器。
如需更多關於 MCP 及建置 MCP 伺服器的資訊，請參閱 MCP 文件。
速率限制
Managed Agents 端點依組織進行「rate limit」（速率限制）：
| 操作 | 限制 |
|---|---|
| 建立類端點（例如代理、session 與環境） | 每分鐘 300 個請求 |
| 讀取類端點（例如擷取、列出與串流） | 每分鐘 1,200 個請求 |
組織層級的支出限制與用量層級速率限制同樣適用。
品牌使用準則
對於整合 Claude Managed Agents 的合作夥伴，使用 Claude 品牌為選擇性的。在您的產品中提及 Claude 時：
允許：
- 「Claude Agent」（下拉式選單的首選）
- 「Claude」（當位於已標示為「Agents」的選單內時）
- 「{YourAgentName} Powered by Claude」（若您已有既有的代理名稱）
不允許：
- 「Claude Code」或「Claude Code Agent」
- 「Claude Cowork」或「Claude Cowork Agent」
- Claude Code 品牌的 ASCII 藝術或模仿 Claude Code 的視覺元素
您的產品應維持自身的品牌，且不應看起來像是 Claude Code、Claude Cowork 或任何其他 Anthropic 產品。如有品牌合規方面的問題，請聯繫 Anthropic 銷售團隊。
Was this page helpful?