Agents

Agents are the public stateless packaging and control-plane noun for multi-step Prompt Orchestra systems.

Public status

Stable runtime:

• GET /api/agents/:id
• POST /api/agents/:id/run
• GET /api/agent-runs/:id
• POST /api/agent-runs/:id/load-inputs
• POST /api/agent-runs/:id/rerun-from-step

Public beta stateless authoring and iteration:

• GET /api/agents
• POST /api/agents
• PATCH /api/agents/:id
• POST /api/agents/:id/versions
• POST /api/agents/:id/publish
• PUT /api/agent-versions/:id/workflow
• POST /api/agent-versions/:id/workflow/validate
• GET /api/agent-runs/compare
• GET /api/agents/:id/versions/:versionId/diff
• POST /api/agents/:id/versions/:versionId/rollback

Workflow model

Workflow is public only as dependent configuration under an agent version.

That means the public authoring flow is:

• create an agent
• create a version
• validate and save workflow on that version
• publish
• run and inspect
• compare runs, diff versions, or roll back if needed

There is no top-level public workflow noun and no client.workflows.*.

Relationship to skills

Skills remain the public beta executable unit inside agent workflows.

Agents are the public stable runtime surface for persisted run detail and rerun helpers, and the public beta stateless authoring surface for packaging and iteration.

Still not public

• session-backed agent routes
• realtime agent routes
• low-level version patch and step/transition mutation helpers outside saveWorkflow

See also

• Runs
• Public Boundary