Agents
Agents são configurações versionadas que definem como o modelo raciocina, quais ferramentas pode usar e quais políticas governam sua execução.
#O que um agent contém
Um agent combina instruções e capacidades. A configuração normalmente inclui:
| Campo | Função |
|---|---|
name | Nome operacional usado por humanos e listagens. |
model | Modelo ou configuração de modelo usada para gerar respostas. |
system | Instruções permanentes de comportamento. |
tools | Built-ins e custom tools disponíveis para o modelo. |
mcpServers | Servidores MCP expostos ao agent. |
toolPermissions | Política de execução por tool. |
metadata | Chaves de negócio para busca e organização. |
#Versionamento
Criar um agent publica a versão 1. Atualizar a configuração publica uma nova versão. Sessions abertas depois da atualização podem usar a versão mais recente; sessions já iniciadas continuam presas à versão com que nasceram.
Esse modelo evita que uma mudança de prompt, tool ou permissão altere o comportamento de uma execução em andamento. Também permite comparar versões e voltar a uma configuração anterior com segurança operacional.
#Como escrever configuração boa
- Escreva o
systemcomo contrato de comportamento, não como texto motivacional. - Declare limites: o que o agent pode assumir, quando deve pedir dados e quando deve recusar.
- Mantenha tools pequenas e nomeadas por ação de negócio.
- Use
metadatapara organizar ownership, canal, produto ou caso de uso. - Trate
toolPermissionscomo política de risco: operações sensíveis pedem aprovação.
#Exemplo com SDK
agent.tsts
import Noorden from '@noorden/sdk';
const client = new Noorden.Platform();
const agent = await client.agents.create({
name: 'Analista de sinistros',
model: 'anthropic/claude-haiku-4-5',
system: [
'Você analisa documentos de sinistro.',
'Liste evidências, incertezas e próximos passos.',
'Não aprove ou negue cobertura sem regra explícita.',
].join(' '),
tools: ['read', 'grep', 'web_fetch'],
toolPermissions: {
web_fetch: 'always_ask',
},
metadata: { domain: 'claims' },
});