Get an agent's test suite green

A red suite is usually not one bug. It is several unrelated causes stacked together, and most of them are broken tests, not a broken agent. Triage by cause first; fixing blind wastes whole runs, since each simulation takes minutes.

Host https://api.elevenlabs.io, header xi-api-key: $API_KEY. The engineer supplies $API_KEY, $AGENT_ID, $BRANCH_ID.

1. Establish a baseline before changing anything

You cannot tell a fix from noise without a starting number.

curl -s "https://api.elevenlabs.io/v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID" \
  -H "xi-api-key: $API_KEY" > agent.json

The suite is at platform_settings.testing.attached_tests — a mix of individual test_ ids and tfld_ folder ids. Only these are this agent's CI.

That distinction matters more than it looks. On a real Architect suite, 56 tests ran but only 3 were attached to the agent; the other 53 came from inherited folders and belonged to entirely different agents (a Zendesk support agent, a delivery agent, a sales agent). They failed because they asserted another agent's behavior. No amount of fixing makes them pass here, and "fixing" them means editing another team's tests.