01

Primero demuestra que necesitas un equipo

La arquitectura más avanzada no es automáticamente la mejor. Un flujo determinista sirve cuando los pasos son conocidos; un solo agente con buenas herramientas conserva contexto y simplifica la evaluación. Divide el sistema cuando la lógica condicional, el solapamiento de herramientas o las responsabilidades distintas deterioran de forma observada el resultado.

Flujo fijo

Pasos previsibles, reglas claras y controles programáticos entre etapas.

Agente único

La ruta cambia, pero una sola responsabilidad y un conjunto coherente de herramientas bastan.

Equipo de agentes

Hay dominios, permisos, contextos o criterios realmente distintos que conviene aislar.

No construir

La decisión no es evaluable, el coste de error es inaceptable o una regla convencional resuelve mejor el trabajo.

02

Elige dónde vive el control

OpenAI distingue dos patrones generales: un manager que llama a especialistas como herramientas y un sistema descentralizado donde los agentes transfieren la ejecución mediante handoffs. Un tercer patrón práctico, orquestador-trabajadores, descompone trabajo variable y luego sintetiza resultados.

Manager

Una sola voz conserva el control, delega piezas y compone la respuesta final. Útil cuando el usuario debe tratar con un único responsable.

Handoffs

Un especialista asume la ejecución y el contexto reciente. Útil cuando la responsabilidad completa cambia de manos.

Orquestador-trabajadores

El coordinador crea subtareas según el caso, permite paralelismo seguro y reúne los artefactos.

Código determinista

Las transiciones críticas, permisos, límites y efectos irreversibles no tienen por qué decidirse con un modelo.

03

Entrega paquetes de trabajo, no deseos

Un especialista no debería recibir «resuelve esto». El contrato de tarea debe permitir actuar y también demostrar por qué la salida es aceptable.

  • Objetivo y resultado observable.
  • Entradas autorizadas y versión de las fuentes.
  • Herramientas permitidas y acciones expresamente prohibidas.
  • Formato de salida y artefactos que deben conservarse.
  • Pruebas de aceptación y evidencia requerida.
  • Máximo de turnos, tiempo, coste y reintentos.
  • Regla de escalado cuando falte una decisión humana.
04

Trata las herramientas como fronteras

MCP estandariza la conexión entre un host, clientes aislados y servidores que exponen capacidades. Esa composición no elimina la seguridad: el host conserva autorización, consentimiento y contexto; las capacidades se negocian y las herramientas declaran esquemas y efectos.

Mínimo privilegio

Cada rol ve solo las fuentes y acciones necesarias para su encargo.

Esquemas explícitos

Argumentos, salidas y errores deben poder validarse antes de continuar.

Efectos visibles

Enviar, borrar, publicar o pagar requiere confirmación proporcional al impacto.

Idempotencia

Un reintento no debe duplicar acciones ni corromper el estado.

Registro útil

Conserva decisión, herramienta, resultado y error sin almacenar secretos innecesarios.

05

Separa construcción y verificación

La misma salida debe pasar controles que no dependan de la confianza en el texto del agente. La evaluación puede combinar comprobaciones deterministas, revisión humana y evaluadores con modelo calibrados sobre ejemplos revisados.

  • Valida el esquema antes de valorar el contenido.
  • Ejecuta builds, pruebas o consultas sobre el artefacto real.
  • Comprueba también la respuesta final, no solo resultados intermedios correctos.
  • Convierte cada fallo conocido en un caso permanente de regresión.
  • Compara calidad, coste, latencia, llamadas, turnos y reintentos.
  • Reserva el juicio humano para utilidad, riesgo y criterios subjetivos.
06

Usa cuatro estados de salida

Un bucle agente necesita condiciones de parada observables. Este marco es una síntesis operativa: evita que «he terminado» sea una opinión del modelo.

PASS

El artefacto existe, las pruebas exigidas pasan y la evidencia queda vinculada a la versión evaluada.

REVISE

El fallo es reproducible, el responsable está identificado y queda presupuesto para una corrección acotada.

BLOCKED

Falta una dependencia, permiso o fuente externa; se conserva la causa exacta sin inventar un resultado.

ESCALATE

Hace falta una decisión de negocio, una autorización de riesgo o un criterio subjetivo humano.

07

Una definición de terminado reutilizable

Antes de iniciar el trabajo, rellena esta lista. Después, obliga al coordinador a devolverla con evidencia en lugar de un resumen optimista.

  • Artefacto exacto y versión identificados.
  • Criterios de aceptación numerados.
  • Pruebas ejecutadas con resultado y fecha.
  • Efectos externos confirmados por la autoridad adecuada.
  • Coste, duración, llamadas y reintentos registrados.
  • Limitaciones y casos no cubiertos declarados.
  • Estado final PASS, REVISE, BLOCKED o ESCALATE con fundamento.