Skip to content
Back/Claude Code

Claude Managed Agents Cookbook

View in Graph
Updated 2026-08-13
2 min read
367 words

Claude Managed Agents Cookbook

Anthropic 官方 Cookbook 实践:构建基于 Claude Managed Agents 的数据分析师和 Slack Bot。

核心概念

Claude Managed Agents 基于四个核心概念:

  • Agent:模型、系统提示词、工具、MCP servers 和 skills
  • Environment:配置的容器模板(包、网络访问)
  • Session:在环境中运行的 agent 实例,执行特定任务
  • Events:应用与 agent 之间交换的消息

Agent + Environment = Session。Anthropic 处理沙盒、工具执行和上下文管理。


Cookbook 1:Data Analyst Agent

将 CSV 转换为带交互式图表的叙事 HTML 报告。

关键实现步骤

  1. 创建 Environment:声明 pandas 和 plotly 为预装包
  2. 创建 Agent:使用 agent_toolset_20260401(八工具:bash/read/write/edit/glob/grep/web_fetch/web_search)
  3. 上传数据集 → Files API
  4. 创建 Session 并发送分析任务
  5. 流式监控运行过程
  6. 获取报告:/mnt/session/outputs/ 下的文件通过 Files API 获取

系统提示词要点

  • 专业精确风格,使用具体数字
  • 图表之间短段落(2-3 句)
  • 以最具行动力的发现开头
  • 输出到 /mnt/session/outputs/report.html

Cookbook 2:Slack Data Analyst Bot

用 Bolt for Python 包装数据分析师 agent,@bot + CSV 附件即可获得线程内分析报告。

架构

user: @databot what's driving Q1 revenue? [sales.csv]
    |
    bot uploads CSV and starts agent session
    |
    bot streams progress back to thread
    |
    bot posts finished report to thread

关键设计

  • Thread-to-Session 映射:thread_sessions: dict[str, str] 维持多轮对话上下文
  • 后台线程:Slack 3 秒 ack 窗口要求慢操作必须在后台线程执行
  • Socket Mode:WebSocket 交付,无需公网 URL
  • Follow-ups:线程内回复继续同一会话

生产考虑

  • 将 thread_sessions 持久化到数据库,确保 bot 重启后对话不丢失
  • 线程过期时归档会话释放容器
  • 在数据分析师 notebook 中修改 agent 系统提示词即可改变分析风格

最佳实践

  • Agent 和 Environment 创建一次,跨运行复用
  • 每个对话创建新 Session
  • 完成后归档 Session 释放容器
  • 将 agent/environment ID 保存到 .env 供其他应用复用

2026-05-14 更新:三项新功能

来源:AI 简报 2026-05-14 Afternoon

Claude Managed Agents 新增三项能力:

Dreaming(自动记忆提取)

自动从对话历史中提取记忆,无需用户手动标记。这是 Memory Backend 范式的官方实现——agent 自主判断什么值得记住,而非依赖用户显式输入。

Outcomes(用户定义成功标准)

用户可为任务定义成功标准,系统内置评分器自动评判 Agent 工作质量。将验证从"人工检查"推向"结构化自动评估",与 自我验证循环 形成呼应。

Multi-agent orchestration(子 Agent 委派)

主 Agent 自动拆解任务并委派给专业子 Agent。这是 多 Agent 协调模式 的官方实现:不再依赖单一全能 Agent,而是利用专业化分工。

Brain 与 Hands 解耦架构 (2026-08-13)

来源:AI Builders Digest 2026-08-13

Anthropic 工程博客《Scaling Managed Agents: Decoupling the brain from the hands》把托管 agent 拆成"大脑"(Claude 及其 harness)、"手"(sandbox 与工具)与独立持久化的 session log:

  • 早期单容器设计是"宠物"服务器:容器挂掉 session 即丢失,排查需进入装有用户数据的容器
  • 新设计把 harness 移出容器,sandbox 视为通过 execute(name, input) 通用接口调用的"牲畜",失败降级为可恢复的工具错误
  • session log 独立于 harness,新 harness 可通过 wake/getSession 读取事件并从最后一个持久化事件恢复
  • 安全改进:凭证不进 sandbox(Git 凭证绑定到 remote,MCP OAuth token 存 vault 经代理访问)
  • 性能:容器按需创建,p50 首 token 延迟下降约 60%,p95 下降超过 90%
  • 设计刻意模仿操作系统抽象(process、file),追求比硬件更持久的接口

同日新增自托管 sandbox(Cloudflare、Daytona、Modal、Vercel)与私有 MCP tunnel(轻量 outbound 网关、端到端加密),让企业把工具执行和数据留在自有安全边界内;MCP tunnel 处于 research preview。


实际应用案例

Skillet:浏览器端的 Claude Code 体验

Skillet 利用 Claude Managed Agents 将 Claude Code 的能力带入浏览器,让非技术人员无需终端即可使用 AI agent。

  • 基于 Claude Agent SDK 构建,skills 安装方式与 Claude Code 一致
  • gstack 的 /office-hours skill 可以在浏览器中直接运行
  • 消除了终端门槛,扩大了 AI agent 的受众范围
  • 代表了 agent 工具从开发者工具向大众工具的演进趋势

Sources

Synthesized from 5 sources

Evolution

1 event
  1. absorbed

    Derived from source material

    This page is currently synthesized from 5 sources.

    From Build a data analyst agent with Claude Managed Agents, Build a Slack data analyst bot with Claude Managed Agents, AI Builders Digest 2026-08-13 — Brain 与 Hands 解耦架构, Anthropic Cookbook: Data Analyst Agent, Anthropic Cookbook: Slack Data BotTo Claude Managed Agents Cookbook
    Sources: raw/to-learn/Build a data analyst agent with Claude Managed Agents.md · raw/to-learn/Build a Slack data analyst bot with Claude Managed Agents.md · raw/briefing/AI Builders Digest/2026-08-13.md · https://platform.claude.com/cookbook/managed-agents-data-analyst-agent · https://platform.claude.com/cookbook/managed-agents-slack-data-bot