# AX-SYS-20: Make agent activity visible

> Observability and governance · advanced · AX-SYS-20

Identify agent traffic with explicit headers and log what each agent did, when, and why.

## Why

Without differentiating agent traffic from human traffic, services cannot debug failures, audit what agents did, or improve their AX based on real usage. The canonical AX framework (agentexperience.ax — Differentiate Agent Interaction) states this explicitly: "digital services will be harder to debug, lack context for usage audits, and will miss key insights on how agents use their service." Speakeasy identifies Traceability as one of four foundational AX properties for APIs. The canonical agent-facing principle (Transparent Identity) requires agents to identify themselves via `User-Agent` — this principle is the service-side mirror of that requirement.

## Do

Require `X-Agent-Name` and audit-log agent actions.

## Don't

Let unidentified agents act invisibly.

## Artifact

```http
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)
```

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

## Citations

1. [agentexperience.ax — Principles of AX](https://agentexperience.ax/concepts/principles-of-ax/) — Differentiate Agent Interaction: without differentiating agents in data, digital services will be harder to debug, lack context for usage audits, and miss key insights on how agents use their service
2. [Speakeasy — Designing Agent Experience](https://www.speakeasy.com/blog/agent-experience-introduction) — Traceability is one of four core AX properties for APIs; agent traffic must be identifiable and auditable
3. [Mathias Biilmann — One Year of AX](https://biilmann.blog/articles/one-year-of-ax/) — Differentiate Agent Interaction: agent traffic must be captured separately in metrics, logs, traces, and audit logs

---
Source: Agent Experience Principles (axprinciples.com)