SuperAPI AI 工具集

managed-agent

智能体与模型

查看项目

更新于 10-15 16:46

技能介绍

用途:本技能驱动 Anthropic 的 Claude Managed Agents(云端)运行时,是 ruvnet/ruflo 中本地 WASM 运行时(wasm_agent_*)的云端对应。云端合适长时间/异步任务(分钟到小时级),提供预装包与网络的真实容器,以及跨轮次持久化文件系统与对话记录;本地 WASM 则更快、免费、临时、离线、沙箱运行不可信代码。

模型结构:Agent(模型+系统+工具+MCP 服务器+技能)→ Environment(容器模板)→ Session(运行实例)→ Events(轮次/工具调用/状态,服务端持久化)。

前置条件:环境中需有 ANTHROPIC_API_KEY(或 CLAUDE_API_KEY),并具备 Claude Managed Agents 测试访问权限。若缺失,所有 managed_agent_* 工具会返回结构化错误,提示改用 wasm_agent_create 的本地无密钥运行时。

主要工具与用法:

  • 创建:managed_agent_create,入参可含 model、system、name、networking、packages、initScript、mcpServers、skills,返回 sessionId、agentId、environmentId、status,需保存三个 id。packages 支持 pip/npm/apt/cargo/gem/go。mcpServers 为 URL 类型,云端智能体必须能访问该 URL;本地 ruflo mcp start 云端不可达,需先部署或隧道暴露 HTTP MCP 服务器。
  • 提示:managed_agent_prompt 传入 sessionId、message、maxWaitMs,发送用户轮次并轮询事件日志直到空闲(默认 180 秒,上限 600 秒)。长任务可提高 maxWaitMs 或后续用 events 跟进。
  • 查看:managed_agent_status(idle/running/error)、managed_agent_events(完整记录:用户轮次、思考、tool_use、tool_result、状态)。
  • 列举:managed_agent_list(可按 limit)。
  • 终止:managed_agent_terminate,传 sessionId,可选 environmentId 一并删除环境。

限制与注意:Managed Agents 按会话计费(LM token + 容器时间),并受组织级速率限制;长任务前应估算成本,完成后记录到成本跟踪命名空间。孤儿会话等同于泄漏资源,应通过 list 找出并 terminate。API 为 Beta(managed-agents-2026-04-01),agent 配置上的 multiagent / define-outcomes 属于研究预览。