Introduction
Run an Agent through the public API — a single LLM configuration with tools, knowledge, and skills.
An Agent is the base unit you build on in Elizon: one LLM configuration — model, instructions, memory, tools, knowledge, skills — that you run directly with a prompt and get a reply back. Where a Team composes several Agents under a lead and a coordination mode, and a Workflow chains steps (Agents among them) into a graph, an Agent is the single call with nothing in front of it.
How this fits together
- Creating and configuring an Agent — its model, instructions, memory, tools, knowledge, and skills — is covered in the API Reference's Agents group (list, create, get, update), or in the Studio Agent Builder.
- Running an Agent — sending it a prompt and getting a response back — is the public API
surface covered in this section:
/run,/run-stream,/run-async, and/jobs.
What this section does not cover
Creating, updating, or deleting an Agent, or configuring its model, instructions, memory, tools, knowledge, or skills. Those are the Agents CRUD endpoints or the Studio Agent Builder — not part of this section.
Where to go next
- Run (synchronous) —
POST /api/v1/agents/{agentId}/run, plus cancelling a run. - Run (streaming) —
POST /api/v1/agents/{agentId}/run-stream. - Run (async) —
POST /api/v1/agents/{agentId}/run-async. - Jobs — poll and cancel an async run.
New to the API entirely? Start with the Quickstart — it walks through creating an API key, listing your Agents, and running one, end to end.