託管代理參考

參考資料

Claude Managed Agents 的事件類型、自託管工作程序 CLI 旗標、支援的 MCP 伺服器類型、速率限制及品牌使用指南。

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

所有 Managed Agents API 請求都需要 managed-agents-2026-04-01 beta 標頭。SDK 會自動設定此 beta 標頭。

事件類型

事件類型字串遵循 {domain}.{action} 的命名慣例。如需傳送、串流及列出事件的相關資訊，請參閱 Session 事件串流。

以下是用於驅動 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` 以外的路徑。
`--max-idle`	在 session 以 `end_turn` 停止原因進入閒置狀態後，關閉前要等待的時間。預設為 `60s`。
`--log-format`	日誌輸出格式。使用 `json` 以進行結構化日誌擷取。預設為 `text`。

Claude Managed Agents 可連接至公開 HTTP 端點的遠端 MCP 伺服器，或透過 MCP 通道連接至私有 MCP 伺服器。伺服器必須支援 MCP 協定的可串流 HTTP 傳輸。如需在代理程式上宣告伺服器的相關資訊，請參閱 MCP 連接器。

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

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

操作	限制
建立端點（例如 agents、sessions 和 environments）	每分鐘 300 個請求
讀取端點（例如 retrieve、list 和 stream）	每分鐘 600 個請求

對於整合 Claude Managed Agents 的合作夥伴，使用 Claude 品牌為選擇性。在您的產品中提及 Claude 時：

允許使用：

不允許使用：

您的產品應維持自己的品牌識別，不應看起來像是 Claude Code、Claude Cowork 或任何其他 Anthropic 產品。如有品牌合規相關問題，請聯絡 Anthropic 銷售團隊。

Was this page helpful?

自託管工作程序

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

支援的 MCP 伺服器類型

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

操作

限制

建立端點（例如 agents、sessions 和 environments）

每分鐘 300 個請求

讀取端點（例如 retrieve、list 和 stream）

每分鐘 600 個請求

品牌使用指南

對於整合 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?