Agents

An agent combines instructions, a model, Knowledge sources, and Tools configured in Studio. SDKs retrieve and invoke an already-published agent; they do not create or administer agents.

const agent = await client.getAgent();
console.log(agent.id, agent.name, agent.capabilities);

const result = await client.responses.create({ message: "Summarize this lead" });
console.log(result.response, result.citations);

Messages accept 1–10,000 characters. Knowledge and Tools may run internally, but SDKs never expose retrieval_sources; only authorized public citations are returned.

Capabilities describe public behavior rather than administrative access. Every operation is isolated to the public agent associated with the API key.

See Conversations to preserve context.