Skip to main content
An agent (also called a workflow or graph in the product) is a versioned definition of how work runs: which steps execute, in what order, how data flows between them, and which tools the model may call.

​
Parts of an agent

​
From authoring to agent_id

The easiest path to creating a new agent is to use a Sudoiq agent-builder—either in the product UI or through the agentservice CLI—to design, iterate, and publish your workflow. If you prefer, you can pair the CLI (for example agentservice agents modify) with your own coding agent or editor workflow: you maintain graph JSON/YAML locally while the CLI uploads and syncs with Sudoiq, so you can treat “building agents” as its own repeatable dev flow. When published, the platform assigns a stable identifier — the agent_id (UUID) you pass to run_agent, execute, or webhooks. Integrations only need the agent_id (and optional version) plus inputs (string slots, images, file references) to start execution.