啟動 Claude Managed Agents

TL;DR – Claude Managed Agents 是一個預先建構、可配置的 Agent 框架，運行於託管基礎設施中。您可以將 Agent 定義為一個模板，包含工具、技能、檔案/程式庫等。系統會為您提供 Agent 框架與基礎設施。此系統旨在跟上 Claude 快速成長的智慧能力，並支援長週期的任務。以下是一些實用的連結：

• Claude 部落格：使用模式與客戶案例

• 工程部落格：Claude Managed Agents 的設計

• 文件：入門指南、快速開始、CLI 與 SDK 概覽

為什麼選擇 Claude Managed Agents

Claude Messages API 是通往模型的直接閘道：它接收訊息並回傳內容區塊。基於 Messages API 建構的 Agent 使用一個框架來將 Claude 的工具呼叫路由至處理器，並管理 context。這帶來了幾個挑戰：

• 框架需要跟上 Claude 的進度 – 我最近寫了一篇部落格，專注於使用 Claude API 原語（primitives）來建構 Agent，以處理工具編排與 context 管理。但 Agent 框架中編碼了關於「Claude 無法做什麼」的假設。隨著 Claude 能力增強，這些假設會變得過時，並可能成為 Claude 效能的瓶頸。框架需要持續更新以跟上 Claude 的發展。

• Claude 的運行時間更長 – Claude 的任務週期正呈指數級成長，在 METR 基準測試中已超過 10 個小時的人類工作量。這對 Agent 周圍的基礎設施帶來了壓力：它必須是安全的、對長週期任務中發生的基礎設施故障具有韌性，並支援擴展（例如，擴展至多個 Agent 團隊）。

解決這些挑戰至關重要，因為我們預期未來的 Claude 將能針對人類最重大的挑戰，進行數天、數週甚至數月的運作。Claude Agent SDK 是邁出的第一步，提供了一個出色的通用 Agent 框架。Claude Managed Agents 是此發展過程中的下一步：一個具備框架與託管基礎設施的系統，旨在支援我們預期 Claude 工作週期內的安全、可靠執行。

如何開始

一個簡單的入門方式是使用我們開源的 claude-api 技能，它在 Claude Code 中可直接使用。取得最新版本的 Claude Code，並執行以下子指令來進行 Claude Managed Agents 的入門流程。我對於將「技能」作為啟用新功能的方式感到興奮，並且已經廣泛使用此技能：

$ claude update
$ claude
/claude-api managed-agents-onboarding

此外，請參閱我們的文件以了解 SDK 或 CLI 的快速開始指南，並在 Claude Console 中進行 Agent 原型設計。

使用案例

您可以在我們的 Claude 部落格中查看許多有趣的範例。我在這些範例以及我自己的工作中觀察到一些常見的模式：

• 事件觸發（Event-triggered）：服務觸發 Managed Agent 來執行任務。例如，系統標記了一個錯誤（bug），Managed Agent 隨即編寫修補程式並開啟 PR。在標記與執行動作之間無需人類介入。

• 排程（Scheduled）：Managed Agent 被排程執行任務。例如，我和許多其他人使用此模式進行每日排程簡報（例如，關於 X 或 Github 的活動，以及 Agent 團隊正在處理的事項）。這是我使用的一個 X 活動每日簡報範例。

• 執行後即忘（Fire-and-forget）：人類觸發 Managed Agent 來執行任務。例如，透過 Slack 或 Teams 將任務指派給 Managed Agent，並取回交付成果（試算表、投影片、應用程式）。

• 長週期任務（Long-horizon tasks）：長運行任務是我認為 Managed Agents 特別有用的領域。我透過 fork @karpathy 的 auto-research 程式庫並探索一些不同的想法來進行研究。例如，我最近採用了 @_chenglou 出色的 pretext 函式庫，並讓一個 Managed Agent 探索將其應用於我們工程部落格內容的方法。

關鍵概念

在入門時，有三個核心概念需要理解：

• Agent — 一個版本化的配置，存放 Agent 的識別資訊：模型、系統 Prompt、工具、技能、MCP 伺服器等。您建立一次後，即可透過 ID 進行參照。

• Environment — 一個描述如何配置 Agent 工具運行所在「沙盒」的模板（例如，執行時期類型、網路原則與套件配置）。

• Session — 一個使用預先建立的 Agent 配置與環境的有狀態運行。它會從環境模板中配置一個全新的沙盒，掛載任何單次運行所需的資源（檔案、GitHub 程式庫），並將驗證資訊儲存在安全的保險庫（MCP 憑證）中。

將 Agent 視為配置，將 Environment 視為描述 Agent 執行程式碼所需沙盒的模板，並將 Session 視為任何 Agent 的執行過程。一個 Agent 可以擁有多個 Session。

使用方式

請參閱此處的文件：

• SDK – 這些是面向程式碼的：在您的應用程式中匯入它們，以在執行時期驅動 Session。目前有六種語言支援 Managed Agents：Python、TypeScript、Java、Go、Ruby、PHP。

• CLI – 面向終端機的：每個 API 資源（Agent、Environment、Session、保險庫、技能、檔案）都以子指令的形式公開。

• 常見模式 – 使用 CLI 進行設定，使用 SDK 進行執行時期操作。Agent 模板是持久的：您建立一個模板，將其儲存（例如，作為包含模型、系統 Prompt、工具、MCP 伺服器、技能的 YAML 檔案並存於 git 中），並讓 CLI 在您的部署管道中套用它。

運作原理

我與 @mc_anthropic、@gcemaj 和 @jkeatn 在 Anthropic 工程部落格上共同撰寫了一篇文章，介紹建構 Claude Managed Agents 的過程：我們在文中分享的一個經驗是，建構能隨 Claude 智慧能力擴展的 Agent，是一項基礎設施挑戰，而不僅僅是框架設計的問題。

考慮到這一點，我們並沒有設計一個特定的 Agent 框架；我們預期 Agent 框架會不斷演進。相反地，我們將我們認為的「大腦」（Claude 及其框架）與「雙手」（執行動作的沙盒與工具）以及「Session」（Session 事件日誌）解耦。

每一部分都成為一個介面，對其他部分幾乎沒有假設，並且每一部分都可以獨立故障或被替換。我們分享了這如何賦予系統可靠性、安全性以及靈活性，以加入未來的框架、沙盒或用於託管 Session 的基礎設施。

結論

我對於那些探索多 Agent 編排或長運行任務不同模式的專案感到興奮。我過去曾寫過關於「讓 Agent 框架跟上模型能力」的挫折感。Claude Managed Agents 為您處理了 Agent 框架與基礎設施，讓您能夠在 Agent 作為 Claude API 中一個新的核心原語之上進行探索。