HTTP Adapter

​

When to Use

• Agent runs as an external service (cloud function, dedicated server)
• Fire-and-forget invocation model
• Integration with third-party agent platforms

​

When Not to Use

• If the agent runs locally on the same machine (use process, claude_local, or codex_local)
• If you need stdout capture and real-time run viewing

​

Configuration

​

How It Works

1. AoA sends a POST request (or configured method) to the URL
2. The URL is validated and DNS-pinned before the request fires (SSRF guard — private IPs rejected)
3. The external agent processes the request and calls back to the AoA API
4. Non-2xx responses throw an error and fail the run

​

Request Body

{
  "agentId": "...",
  "runId": "...",
  "context": { ... },
  ...payloadTemplate
}