Argumentos
Defina as entradas e saídas do agente para controlar quais informações ele recebe e retorna.
Argumentos
A página Argumentos permite definir as informações que o agente recebe para funcionar (argumentos de entrada) e as informações que ele retorna após processar uma solicitação (argumentos de saída).
Acesse pelo ícone Argumentos na navegação lateral do Editor.
Argumentos de entrada
Argumentos de entrada são as informações que o agente precisa receber para funcionar. Por exemplo, um agente de previsão do tempo pode ter um argumento de entrada Localização.
Você pode definir o tipo de cada argumento, se ele é obrigatório e se deve ser exibido na interface do usuário.
Geração automática de formulário
Quando um ou mais argumentos de entrada têm a opção Exibir na UI ativada, o agente gera automaticamente um formulário para que o usuário preencha os valores antes de iniciar a conversa. Caso nenhum argumento esteja configurado para exibição na UI, o usuário interage com o agente somente via chat ou prompt.
Clique em Visualizar formulário (disponível quando ao menos um argumento tem Exibir na UI ativo) para ver como o formulário será apresentado ao usuário.
Argumentos de saída
Argumentos de saída são as informações que o agente retorna após processar uma solicitação. Por exemplo, um agente que analisa currículos pode retornar argumentos como Pontuação e Recomendação.
Argumentos de saída são utilizados em execuções via workflow ou webhook e retornados em formato JSON.
A coluna Exibir na UI existe apenas na aba Argumentos de entrada. Argumentos de saída não são exibidos em formulário.
Colunas da tabela
| Coluna | Descrição |
|---|---|
| Nome | Identificador do argumento. Usado como variável no prompt com a sintaxe {NomeDoArgumento}. Edite clicando diretamente no campo. |
| Descrição | Explica ao modelo de IA o propósito do argumento. Quanto mais precisa, melhor o agente entende como usá-lo. Edite clicando no campo abaixo do nome. |
| Tipo | Define o formato do valor esperado. Veja a tabela de tipos abaixo. |
| Requerido | Quando ativo, o argumento é obrigatório — a execução não inicia sem ele. |
| Exibir na UI | (Somente entrada) Quando ativo, o argumento aparece no formulário gerado automaticamente para o usuário. |
Tipos de argumento
| Tipo | Ícone | Uso |
|---|---|---|
| Texto | Aa | Qualquer valor textual |
| Número | 123 | Valores numéricos inteiros ou decimais |
| Data | Calendário | Datas no formato ISO |
| Booleano | Chave | Verdadeiro ou falso |
| Arquivo | Clipe | Upload de arquivo pelo usuário |
| JSON | {} | Objeto JSON estruturado |
Adicionar um argumento
- Selecione a aba Argumentos de entrada ou Argumentos de saída.
- Clique em + Adicionar argumento.
- Um novo argumento é criado com nome padrão (
Argumento1,Argumento2...), tipo Texto e sem obrigatoriedade. - Clique no campo Nome para renomear.
- Clique no campo de descrição para detalhar o propósito do argumento.
- Ajuste o Tipo, Requerido e, se for entrada, o Exibir na UI.
As alterações são salvas automaticamente.
Remover argumentos
Selecione um ou mais argumentos marcando a caixa à esquerda de cada linha e clique em Remover selecionados. Uma confirmação será solicitada antes da exclusão.