How it fits together
From a developer writing an agent to a user getting an answer.
Building an agent
- A developer creates a draft and writes the agent in JSON, in the editor or with Draft with AI.
- The developer validates the draft. Search2o Cloud checks the definition and every Python expression in it. The agent server then runs the draft against a validation query the developer supplies and shows the full execution trace.
- A validated draft is published. Other developers can now see the agent, and users can run it.
- In a separate step, the developer writes a plain-English description of what the published agent does. The cloud indexes the description, and from then on search can find the agent.
Answering a query
- A user types a request in the search box or in a connected chat application. The agent server sends the request to the cloud, which returns the matching agent: one agent, several candidates when the request is ambiguous, or none when nothing fits.
- The agent server runs the chosen agent in the agent runtime. The agent calls LLMs and your systems, may ask the user for more input, and streams its output back as it runs.
- When the agent finishes, the conversation context is encrypted and stored in the cloud, or stored by your own code if the account keeps conversations in its own enterprise.
- A follow-up request continues the conversation. The context is restored, and the same agent or a different one runs with it, so agents build on each other's work.
Keeping servers consistent
Configuration, such as LLM profiles, allowlists and limits, is edited in the UI and stored in the cloud. Each time an agent starts, the agent server asks the cloud what has changed since the server last checked, fetches only those parts, and applies them before the run. A change is live on the next run on every server, and two servers starting the same agent at the same moment run with the same configuration. See Runtime sync.

