Run the gym

Start a gym session on an agent with an environment, follow it, then read its scores.

Endpoints

All paths start with /api/v1/diagnostics and need X-Space-Slug.

Request fields

• The environment must belong to the agent, to the agent it was promoted from, or to no agent.
• A session plays cases × n_runs conversations per round; an optimization repeats that for each round.

Measure or improve an agent

1. Start the session:

   curl -X POST "$CENTRAL_HUB_URL/api/v1/diagnostics/agents/42/gym/" \
     -H "X-API-Key: $ALO_API_KEY" \
     -H "X-Space-Slug: $WORKSPACE_SLUG" \
     -H "Content-Type: application/json" \
     -d '{"kit_id": 7, "lane": "baseline", "n_runs": 3}'

   The response holds id, status and, while it waits for a free slot, queue_position.

2. Poll GET /gym/{id}/ about once a minute until status is completed, cancelled or failed; see Statuses.

3. Read a round's scores; a baseline has round 1, an optimization lists its rounds in epoch_reports and its best in best_epoch:

   curl "$CENTRAL_HUB_URL/api/v1/diagnostics/gym/89/epochs/1/kpis/" \
     -H "X-API-Key: $ALO_API_KEY" \
     -H "X-Space-Slug: $WORKSPACE_SLUG"

   The response holds objective_value, total_executions, errored_executions, checks[] with {label, passed, evaluated}, latency and cost.

4. After an optimization, POST /gym/{id}/promote/ saves the best configuration as a new agent, or POST /gym/{id}/reject/ discards it. Rejecting deletes the gym's copy of the agent and its conversations: read them first.

• The gym's conversations belong to its copy of the agent: read them with fork_agent_id, as in Read the conversations.

Statuses

Troubleshooting