Agents
Crie e versiona configurações de agents dentro de um projeto.
#Endpoints
| Método | Caminho | Descrição |
|---|---|---|
| POST | /v1/projects/:projectId/agents | Cria um agent e publica a versão 1. |
| POST | /v1/projects/:projectId/agents/:id | Aplica patch com lock otimista e publica nova versão. |
| POST | /v1/projects/:projectId/agents/:id/archive | Arquiva o agent. |
| GET | /v1/projects/:projectId/agents/:id/versions | Lista versões por cursor. |
| GET | /v1/projects/:projectId/agents/:id | Lê a versão atual ou uma versão específica. |
| GET | /v1/projects/:projectId/agents | Lista agents por cursor, com filtro opcional por nome. |
#Criar agent
ts
const agent = await client.agents.create({
name: 'Assistente operacional',
model: 'anthropic/claude-haiku-4-5',
system: 'Responda com clareza e peça dados faltantes antes de concluir.',
tools: ['web_search', 'memory_read'],
});#Atualizar agent
Atualizações exigem a version atual. Se outra mudança publicou uma versão mais nova, a API retorna conflito.
ts
const updated = await client.agents.update(agent.id, {
version: agent.version,
system: 'Responda com clareza, peça dados faltantes e cite fontes quando pesquisar.',
});#Campos principais
| Campo | Tipo | Observação |
|---|---|---|
name | string | Nome de 1 a 200 caracteres. |
description | string | Opcional, para humanos. |
model | string ou objeto | Identifica provedor e modelo. |
system | string | Instruções persistentes. |
tools | array | Built-ins por string ou custom tools serializadas. |
mcpServers | array | Servidores MCP com name, url e headers opcionais. |
toolPermissions | object | always_allow ou always_ask por tool. |
metadata | object | Pares string → string. |