Esta página se muestra en inglés. Una traducción al español está en curso.
PromptsApr 7, 2026·3 min de lectura

AI Agent Design Patterns — Architecture Guide 2026

Catalog of proven design patterns for building AI agents: ReAct, Plan-and-Execute, Reflection, Tool Use, Multi-Agent, Human-in-the-Loop, and more. With architecture diagrams and code examples.

Listo para agents

Instalación con revisión previa

Este activo requiere revisión. El prompt copiado pide dry-run, muestra escrituras y continúa solo tras confirmación.

Needs Confirmation · 64/100Política: confirmar
Superficie agent
Cualquier agent MCP/CLI
Tipo
Prompt
Instalación
Single
Confianza
Confianza: Community
Entrada
AI Agent Design Patterns — Architecture Guide 2026
Comando con revisión previa
npx -y tokrepo@latest install 958852ab-9d94-415e-91b3-a44c467c4e0a --target codex

Primero dry-run, confirma las escrituras y luego ejecuta este comando.

TL;DR
A catalog of proven design patterns for building AI agents, including ReAct, Plan-and-Execute, Reflection, and Multi-Agent architectures.
§01

What it is

This resource is a curated catalog of design patterns for building AI agents. It covers the architectural approaches that have emerged as standard practice: ReAct (reason + act), Plan-and-Execute, Reflection loops, Tool Use, Multi-Agent orchestration, and Human-in-the-Loop control flows. Each pattern includes when to use it, how it works, and implementation guidance.

The guide targets AI engineers, developers building agent systems, and architects deciding which patterns fit their use case. It provides a decision framework rather than promoting a single approach.

§02

How it saves time or tokens

Building an AI agent without understanding established patterns leads to reinventing solutions that the community has already refined. This catalog maps task types to appropriate patterns, so you pick the right architecture from the start instead of discovering its limitations mid-project. Choosing the correct pattern also minimizes wasted LLM tokens -- a ReAct agent uses fewer tokens than Plan-and-Execute for simple tasks, while multi-step projects need the planning overhead.

§03

How to use

  1. Identify your task complexity using the decision table:
Task TypeRecommended Pattern
Simple Q&A with toolsReAct
Multi-step projectsPlan-and-Execute
Self-improving outputReflection
Specialized subtasksMulti-Agent
Safety-critical flowsHuman-in-the-Loop
  1. Study the pattern description, architecture diagram, and code example.
  1. Implement using your preferred framework (LangGraph, OpenAI Agents SDK, CrewAI, etc.).
§04

Example

# ReAct pattern: Reason -> Act -> Observe -> Repeat
def react_agent(query, tools, max_steps=5):
    messages = [{'role': 'user', 'content': query}]
    for step in range(max_steps):
        response = llm.chat(messages, tools=tools)
        if response.tool_calls:
            for call in response.tool_calls:
                result = execute_tool(call)
                messages.append({'role': 'tool', 'content': result})
        else:
            return response.content
    return 'Max steps reached'
§05

Related on TokRepo

§06

Common pitfalls

  • Over-engineering with multi-agent patterns when a single ReAct agent suffices. Start simple and add complexity only when the task demands it.
  • Skipping the human-in-the-loop pattern for high-stakes decisions. Autonomous agents making irreversible actions (deploys, payments, emails) need approval gates.
  • Ignoring token costs in reflection loops. Each reflection cycle consumes additional tokens. Set a maximum iteration count to prevent runaway costs.

Preguntas frecuentes

Which pattern should I start with?+

Start with ReAct. It covers most common use cases (question answering with tools, data lookup, simple automation). Move to Plan-and-Execute when tasks require multiple coordinated steps.

Can I combine multiple patterns?+

Yes. Production agents often combine patterns. A Plan-and-Execute agent might use ReAct for individual step execution and add a Reflection loop for quality checks. The patterns are composable building blocks.

What frameworks implement these patterns?+

LangGraph, OpenAI Agents SDK, CrewAI, AutoGen, and Semantic Kernel all implement variations of these patterns. The catalog is framework-agnostic -- understand the pattern first, then map it to your framework.

How do I choose between ReAct and Plan-and-Execute?+

ReAct works step-by-step without an upfront plan. Plan-and-Execute creates a plan first, then executes steps. Use ReAct for tasks with 1-3 steps. Use Plan-and-Execute when the task requires coordinating 4+ steps or when order matters.

What is the Reflection pattern?+

Reflection adds a self-critique step after the agent produces output. The agent reviews its own work, identifies issues, and iterates. This improves output quality at the cost of additional LLM calls per iteration.

Referencias (3)
🙏

Fuente y agradecimientos

Synthesized from LangChain, Anthropic, OpenAI, and Microsoft research on agent architectures.

Related: CrewAI, AutoGen, LangGraph, Smolagents, Engram

Discusión

Inicia sesión para unirte a la discusión.
Aún no hay comentarios. Sé el primero en compartir tus ideas.

Activos relacionados