Editor
O Editor é a tela principal de configuração de um agente. Acesse-o clicando no ícone de lápis no card do agente ou navegando diretamente para o agente na página Agentes.
Layout
A tela é dividida em duas áreas:
- Esquerda — seções de configuração: Definições, Ações e Contexto.
- Direita — painel Playground, onde você pode testar o agente em tempo real.
O Playground sempre executa a versão de trabalho atual — não a versão ativa em produção. Alterações testadas no Playground só entram em produção depois de publicar e ativar uma nova versão. Consulte Versões para mais detalhes.
Navegação lateral
O menu lateral esquerdo dá acesso a todas as seções do agente:
| Ícone | Seção | O que faz |
|---|---|---|
| Robô | Agente | Abre o Editor (esta tela) |
| Variável | Argumentos | Define entradas e saídas do agente |
| Banco | Base de testes | Gerencia conjuntos de teste |
| Escudo | Guardrails | Configura filtros de segurança |
| Histórico | Execuções | Visualiza o histórico de runs |
| Versões | Versões | Publica e gerencia versões |
| Engrenagem | Configurações | Ajusta nome, modelo, integrações e mais |
Barra superior
| Botão | Ação |
|---|---|
| Executar (ícone play) | Abre menu com opções Base de testes (executa todos os conjuntos) e Simular API |
| Chat (ícone de mensagens) | Abre o chat p úblico do agente em uma nova tela |
| Compartilhar (ícone de compartilhamento) | Atalho para a aba Compartilhamento nas Configurações |
| Publicar | Abre o modal para publicar uma nova versão do agente |
Simular API
A opção Simular API (disponível no menu do botão Executar) abre um modal para testar o agente via chamada de API sem sair do Editor:
- Inputs — preencha os argumentos de entrada do agente
- Resposta — o resultado da execução aparece em formato JSON em tempo real
- Download — baixe uma coleção Postman pré-configurada para o agente (
agent-{id}.postman_collection.json)
A coleção Postman usa environment: 'production' e exige uma versão ativa para funcionar. Se nenhuma versão estiver ativa, o modal exibe um aviso.
Salvamento automático
As alterações feitas no Editor são salvas automaticamente. O status de salvamento aparece ao lado do nome do agente no topo da página:
- Salvando... — a alteração está sendo enviada.
- Salvo — a alteração foi salva com sucesso.
- Erro ao salvar — falha ao salvar; verifique a conexão e tente novamente.