Agents

The agents API (proteus.agents) lets you create and manage agents over REST.

Create an agent

const agent = await proteus.agents.create({
  name: 'Support Bot',
  goal: 'You are a helpful assistant. Always answer questions kindly and helpfully.',
  orgId: '<orgId>',
  // isPublic: true,
});
console.log('agent id', agent.id);

Get an agent

const agent = await proteus.agents.getById('<agentId>');

Update an agent

const agent = await proteus.agents.update('<agentId>', {
  description: 'Handles billing questions',
});

Delete an agent

await proteus.agents.delete('<agentId>');

Get an agent's MCP servers

const mcps = await proteus.agents.getMcps('<agentId>');

List an agent's event handlers

const handlers = await proteus.agents.getEventHandlers('<agentId>');

Once you have an agent, start talking to it with chats and messages.

Node SDK Chats