Saltar al contenido
AX Principios
AX-SYS-19AvanzadoBorrador

Define roles y contratos de transferencia para flujos multiagente

Define roles and handoff contracts for multi-agent flows

#enterprise#a2a

Cuando los agentes colaboran, especifica la responsabilidad y los límites de cada uno, y el contrato exacto para transferirse el trabajo.

Por qué

Los roles claros y los contratos de transferencia evitan el caos multiagente. El protocolo Google A2A lo formaliza a nivel de protocolo: un agente planificador descompone un objetivo, delega subtareas vía A2A y cada subagente ejecuta usando sus propias conexiones de herramientas. La investigación de Microsoft sobre gobernanza de agentes identifica los límites de rol indefinidos como la causa principal de los fallos multiagente en el ámbito empresarial. El marco 12-Factor Agents es directo: un agente, un trabajo. Componer en lugar de construir monolitos. Sin un contrato de transferencia explícito (quién hace qué, con qué alcance y qué devuelve), los agentes improvisan la coordinación y producen resultados impredecibles.

Haz

Nombra los roles y define la carga útil de transferencia.

No hagas

Dejar que los agentes improvisen la coordinación.

Artefacto

{
  "from_agent": "planner",
  "to_agent": "executor",
  "role": "executor",
  "task": "Issue refund for order ord_123",
  "scope": ["refunds:write"],
  "context": { "order_id": "ord_123", "reason": "duplicate charge" },
  "constraints": { "max_spend_usd": 50, "requires_dry_run": true },
  "return_to": "planner"
}

Fuentes

  1. [01]
    Google A2A Protocol — Task Lifecycle and Orchestration

    A planning agent decomposes objectives into sub-tasks and delegates each to a specialised agent via A2A; clear role definitions and handoff payloads are required for reliable multi-agent coordination

  2. [02]
    Microsoft — agent-governance-toolkit

    Multi-agent orchestration patterns require explicit role definitions and handoff contracts — undefined boundaries are the primary cause of agent coordination failures in enterprise deployments

  3. [03]
    12-Factor Agents — Single Responsibility

    Build small, focused agents with one clear job and compose them into workflows; each agent should have a named role and explicit input/output contract