Anthropic 的托管智能体平台 Claude Managed Agents（CMA） 一次性推了六项增量更新。先说边界：CMA 是 Anthropic 托管的 Agent 运行平台，区别于 Claude Code Skills、Record a Skill、Cowork——别把这几个产品混在一起。

这六项更新里，对开发者最有实操价值的是三项：会话技能上限从 20 拉到 500、effort 思考力度可写入每个 Agent 的模型配置、POST /v1/sessions 一步带 initial_events 创建会话。下面直接上可运行的 API 载荷。

✅ 事实来源: 本文基于 Anthropic 官方开发者账号 @ClaudeDevs（推文）、官方布道师 CJ Avilla 与 Eric Buess 的官方 "we just added" 帖、以及 effort 参数官方文档。原文里的其他叙事细节未逐一核实，本文只陈述能对应到官方来源的事实。

六项更新一览

下面挑三项最值得改造代码的，给出真实载荷。

更新一：会话技能上限从 20 拉到 500

CMA 的 Skills 是给 agent 注入专业指令的知识包，跑在统一的托管沙盒里，之前一个会话最多 20 个。现在拉到 500 个，且由会话内所有 agent 共享。

这意味着什么？以前你做一个企业客服系统，光接入各个业务线 SOP 就超 20 个，得拆多个会话或动态装载。现在一个会话直接挂整座企业知识库。

挂载方式没有 API 改动——原本就是会话配置里指定 skill 列表，只是上限提高了。关键变化在于架构层面：你可以把所有公司文档、合规规则、产品手册一次性预挂载，省掉运行时动态装载的开销和复杂度。

更新二：effort 五档写入 per-agent 配置

effort 参数在 API 层面早就有，但 CMA 里的 agent 此前不能单独设——整个 session 统一跑默认档位。现在可以写进每个 agent 的模型配置里，五档可调：low / medium / high / xhigh / max。

典型用法是多 agent 协作时分级调度：

• 分流 coordinator：low（简单分类，省 token）
• 产品答疑：medium（够用）
• 投诉升级：high（需要更深推理）
• 法律合规：max（不能出错，拉满）

per-agent 配置示例（节选关键字段）：

{
  "agents": {
    "triage": {
      "model": "claude-...",
      "model_config": {
        "effort": "low"
      }
    },
    "complaints": {
      "model": "claude-...",
      "model_config": {
        "effort": "high"
      }
    },
    "legal": {
      "model": "claude-...",
      "model_config": {
        "effort": "max"
      }
    }
  }
}

完整的字段结构以 effort 官方文档 为准。

更新三：种子会话一步创建（带 initial_events）

冷启动是 CMA 此前最被吐槽的点之一：创建一个会话以前要两步——先 POST /v1/sessions 建空壳，再逐条塞初始事件。现在一步到位。

下面是一个可运行的种子会话创建载荷，直接在 POST /v1/sessions 里带 initial_events（最多 50 条）：

curl -X POST https://api.claude.com/v1/sessions \
  -H "Authorization: Bearer $CLAUDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_01ABC...",
    "initial_events": [
      {
        "type": "user_message",
        "content": "当前用户身份：企业版，剩余额度充足。"
      },
      {
        "type": "system_context",
        "content": "把所有回复限定在 SaaS 计费领域内。"
      }
    ]
  }'

💡 提示: initial_events 最多 50 条。塞的是"会话开局就该有的上下文"——身份、权限边界、领域约束——而不是历史聊天记录。混进大量历史会拖慢冷启动。

更新四：子 agent 流式下探到线程级

6 月底 CMA 刚上线会话级的 event_deltas（你能看到整个会话层面 agent 在干什么）。这次下探到线程级——每个子 agent 跑到哪一步、中间在想什么，都实时可见。

对一个会话里挂着五六个子 agent 的复杂工作流，这等于把可观测性的分辨率从"会话"提到了"线程"。调试多 agent 编排时，你能精确定位是哪个子 agent 卡住或答错了。

更新五：7 个新 webhook

CMA 在 6 月底已经上线 agent 和部署生命周期的 webhook。这次补上了剩下两大块：

• 4 种环境事件（environment lifecycle）
• 3 种记忆存储事件（memory storage）

加起来一共 7 个新事件类型。实战意义是：轮询可以退环境了。以前要靠循环轮询知道 agent 何时进新环境、记忆何时写入完成，现在全部事件驱动，配 webhook 接收端即可。具体事件名以官方 webhook 文档为准。

更新六：agent 更新接口 version 字段可选

agent 更新接口的 version 字段从必填变成可选。

对一个持续迭代的 agent（CI/CD 流水线里频繁更新指令），这意味着每次更新不用再维护 version 号——单流程省掉一整块版本管理开销。

适用谁

这批更新主要服务于已经在用 CMA 搭生产级 agent 的团队。如果你的场景是：

• 企业级多 agent 系统（客服、风控、合规）→ 技能上限 500 + per-agent effort 最直接受益
• 冷启动敏感的实时应用（金融、客服开场）→ 种子会话一步创建立省一半往返
• 需要深度调试多 agent 编排 → 线程级流式事件是刚需
• 事件驱动架构 → 7 个新 webhook 能干掉大部分轮询代码

如果你还没接触过 CMA，建议先去 Anthropic 官方文档 跑通最小 demo，再回头看这六项更新会更清楚它们解决什么问题。