agent.run

Agente (IA)

IA analisa os dados e devolve variáveis para o fluxo.

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

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
systemPrompt	string	não	"És um classificador de documentos. Analisa o documento e devolve apenas os campos pedidos no schema, sem inventar valores."	Instrução de sistema enviada ao modelo. Vazio na config = esta instrução. Aceita tokens {{record.x}}/{{vars.y}}.	expressões {{record.coluna}}
userPrompt	string	não	""	Pedido concreto, por cima da instrução de sistema. Aceita tokens {{record.x}}/{{vars.y}}.	expressões {{record.coluna}}
schema	json	não	{}	JSON Schema do que o agente devolve; as chaves do primeiro registo emitido entram em vars.	-
invalidSchema	string	não	""	Texto cru do schema quando não é um JSON de objeto. Não-vazio = config por corrigir, e o passo falha antes de chamar o modelo.	-
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.	-

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)

Exemplo JSON

{
  "systemPrompt": "És um classificador de documentos. Analisa o documento e devolve apenas os campos pedidos no schema, sem inventar valores.",
  "userPrompt": "",
  "schema": {},
  "invalidSchema": ""
}

---

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