AI agents · Types
What is an API agent?
The short answer
Another application calls it, it does one job, and it returns a result in a fixed format. There is no conversation.
It is one of the 3 forms of workflow agent, with the scheduled agent and the event-triggered agent.
| What starts it | A call from another system |
|---|---|
| Who decides the next step | The builder sets the job. The caller decides what follows |
When should you use an API agent?
Use it when an existing system needs judgement at one step: classify this, summarise that, draft a decision note.
When should you not?
Not when a fixed rule would give the same answer.
What does it need to run safely?
It needs a fixed format for what goes in and what comes out, a check on who is calling, a time limit, and a defined answer for "cannot decide".
An example
The lending system sends an application and receives a risk summary with its reasons listed.
What else is it called?
Headless agent, task agent. The caller can be another agent. The Agent2Agent protocol, started by Google and now hosted by the Linux Foundation, sets out how one agent finds and calls another built by a different team or company.
How do you build one on Katonic?
- Build and test the agent.
- Deploy, Channels. Work Room is on by default. Turn on API, "Call the agent over HTTP".
- Deploy, API endpoint. The page shows the address and a ready
curlcall. The caller sends a bearer token and a JSON message. - Publish. The endpoint works only for a published agent.
- Optional: under Agent-to-Agent (A2A) choose Exposed via A2A so other agents can find and call it. It "publishes an agent card; callers authenticate with a platform API key".
Questions people ask
What starts an API agent?
A call from another system.
Who decides its next step?
The builder sets the job. The caller decides what follows.
What is a workflow agent?
A workflow agent works with nobody asking. A clock, an event or another system starts it, and it does a defined job in the background. Google describes these as background agents: little or no human interaction, and generally driven by events.