Agent Mentor Learn

Fuentes

Todas las afirmaciones clave de este curso se apoyan en las fuentes listadas abajo, citadas en el texto principal como [^Sn], con los pasajes concretos extraídos bajo cada entrada. Las 94 citas se extrajeron de forma programática por anclas y se volvieron a verificar el 2026-08-26 (todas correctas), conservando las comillas tipográficas, las rayas, los signos de multiplicación (4×) y las comillas mezcladas del original ("gate" aparece exactamente como en la fuente), sin reformular nada. Las citas se mantienen en su inglés original.

Disciplina de redacción (aplica a todas las lecciones; cada punto sale del informe de huecos de cobertura establecido para este curso):

  • "Graph", "node", "edge", "DAG" y "state machine" aparecen cero veces en las seis fuentes primarias (confirmado con grep). «De los bucles a los grafos» es una metáfora de ingeniería propia de este curso, que sirve para ordenar vocabulario que sí existe en el material primario (agentic systems, workflows, patterns, orchestrator-workers, lead agent, subagents, coordinator, fan out). La lección 5, que es la que introduce este sistema visual, tiene que decir de forma explícita que es una creación de este curso; el ancla primaria más cercana es la afirmación de que "the workflow script itself holds the loop, branching, and intermediate results"[^S5]. Ninguna lección puede presentar la terminología de grafos como un concepto oficial.
  • La expresión «espectro de determinismo» también es una creación de este curso: las fuentes primarias solo dan las definiciones de los dos extremos (caminos de código predefinidos frente a decisiones dirigidas por el modelo) y el eje de «quién tiene el plan»[^S5]; nunca lo llaman espectro.
  • El enrutamiento solo tiene respaldo al nivel del «nombre del patrón» (clasificar y luego despachar[^S1], despacho por dominio / escalado por dificultad[^S6]); no hay respaldo primario para «elegir una arista de un grafo» ni para un «nodo enrutador».
  • «Los objetos de estado que se pasan entre nodos» no tiene respaldo primario; la afirmación más cercana es "intermediate results stay in script variables"[^S5]. El estado tipado, las estrategias de fusión y demás son prácticas de ingeniería sin cita.
  • Ninguna fuente primaria compara los flujos de trabajo deterministas con los agentes de un solo bucle. La cifra del 90.2% es multiagente frente a agente único, sobre la evaluación interna de investigación de Anthropic, con un agente principal Opus 4 y subagentes Sonnet 4: no se puede usar para argumentar que «los grafos le ganan a los bucles».
  • Reintentos, tiempos de espera, backoff, cortacircuitos e idempotencia por nodo: las fuentes primarias solo ofrecen una oración subordinada ("deterministic safeguards like retry logic and regular checkpoints"[^S2]). Los diseños más detallados habría que escribirlos como práctica de ingeniería, con cero citas.
  • Ninguna fuente primaria da ejemplos de código de orquestación escritos a mano. El script completo de la lección 6 es una construcción propia de este curso y hay que etiquetarlo como tal.
  • «Cuándo no basta con un bucle» no tiene una fuente primaria literal; las anclas sustitutas que sí sirven son "when a task needs more agents than one conversation can coordinate" y "when the task is larger than one agent can hold in context, or when the same step needs to run across many items"[^S5].
  • No le atribuyas a Anthropic la terminología de LangGraph ni la de ningún framework de grafos de terceros; la página de S1 lleva un cartel que declara desactualizadas sus descripciones del ecosistema de herramientas (el texto del cartel está en la primera cita de S1), así que cita solo sus patrones y principios.
  • «Productor-revisor» es la convención de nombres del curso 6 de esta serie, no vocabulario primario; las fuentes primarias dicen evaluator-optimizer[^S1] y "adversarially review"[^S5]: haz el puente de forma explícita cuando escribas con ese término.
  • Propagación y compensación de errores entre ramas paralelas: las fuentes primarias solo ofrecen una frase, y en ella lo listan como un reto sin resolver ("asynchronicity adds challenges in result coordination, state consistency, and error propagation across the subagents"[^S2]), así que no se puede escribir como si tuviera una solución oficial.
  • El costo en tokens del propio orquestador no tiene una cifra independiente; solo están los multiplicadores de 4× y 15× respecto al chat[^S2].

S1 — Building Effective AI Agents — Anthropic Engineering

URL: https://www.anthropic.com/engineering/building-effective-agents

  • authority: authoritative-guide

El texto canónico de Anthropic sobre patrones de agentes (diciembre de 2024), la fuente que le da el esqueleto a este curso: la distinción arquitectónica entre flujos de trabajo y agentes, el LLM aumentado como bloque de construcción fundamental, las definiciones y los casos de uso apropiados de los cinco grandes patrones de flujo de trabajo (encadenamiento, enrutamiento, paralelización, orquestador-trabajadores, evaluator-optimizer), las pautas de composición y personalización, y el hilo de «empieza simple y sube la complejidad solo cuando haga falta» que recorre el artículo entero. La página lleva un cartel editorial que declara desactualizadas sus descripciones del ecosistema de herramientas: cita solo los patrones y los principios, nunca como guía vigente de herramientas.

Cita clave:

"Note: Much of the tooling landscape described in this post has changed since December 2024. For our current approach, see how we built Claude Managed Agents and the Managed Agents documentation." "Over the past year, we've worked with dozens of teams building large language model (LLM) agents across industries. Consistently, the most successful implementations weren't using complex frameworks or specialized libraries. Instead, they were building with simple, composable patterns." "At Anthropic, we categorize all these variations as agentic systems, but draw an important architectural distinction between workflows and agents:" "Workflows are systems where LLMs and tools are orchestrated through predefined code paths." "Agents, on the other hand, are systems where LLMs dynamically direct their own processes and tool usage, maintaining control over how they accomplish tasks." "When building applications with LLMs, we recommend finding the simplest solution possible, and only increasing complexity when needed. This might mean not building agentic systems at all. Agentic systems often trade latency and cost for better task performance, and you should consider when this tradeoff makes sense." "When more complexity is warranted, workflows offer predictability and consistency for well-defined tasks, whereas agents are the better option when flexibility and model-driven decision-making are needed at scale. For many applications, however, optimizing single LLM calls with retrieval and in-context examples is usually enough." "These frameworks make it easy to get started by simplifying standard low-level tasks like calling LLMs, defining and parsing tools, and chaining calls together. However, they often create extra layers of abstraction that can obscure the underlying prompts and responses, making them harder to debug. They can also make it tempting to add complexity when a simpler setup would suffice." "We suggest that developers start by using LLM APIs directly: many patterns can be implemented in a few lines of code. If you do use a framework, ensure you understand the underlying code. Incorrect assumptions about what's under the hood are a common source of customer error." "In this section, we'll explore the common patterns for agentic systems we've seen in production. We'll start with our foundational building block—the augmented LLM—and progressively increase complexity, from simple compositional workflows to autonomous agents." "The basic building block of agentic systems is an LLM enhanced with augmentations such as retrieval, tools, and memory. Our current models can actively use these capabilities—generating their own search queries, selecting appropriate tools, and determining what information to retain." "Prompt chaining decomposes a task into a sequence of steps, where each LLM call processes the output of the previous one. You can add programmatic checks (see "gate" in the diagram below) on any intermediate steps to ensure that the process is still on track." "When to use this workflow: This workflow is ideal for situations where the task can be easily and cleanly decomposed into fixed subtasks. The main goal is to trade off latency for higher accuracy, by making each LLM call an easier task." "Routing classifies an input and directs it to a specialized followup task. This workflow allows for separation of concerns, and building more specialized prompts. Without this workflow, optimizing for one kind of input can hurt performance on other inputs." "When to use this workflow: Routing works well for complex tasks where there are distinct categories that are better handled separately, and where classification can be handled accurately, either by an LLM or a more traditional classification model/algorithm." "LLMs can sometimes work simultaneously on a task and have their outputs aggregated programmatically. This workflow, parallelization, manifests in two key variations:" "Sectioning: Breaking a task into independent subtasks run in parallel." "Voting: Running the same task multiple times to get diverse outputs." "When to use this workflow: Parallelization is effective when the divided subtasks can be parallelized for speed, or when multiple perspectives or attempts are needed for higher confidence results. For complex tasks with multiple considerations, LLMs generally perform better when each consideration is handled by a separate LLM call, allowing focused attention on each specific aspect." "In the orchestrator-workers workflow, a central LLM dynamically breaks down tasks, delegates them to worker LLMs, and synthesizes their results." "When to use this workflow: This workflow is well-suited for complex tasks where you can't predict the subtasks needed (in coding, for example, the number of files that need to be changed and the nature of the change in each file likely depend on the task). Whereas it's topographically similar, the key difference from parallelization is its flexibility—subtasks aren't pre-defined, but determined by the orchestrator based on the specific input." "In the evaluator-optimizer workflow, one LLM call generates a response while another provides evaluation and feedback in a loop." "When to use this workflow: This workflow is particularly effective when we have clear evaluation criteria, and when iterative refinement provides measurable value. The two signs of good fit are, first, that LLM responses can be demonstrably improved when a human articulates their feedback; and second, that the LLM can provide such feedback. This is analogous to the iterative writing process a human writer might go through when producing a polished document." "Agents can handle sophisticated tasks, but their implementation is often straightforward. They are typically just LLMs using tools based on environmental feedback in a loop." "The task often terminates upon completion, but it's also common to include stopping conditions (such as a maximum number of iterations) to maintain control." "When to use agents: Agents can be used for open-ended problems where it's difficult or impossible to predict the required number of steps, and where you can't hardcode a fixed path. The LLM will potentially operate for many turns, and you must have some level of trust in its decision-making. Agents' autonomy makes them ideal for scaling tasks in trusted environments." "The autonomous nature of agents means higher costs, and the potential for compounding errors. We recommend extensive testing in sandboxed environments, along with the appropriate guardrails." "These building blocks aren't prescriptive. They're common patterns that developers can shape and combine to fit different use cases. The key to success, as with any LLM features, is measuring performance and iterating on implementations. To repeat: you should consider adding complexity only when it demonstrably improves outcomes." "Success in the LLM space isn't about building the most sophisticated system. It's about building the right system for your needs. Start with simple prompts, optimize them with comprehensive evaluation, and add multi-step agentic systems only when simpler solutions fall short." "Frameworks can help you get started quickly, but don't hesitate to reduce abstraction layers and build with basic components as you move to production."

S2 — How we built our multi-agent research system — Anthropic Engineering

URL: https://www.anthropic.com/engineering/multi-agent-research-system

  • authority: authoritative-guide

La retrospectiva de ingeniería de Anthropic sobre su sistema multiagente de investigación (junio de 2025): lecciones de primera mano de un sistema orquestador-trabajadores real en producción. Por qué el fan-out —separación de responsabilidades, ventanas de contexto en paralelo, capacidad de tokens—, los contextos exactos de las cifras del 90.2% y de 4×/15×, cuándo multiagente no es lo apropiado, el crecimiento de la complejidad de coordinación, los cuatro elementos de los prompts de delegación, las reglas de ajustar el esfuerzo a la complejidad de la consulta, las cifras de aceleración del paralelismo de dos niveles, los cuellos de botella de la ejecución síncrona y el costo de la asincronía, y pasar referencias en lugar de cargas útiles.

Cita clave:

"A multi-agent system consists of multiple agents (LLMs autonomously using tools in a loop) working together. Our Research feature involves an agent that plans a research process based on user queries, and then uses tools to create parallel agents that search for information simultaneously. Systems with multiple agents introduce new challenges in agent coordination, evaluation, and reliability." "Research work involves open-ended problems where it's very difficult to predict the required steps in advance. You can't hardcode a fixed path for exploring complex topics, as the process is inherently dynamic and path-dependent." "The essence of search is compression: distilling insights from a vast corpus. Subagents facilitate compression by operating in parallel with their own context windows, exploring different aspects of the question simultaneously before condensing the most important tokens for the lead research agent. Each subagent also provides separation of concerns—distinct tools, prompts, and exploration trajectories—which reduces path dependency and enables thorough, independent investigations." "Our internal evaluations show that multi-agent research systems excel especially for breadth-first queries that involve pursuing multiple independent directions simultaneously. We found that a multi-agent system with Claude Opus 4 as the lead agent and Claude Sonnet 4 subagents outperformed single-agent Claude Opus 4 by 90.2% on our internal research eval." "Multi-agent systems work mainly because they help spend enough tokens to solve the problem. In our analysis, three factors explained 95% of the performance variance in the BrowseComp evaluation (which tests the ability of browsing agents to locate hard-to-find information). We found that token usage by itself explains 80% of the variance, with the number of tool calls and the model choice as the two other explanatory factors." "This finding validates our architecture that distributes work across agents with separate context windows to add more capacity for parallel reasoning." "There is a downside: in practice, these architectures burn through tokens fast. In our data, agents typically use about 4× more tokens than chat interactions, and multi-agent systems use about 15× more tokens than chats. For economic viability, multi-agent systems require tasks where the value of the task is high enough to pay for the increased performance." "Further, some domains that require all agents to share the same context or involve many dependencies between agents are not a good fit for multi-agent systems today. For instance, most coding tasks involve fewer truly parallelizable tasks than research, and LLM agents are not yet great at coordinating and delegating to other agents in real time." "We've found that multi-agent systems excel at valuable tasks that involve heavy parallelization, information that exceeds single context windows, and interfacing with numerous complex tools." "Our Research system uses a multi-agent architecture with an orchestrator-worker pattern, where a lead agent coordinates the process while delegating to specialized subagents that operate in parallel." "When a user submits a query, the lead agent analyzes it, develops a strategy, and spawns subagents to explore different aspects simultaneously." "Multi-agent systems have key differences from single-agent systems, including a rapid growth in coordination complexity. Early agents made errors like spawning 50 subagents for simple queries, scouring the web endlessly for nonexistent sources, and distracting each other with excessive updates." "Teach the orchestrator how to delegate. In our system, the lead agent decomposes queries into subtasks and describes them to subagents. Each subagent needs an objective, an output format, guidance on the tools and sources to use, and clear task boundaries. Without detailed task descriptions, agents duplicate work, leave gaps, or fail to find necessary information." "For instance, one subagent explored the 2021 automotive chip crisis while 2 others duplicated work investigating current 2025 supply chains, without an effective division of labor." "Scale effort to query complexity. Agents struggle to judge appropriate effort for different tasks, so we embedded scaling rules in the prompts. Simple fact-finding requires just 1 agent with 3-10 tool calls, direct comparisons might need 2-4 subagents with 10-15 calls each, and complex research might use more than 10 subagents with clearly divided responsibilities." "Parallel tool calling transforms speed and performance. Complex research tasks naturally involve exploring many sources. Our early agents executed sequential searches, which was painfully slow. For speed, we introduced two kinds of parallelization: (1) the lead agent spins up 3-5 subagents in parallel rather than serially; (2) the subagents use 3+ tools in parallel. These changes cut research time by up to 90% for complex queries, allowing Research to do more work in minutes instead of hours while covering more information than other systems." "Multi-agent systems have emergent behaviors, which arise without specific programming. For instance, small changes to the lead agent can unpredictably change how subagents behave. Success requires understanding interaction patterns, not just individual agent behavior." "In traditional software, a bug might break a feature, degrade performance, or cause outages. In agentic systems, minor changes cascade into large behavioral changes, which makes it remarkably difficult to write code for complex agents that must maintain state in a long-running process." "We combine the adaptability of AI agents built on Claude with deterministic safeguards like retry logic and regular checkpoints." "Instead, we use rainbow deployments to avoid disrupting running agents, by gradually shifting traffic from old to new versions while keeping both running simultaneously." "Synchronous execution creates bottlenecks. Currently, our lead agents execute subagents synchronously, waiting for each set of subagents to complete before proceeding. This simplifies coordination, but creates bottlenecks in the information flow between agents. For instance, the lead agent can't steer subagents, subagents can't coordinate, and the entire system can be blocked while waiting for a single subagent to finish searching." "Asynchronous execution would enable additional parallelism: agents working concurrently and creating new subagents when needed. But this asynchronicity adds challenges in result coordination, state consistency, and error propagation across the subagents." "When building AI agents, the last mile often becomes most of the journey. Codebases that work on developer machines require significant engineering to become reliable production systems. The compound nature of errors in agentic systems means that minor issues for traditional software can derail agents entirely." "Rather than requiring subagents to communicate everything through the lead agent, implement artifact systems where specialized agents can create outputs that persist independently. Subagents call tools to store their work in external systems, then pass lightweight references back to the coordinator."

S3 — Writing effective tools for agents — with agents — Anthropic Engineering

URL: https://www.anthropic.com/engineering/writing-tools-for-agents

  • authority: authoritative-guide

El artículo de ingeniería de herramientas (septiembre de 2025), del que este curso toma solo dos cosas: el contraste de definiciones entre sistemas deterministas y no deterministas (la base de vocabulario de todo el curso) y «una tarea por while-loop agéntico, dirigido por código», que es exactamente la unidad que el diagrama de la lección 6 se propone componer.

Cita clave:

"In computing, deterministic systems produce the same output every time given identical inputs, while non-deterministic systems—like agents—can generate varied responses even with the same starting conditions." "When we traditionally write software, we're establishing a contract between deterministic systems." "Tools are a new kind of software which reflects a contract between deterministic systems and non-deterministic agents." "We recommend running your evaluation programmatically with direct LLM API calls. Use simple agentic loops (while-loops wrapping alternating LLM API and tool calls): one loop for each evaluation task. Each evaluation agent should be given a single task prompt and your tools." "To build effective tools for agents, we need to re-orient our software development practices from predictable, deterministic patterns to non-deterministic ones."

S4 — Create custom subagents — Claude Code official documentation

URL: https://code.claude.com/docs/en/sub-agents

  • authority: official-docs

La documentación de subagentes de Claude Code: primitivas de composición a nivel de producto. Ventanas de contexto y permisos aislados, cuándo delegar (para que el contexto no se inunde), fan-out y síntesis, cadenas secuenciales, semántica de primer plano y de segundo plano, techo de profundidad de anidamiento (tres capas) y techo de concurrencia (20 por defecto): en los productos reales, tanto la profundidad de composición como la concurrencia están acotadas.

Cita clave:

"Subagents are specialized AI assistants that handle specific types of tasks. Use one when a side task would flood your main conversation with search results, logs, or file contents you won't reference again: the subagent does that work in its own context and returns only the summary." "Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions. When Claude encounters a task that matches a subagent's description, it delegates to that subagent, which works independently and returns results." "Preserve context by keeping exploration and implementation out of your main conversation" "For independent investigations, spawn multiple subagents to work simultaneously:" "Each subagent explores its area independently, then Claude synthesizes the findings. This works best when the research paths don't depend on each other." "When subagents complete, their results return to your main conversation. Running many subagents that each return detailed results can consume significant context." "For multi-step workflows, ask Claude to use subagents in sequence. Each subagent completes its task and returns results to Claude, which then passes relevant context to the next subagent." "Foreground subagents block the main conversation until complete. Permission prompts are passed through to you as they come up." "Background subagents run concurrently while you continue working." "A background subagent's results reach Claude as a completion notification in a later turn." "By default, a subagent can spawn subagents of its own, up to three layers below the main conversation. At the depth limit, Claude Code withholds the Agent tool from every subagent except a fork, so a subagent at the limit does its delegated work itself and returns one summary." "Nested subagents suit a delegated task that itself splits into parallel subtasks, such as a reviewer subagent that dispatches a verifier per finding, so the intermediate output never reaches your main conversation. Only the top-level subagent's summary returns to you." "Two limits control subagent use, each with its own variable: this one stops Claude from spawning more subagents while too many are running, and the depth limit caps how deeply subagents nest. There's no limit on the total number of subagents Claude can spawn over a session." "By default, when 20 subagents are running in a session, spawning another with the Agent tool fails with Concurrent subagent limit reached, and the error tells Claude not to retry."

S5 — Orchestrate subagents at scale with dynamic workflows — Claude Code official documentation

URL: https://code.claude.com/docs/en/workflows

  • authority: official-docs

La documentación de flujos de trabajo dinámicos de Claude Code: la implementación a nivel de producto de «la orquestación vive en el código», y la página más cercana a este curso. El eje de quién tiene el plan; el propio script del flujo de trabajo sostiene el bucle, las bifurcaciones y los resultados intermedios, mientras que el contexto del modelo solo sostiene la respuesta final; los resultados intermedios se quedan en variables del script; hacer fan-out y recoger, comprobar-arreglar-volver a comprobar hasta que pase o deje de progresar; concurrencia de 16 y un techo de 1000 agentes por ejecución; el seguimiento incremental de resultados trae recuperabilidad, y un fan-out de grano fino conserva más progreso que un único agente largo.

Cita clave:

"A dynamic workflow is a JavaScript script that orchestrates subagents at scale. Claude writes the script for the task you describe, and a runtime executes it in the background while your session stays responsive." "Reach for a workflow when a task needs more agents than one conversation can coordinate, or when you want the orchestration codified as a script you can read and rerun." "Subagents, skills, agent teams, and workflows can all run a multi-step task. The difference is who holds the plan:" "A workflow moves the plan into code. With subagents, skills, and agent teams, Claude is the orchestrator: it decides turn by turn what to spawn or assign next, and every result lands in a context window. A workflow script holds the loop, the branching, and the intermediate results itself, so Claude's context holds only the final answer." "Moving the plan into code also lets a workflow apply a repeatable quality pattern, not just run more agents: it can have independent agents adversarially review each other's findings before they're reported, or draft a plan from several angles and weigh them against each other, so you get a more trustworthy result than a single pass." "The workflow runtime executes the script in an isolated environment, separate from your conversation. Intermediate results stay in script variables instead of landing in Claude's context." "A workflow fits best when the task is larger than one agent can hold in context, or when the same step needs to run across many items." "Fan out one agent per file, then collect and verify the findings." "Run a checker, fix what failed, and repeat until it passes or stops making progress." "Up to 16 concurrent agents, fewer when Claude Code has fewer CPUs available, including inside a CPU-limited container" "1,000 agents total per run" "The runtime tracks each agent's result as the run progresses, which is what makes a run resumable within the same session." "A workflow that fans work out across many small agents therefore preserves more progress than one long agent."

S6 — Multiagent orchestration — Claude API documentation (Managed Agents)

URL: https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration

  • authority: official-docs

La página de orquestación multiagente de la plataforma actual de Claude: el «enfoque actual» al que apunta el cartel de S1. Su valor es doble: da el contrato de composición a nivel de API (sandbox, sistema de archivos y credenciales compartidos, cada agente en un hilo de sesión aislado, hilos persistentes y reanudables, techo de concurrencia de 25) y, por su cuenta, nombra Parallelization / Specialization / Escalation, lo que prueba que la taxonomía de patrones de 2024 sigue viva en el vocabulario de primera mano de hoy.

Cita clave:

"Multiagent orchestration lets one agent coordinate with others to complete complex work. Agents can act in parallel with their own isolated context, which helps improve output quality and can also improve time to completion." "All agents share the same sandbox, filesystem, and vault credentials, but each agent runs in its own session thread, a context-isolated event stream with its own conversation history." "Threads are persistent: the coordinator can send a follow-up to an agent it called earlier, and that agent retains everything from its previous turns." "Multiagent coordination is best suited for complex tasks that either require work across a variety of surfaces, or where multiple well-scoped tasks contribute to an overall goal." "Parallelization: Fan out independent subtasks simultaneously (searching multiple sources, analyzing separate files) and have the coordinator synthesize the results." "Specialization: Route to agents with domain-focused system prompts and tools, such as a security agent or a documentation agent, rather than loading a single agent with every capability." "Escalation: Consult a more capable agent or model for a subset of complex subtasks." "A maximum of 25 concurrent threads is supported. The coordinator can call multiple copies of a single agent in the roster, creating multiple threads associated with one agent."