agent.tools

Agente (Autónomo)

IA investiga com ferramentas e propõe o resultado.

• Kind: step
• Key: agent.tools
• Categoria: transform
• Envelope: mapa (um objeto JSON em config)

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
systemPrompt	string	não	""	Instruções que substituem as do agente por omissão. Aceita tokens {{record.x}}/{{vars.y}}.	expressões {{record.coluna}}
userPrompt	string	não	""	O OBJETIVO que o agente persegue. Aceita tokens {{record.x}}/{{vars.y}}.	expressões {{record.coluna}}
allowedTools	list de string	não	[]	Ferramentas que o agente pode usar. Vazio = todas as de leitura (é o modo normal).	-
maxIterations	integer	não	-	Teto de iterações do loop do agente. Ausente = o teto do servidor (que faz sempre clamp ao seu máximo).	-
outputSchema	json	não	{}	JSON Schema da resposta final. Vazio = resposta em texto livre, sem forma imposta.	-
allowProposeRows	boolean	não	false	O agente pode PROPOR linhas (substituem os registos do envelope como proposta). Escrever é sempre de outro passo.	-
includeRunFiles	boolean	não	true	Os ficheiros desta execução seguem para o agente como contexto. Desligado = corre só sobre os dados do envelope.	-
modelSource	map	não	-	De onde vem o modelo de IA: o catálogo OutDo (omissão) ou uma ligação ai_provider da organização.	-
referenceCorpus	list de map	não	[]	Ficheiros de base anexados ao CARD (ex.: o texto de uma lei), que o agente consulta em TODAS as execuções.	-

modelSource

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
kind	enumeration	não	"catalog"	Catálogo OutDo (resolvido pelas definições de IA da organização) ou ligação própria (BYOK).	-
mode	enumeration	não	-	Slot do catálogo a forçar. Ausente = o slot por omissão do passo. Só conta no modo de catálogo.	-
connectionName	string	não	-	Nome da ligação ai_provider que serve o modelo. Só conta no modo de ligação.	ligação (nome)

referenceCorpus[]

Cada elemento de referenceCorpus é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
id	uuid	sim	-	Id do ficheiro no storage da organização de origem. Um ficheiro não é entidade de template: não viaja num pacote.	ficheiro (uuid)
name	string	sim	-	Nome do ficheiro, como o autor o vê.	-
mimeType	string	sim	-	Tipo MIME: é por ele que o servidor decide se converte o ficheiro em texto ou o manda em base64.	-
storagePath	string	não	-	Caminho no armazenamento, de onde o servidor descarrega os bytes.	-

Exemplo JSON

{
  "systemPrompt": "",
  "userPrompt": "",
  "allowedTools": [],
  "outputSchema": {},
  "allowProposeRows": false,
  "includeRunFiles": true,
  "referenceCorpus": []
}

---

Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.