Supervisor API Background Mode

Prerequisites:

1. Run quickstart first (uv run quickstart) — it creates the MLflow experiment and .env file needed by the server.
2. Follow the supervisor-api skill to set up the Supervisor API with hosted tools and permissions. This skill extends that setup with background mode support.

Background mode submits the request asynchronously (background=True), polls for completion, and streams the result back to the frontend. Use this when agent tasks may exceed HTTP timeout limits (complex multi-tool workflows, large data analysis, etc.).

Before Starting

Use the AskUserQuestion tool to ask: "How often should the agent poll for background task completion?" with options:

• Every 2 seconds — Fast response times, good for interactive use
• Every 10 seconds — Balanced between responsiveness and API load
• Every 30 seconds — Lower API load, suitable for very long-running tasks

Use their answer to set POLL_INTERVAL in agent_server/utils.py.

Architecture