Jonathon's AI Wiki

Anthropic Cookbook: Managed Agents Multiagent + Outcomes (May 2026)

7 min read

Source: Five anthropics/claude-cookbooks commits (May 5–6 2026) plus two anthropics/skills commits (May 3 + May 6 2026), tracked via the Anthropic ecosystem watch feed

The Anthropic cookbook landed two new managed-agents tutorials this week and a vulnerability-detection agent built on the Claude Agent SDK. The official skills repo received the matching claude-api skill update (Managed Agents outcomes, multiagent, webhooks). Together these are the documentation + reference-implementation layer of the same Managed Agents API surface that ships in TS v0.95.

Two new managed_agents cookbooks

CMA_coordinate_specialist_team.ipynb (commit 0c0645a7, May 6 2026) — heterogeneous-team coordinator pattern. The multiagent coordinator config runs three specialists with scoped toolsets to assemble a sales proposal. Production reference for the “coordinator runs N specialists” agent shape that sits one level above subagents. Subsequent retitle (commit 250701ef) renamed it to “Multiagent: coordinate a specialist team” matching the Feature: pattern of sibling tutorials.

CMA_verify_with_outcome_grader.ipynb (commit 0c0645a7, May 6 2026) — grade-and-revise loop with Outcomes. Writer drafts a cited brief, grader checks against a rubric, feedback drives revisions until it passes. Includes a rubric-writing section with failure modes and a six-principle table. Concrete encoding of the evaluator-optimizer pattern from Anthropic’s official agent workflow taxonomy. Title was lowercased post-merge to “Outcomes: agents that verify their own work” to keep both Feature: titles on convention.

Render-fix commits

Commits 250701ef, 93a262f1 (merge PR #600), and d28edf17 (merge PR #599) are docs-render fixes — replacing display(Markdown(...)) with print() in review-loop and brief/proposal extraction cells (the docs site does not render IPython rich-display output, so cells were appearing empty), plus retitling cells. Cleanup, no behavior change. Recorded for completeness.

Registry retag — May 8 (post-conference)

Three follow-up commits land the day after Code with Claude 2026 adding a dedicated “Claude Managed Agents” registry category and retagging the managed_agents notebooks to use it (commits c8b30f3b, 4f1bc38d, 3f8bf356, all by markn-ant). Schema update lands first (registry_schema.json enum gets Claude Managed Agents); registry then retags CMA_* notebooks; PR #606 merges the lot. Pure metadata — no behavior change to any notebook — but signals Anthropic is treating Managed Agents as a first-class registry category alongside Cybersecurity (added the same week with the vulnerability-detection agent below).

Vulnerability-detection agent (separate but adjacent)

06_The_vulnerability_detection_agent.ipynb (commit 876d099d, May 5 2026, by PedramNavid) — under claude_agent_sdk/, not managed_agents/. Runs a four-stage flow on a self-contained 45-line canary C target: threat-model → find → triage → report. Three unlabeled memory-safety bugs in the canary (heap OOB, stack OOB, UAF). Implementation:

  • ClaudeSDKClient for the multi-turn bootstrap-then-interview threat model.
  • Stateless query() for find / triage / report stages.
  • Built-in Read/Grep/Glob tools from Claude Code instead of a hand-rolled tool loop.

Supporting changes:

  • New entry in registry.yaml under “Claude Agent SDK + Cybersecurity”; threat_intel_enrichment_agent retroactively tagged Cybersecurity.
  • New author eugeneyan-ant added to authors.yaml.
  • claude-agent-sdk added to root pyproject.toml.
  • THREAT_MODEL.md added to .gitignore (generated file).
  • Cybersecurity added to registry_schema.json enum so the new entry passes registry-check.

This is also the second cybersecurity cookbook entry — pairs with the existing threat_intel_enrichment_agent to form a small but growing Cybersecurity track in the cookbook taxonomy.

Skills repo updates

claude-api skill: Managed Agents outcomes, multiagent, webhooks (skills commit d211d437, May 6 2026, PR #1096, by rlancemartin) — the matching update to the skills claude-api skill so users invoking that skill get coverage of the new APIs.

Files API examples cleanup (skills commit d230a6dd, May 3 2026, PR #1081, by rlancemartin) — removes the non-existent purpose field from Files API examples (TS + curl) in the managed-agents skill. The Files API upload endpoint does not accept this parameter; the examples were misleading users.

Adjacent shipment — anthropics/financial-services reference repo (May 2026)

[Reddit signal — r/ClaudeCode 2026-05-10] github.com/anthropics/financial-services (raw/reddit-1t9p3ho.md, 315 score / 50 comments) is Anthropic’s first vertical-specific reference repo built on the same Managed Agents API surface this cookbook documents. Ships 10 prebuilt workflow agents covering investment banking / equity research / private equity / asset management — Pitch Agent, Meeting Prep Agent, Market Researcher, Earnings Reviewer, Model Builder (Excel-native DCF/LBO/three-statement/comps), Valuation Reviewer, GL Reconciler, Month-End Closer, Statement Auditor, KYC Screener. Runnable via Cowork plugin or Managed Agents API — same agent definitions, two execution surfaces. Pairs with the cookbook coverage: cookbook = generic patterns (coordinator/specialist + outcome-grader), financial-services repo = vertical-domain instantiation. Watch for adjacent vertical-specific reference repos (legal, healthcare, retail) following the same dual-runtime template. Detailed agent breakdown lives in Managed Agents.

Key Takeaways

  • Two production-grade managed_agents cookbooks land together. Coordinator-with-specialists for compositional workflows; outcome-grader for self-verifying agents. Both are first-class examples of patterns that have been talked about for months but were lacking canonical Anthropic-blessed reference code.
  • The outcome-grader cookbook encodes the evaluator-optimizer pattern. Six-principle rubric-writing table is the load-bearing artifact — writing a good rubric is what makes the loop converge instead of thrashing.
  • Vulnerability-detection cookbook validates the Claude Agent SDK + Cybersecurity tag. Canary target with three unlabeled memory-safety bugs is a clean evaluation harness; pattern of “use Claude Code’s Read/Grep/Glob in place of a hand-rolled tool loop” is the load-bearing implementation choice.
  • Cybersecurity is becoming a real cookbook track. Two entries (threat-intel + vulnerability-detection); registry schema updated to recognize the category. Watch for more.
  • Files API purpose field bug propagation. The existence of this fix means downstream users had been writing code that wouldn’t work. Audit any internal Managed Agents code that referenced purpose in Files API uploads.
  • Skills + cookbook + SDK ship in lockstep. May 6 saw the cookbook commits, the skills update, and the SDK release (Python v0.100 / TS v0.95) all land for the same Managed Agents surface. The first time we’ve seen this level of three-layer coordinated release for a Claude API feature.
  • Vertical reference repos follow the cookbook. anthropics/financial-services (May 2026, 10 prebuilt agents) is the first domain-specific reference repo on the same Managed Agents surface. Cookbook = generic patterns; vertical repos = instantiations. Pattern likely repeats across legal, healthcare, retail.

Try It

  1. Run the multiagent coordinator cookbook (CMA_coordinate_specialist_team). Bring your own use case — a sales-proposal flow is the demo, but the pattern transfers cleanly to any compositional task with 2-4 specialist roles.
  2. Adopt the outcome-grader pattern for a content-quality task. The six-principle rubric table is the take-home asset. Pick a content surface where you’ve been hand-grading drafts (ad copy, blog posts, email sequences); encode the rubric, run the grade-and-revise loop, measure improvement against your hand-grade baseline.
  3. Try the vulnerability-detection agent on real code. The canary is for tutorial; the actual value is running 06_The_vulnerability_detection_agent.ipynb against a real internal codebase. The Claude Agent SDK + Read/Grep/Glob pattern is reusable.
  4. Update the claude-api skill if you have it installed. The skills repo update brings outcomes + multiagent + webhooks coverage into Skills.
  5. Search internal code for purpose: in Files API uploads and remove it. Examples in the managed-agents skill were leading users astray.

Open Questions

  • Vault validation cookbook. SDK changelog mentions vault validation; cookbook commits don’t cover it. Pending cookbook entry expected.
  • Webhooks reference implementation. The skills repo got webhooks coverage; cookbook does not yet have a dedicated webhooks tutorial. Open thread.
  • Coordinator multiagent vs. agent-teams. Where does the new multiagent API surface fit in the agents hierarchy — is it intended to replace the older agent-teams pattern, complement it, or sit at a different layer? Source commits don’t disambiguate.

Graph View

Backlinks