Integration Patterns

Expose Agent over HTTP

Expose a local Agent as an HTTP service for other processes or clients

If the caller and the executor do not live in the same process, you can expose the local Agent as an HTTP service.

In Downcity, HTTP exposure is published by Downcity:

downcity agent start

For local process-to-process access, prefer rpc://. Use HTTP when an external client needs to call the Agent through the Downcity gateway.

Multiple Agents in One Repo

Use multiple agentIds to isolate different SDK Agents in the same project directory

SDK Surface

The practical public API surface of Agent, RemoteAgent, and Session from a developer's point of view