Managed Agents參考

參考資料

Claude Managed Agents 的事件類型、自架工作程式 CLI 旗標、支援的 MCP 伺服器類型、速率限制與品牌指南。

本頁彙整 Claude Managed Agents 的參考資料。如需以任務為導向的指南，請依照各章節中的連結。關於 session 資源的操作，請參閱 Session 操作。

Managed Agents API 請求需要 managed-agents-2026-04-01 beta 標頭，但記憶體儲存端點除外，其使用 agent-memory-2026-07-22。SDK 會自動設定正確的 beta 標頭。請參閱 Beta 標頭。

事件類型

持久化的事件類型字串遵循 {domain}.{action} 命名慣例；僅限串流的事件增量（請參閱「事件增量」分頁）是例外。關於傳送、串流與列出事件，請參閱 Session 事件串流。

類型	說明
`user.message`	包含文字、圖片或文件內容的使用者訊息。
`user.interrupt`	在執行過程中停止代理。
`user.custom_tool_result`	對代理發出的自訂工具呼叫的回應。
`user.tool_confirmation`	當權限政策要求確認時，核准或拒絕代理或 MCP 工具呼叫。
`user.define_outcome`	定義一個供代理努力達成的成果。
`user.tool_result`	僅適用於使用 `self_hosted` 環境的 session，您的整合需負責提供 `agent_toolset` 結果。SDK 輔助工具與 CLI 會自動處理此事。

自架工作程式

以下是驅動 self_hosted 環境的預建工作程式的 ant beta:worker CLI 旗標。關於設定環境、執行工作程式以及 SDK 輔助工具選項，請參閱自架沙箱。

旗標	說明
`--environment-id`	要輪詢工作的環境。也會從 `ANTHROPIC_ENVIRONMENT_ID` 讀取。
`--environment-key`	以此環境驗證工作程式。也會從 `ANTHROPIC_ENVIRONMENT_KEY` 讀取。
`--workdir`	下載技能以及工具讀寫檔案的目錄。預設為 `.`（目前目錄）；系統預設工作目錄為 `/workspace`。
`--on-work`	針對每個已認領的工作項目呼叫的指令碼，而非在行程內執行工具。透過環境變數接收 session 詳細資訊。
`--unrestricted-paths`	允許檔案工具讀寫 `--workdir` 以外的路徑。workdir 檢查僅是檔案工具的防護措施，並非沙箱；它不會限制 bash。
`--max-idle`	在 session 以 `end_turn` 停止原因進入閒置狀態後，等待多久才關閉。預設為 `60s`。
`--log-format`	日誌輸出格式。使用 `json` 以進行結構化日誌擷取。預設為 `text`。

支援的 MCP 伺服器類型

Claude Managed Agents 可連接到公開 HTTP 端點的遠端 MCP 伺服器，或透過 MCP 通道連接到私有 MCP 伺服器。伺服器應支援 MCP 協定的可串流 HTTP 傳輸；僅支援已棄用的 SSE 傳輸的伺服器仍可透過自動回退機制運作。關於在代理上宣告伺服器，請參閱 MCP 連接器。

如需更多關於 MCP 與建置 MCP 伺服器的資訊，請參閱 MCP 文件。

速率限制

Managed Agents 端點依組織進行速率限制：

操作	限制
建立端點（例如代理、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?

Managed Agents參考

參考資料

Claude Managed Agents 的事件類型、自架工作程式 CLI 旗標、支援的 MCP 伺服器類型、速率限制與品牌指南。

本頁彙整 Claude Managed Agents 的參考資料。如需以任務為導向的指南，請依照各章節中的連結。關於 session 資源的操作，請參閱 Session 操作。

事件類型

類型	說明
`user.message`	包含文字、圖片或文件內容的使用者訊息。
`user.interrupt`	在執行過程中停止代理。
`user.custom_tool_result`	對代理發出的自訂工具呼叫的回應。
`user.tool_confirmation`	當權限政策要求確認時，核准或拒絕代理或 MCP 工具呼叫。
`user.define_outcome`	定義一個供代理努力達成的成果。
`user.tool_result`	僅適用於使用 `self_hosted` 環境的 session，您的整合需負責提供 `agent_toolset` 結果。SDK 輔助工具與 CLI 會自動處理此事。

自架工作程式

以下是驅動 self_hosted 環境的預建工作程式的 ant beta:worker CLI 旗標。關於設定環境、執行工作程式以及 SDK 輔助工具選項，請參閱自架沙箱。

旗標	說明
`--environment-id`	要輪詢工作的環境。也會從 `ANTHROPIC_ENVIRONMENT_ID` 讀取。
`--environment-key`	以此環境驗證工作程式。也會從 `ANTHROPIC_ENVIRONMENT_KEY` 讀取。
`--workdir`	下載技能以及工具讀寫檔案的目錄。預設為 `.`（目前目錄）；系統預設工作目錄為 `/workspace`。
`--on-work`	針對每個已認領的工作項目呼叫的指令碼，而非在行程內執行工具。透過環境變數接收 session 詳細資訊。
`--unrestricted-paths`	允許檔案工具讀寫 `--workdir` 以外的路徑。workdir 檢查僅是檔案工具的防護措施，並非沙箱；它不會限制 bash。
`--max-idle`	在 session 以 `end_turn` 停止原因進入閒置狀態後，等待多久才關閉。預設為 `60s`。
`--log-format`	日誌輸出格式。使用 `json` 以進行結構化日誌擷取。預設為 `text`。

支援的 MCP 伺服器類型

如需更多關於 MCP 與建置 MCP 伺服器的資訊，請參閱 MCP 文件。

速率限制

Managed Agents 端點依組織進行速率限制：

操作	限制
建立端點（例如代理、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 的視覺元素

Was this page helpful?

事件類型

自架工作程式

支援的 MCP 伺服器類型

速率限制

品牌指南

事件類型

自架工作程式

支援的 MCP 伺服器類型

速率限制

品牌指南

事件類型

自架工作程式

支援的 MCP 伺服器類型

速率限制

品牌指南

事件類型

自架工作程式

支援的 MCP 伺服器類型

速率限制

品牌指南