Skip to main content

AgentStepSpec

Workflow-agent call spec for an agent step. timeout_seconds is bounded on both ends deliberately. Without a lower bound a 0 or negative value passes storage validation and then fails the moment it reaches httpx; without the upper bound a value above 300 is stored while never taking effect, because the agent control plane forwards with a fixed httpx.AsyncClient(timeout=300) and returns 504 first. Both are caught here as a 422 at save time rather than mid-batch. The 300 comes from that control-plane constant — if it moves, this moves with it.

versionVersion (integer)
Constant value: 1
Default value: 1
agent_idAgent Id (string)required

Agent resource ID (workflow mode)

timeout_seconds object

Per-call timeout. Capped at the agent control plane's fixed 300s forward timeout, above which the call 504s before this applies.

anyOf
integer

Possible values: > 0 and <= 300

AgentStepSpec
{
  "version": 1,
  "agent_id": "string",
  "timeout_seconds": 0
}