Haz visible la actividad de los agentes

Identifica el tráfico de agentes con encabezados explícitos y registra qué hizo cada agente, cuándo y por qué.

Por qué

Sin diferenciar el tráfico de agentes del tráfico humano, los servicios no pueden depurar fallos, auditar lo que hicieron los agentes ni mejorar su AX a partir del uso real. El marco canónico de AX (agentexperience.ax, Diferenciar la Interacción de Agentes) lo afirma de forma explícita: "los servicios digitales serán más difíciles de depurar, carecerán de contexto para las auditorías de uso y perderán información clave sobre cómo los agentes usan su servicio." Speakeasy identifica la Trazabilidad como una de las cuatro propiedades fundamentales de AX para las APIs. El principio canónico orientado al agente (Identidad Transparente) exige que los agentes se identifiquen mediante User-Agent: este principio es el reflejo de ese requisito en el lado del servicio.

Haz

Exige X-Agent-Name y registra las acciones de los agentes en un log de auditoría.

No hagas

Dejar que agentes no identificados actúen de forma invisible.

Artefacto

X-Agent-Request: true
X-Agent-Name: acme-support-bot
X-Agent-Operator: org_acme
User-Agent: acme-support-bot/1.4 (+https://acme.com/agents)

{ "ts": "2026-06-04T12:00:00Z", "agent": "acme-support-bot", "operator": "org_acme",
  "action": "create_refund", "resource": "ord_123", "result": "ok", "reason": "duplicate charge" }