Integration Patterns

Expose an Agent over HTTP

Turn a local Agent into an HTTP service for other processes or clients

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

await agent.start({
  http: {
    host: "127.0.0.1",
    port: 15314,
  },
});

Then connect to it from another process using RemoteAgent.

This creates a very natural local client-server shape:

Multiple Agents in One Repo

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

Inject ChatService into a Local Agent

Typical way to explicitly pass a ChatService instance in SDK mode