Agentes
A funcionalidade Agents é a área central para criação e gerenciamento das capacidades de inteligência artificial dentro do sistema. Ela permite construir chat agents, estruturas de RAG (Retrieval-Augmented Generation) e tools que expandem o que os agentes podem saber e fazer.
O principal objetivo desta seção é permitir que você projete o comportamento, o conhecimento e as ações dos agentes de forma estruturada, reutilizável e escalável.
Ao acessar Agents, você verá:
Uma barra lateral esquerda listando todos os agentes criados
Um campo de busca para localizar agentes rapidamente
Abas superiores para alternar entre:
Agents
Tools
RAG
Um botão ( + ) para criar novos recursos
Como Configurar seu Agent
Acessando a Área Agents
No menu lateral esquerdo, clique no ícone Agents
Você será direcionado para a tela de criação e gerenciamento de agentes
Essa tela funciona como um painel central onde você pode:
Criar novos agentes
Editar agentes existentes
Gerenciar tools e bases de conhecimento
Definir como cada agente se comporta dentro do sistema
Criando um Novo Recurso
Clique no botão ( + ) no topo da tela.
Selecione uma das opções disponíveis:
New chat agent: Criar um agente conversacional com personalidade, objetivos e regras definidas
New RAG: Criar uma base de conhecimento contextual para recuperação de informação
New tool: Criar uma ferramenta que execute ações ou integrações
Como Criar um Novo RAG (Retrieval-Augmented Generation)
Antes de tudo, um RAG é uma camada de conhecimento que permite aos agentes recuperar informações de documentos e arquivos e utilizar esse conteúdo para gerar respostas mais precisas, contextuais e confiáveis.
Em vez de depender apenas do conhecimento geral do modelo, o RAG permite que o agente baseie suas respostas nos seus próprios dados.
O RAG foi projetado para:
Fornecer respostas baseadas em fatos usando documentos internos
Reduzir alucinações ao fundamentar respostas em conteúdo real
Permitir que agentes trabalhem com:
Arquivos CSV
Documentos de texto (PDF, .doc, .txt, .md, .pptx, etc.)
Dados estruturados e semi-estruturados (.json, .png, .jpg, .mp3, .mp4, etc.)
Um RAG não atua sozinho. Ele deve ser anexado a um Chat Agent para ser utilizado em conversas.
Estrutura da Tela de Configuração do RAG
A tela é dividida em duas áreas principais:
Painel esquerdo → Definição e comportamento do RAG
Painel direito → Seleção e gerenciamento de arquivos
Após abrir o painel:
Insira um nome claro e descritivo para o RAG
Descreva o tipo de informação fornecida
Você pode:
Utilizar o campo de busca para filtrar arquivos pelo nome
Selecionar um ou mais arquivos da lista
Após a seleção, o conteúdo desses arquivos se torna pesquisável pelo agente.
Para importar arquivos, consulte a seção Files Ingest neste documento.
Como configurar novas ferramentas
As Ferramentas definem quais ações um agente pode executar além da conversa.
Elas expandem as capacidades do agente, permitindo:
Integrações externas
Acesso seguro a dados
Execução controlada de queries
Manipulação de mídia
Um agente só pode utilizar tools que foram explicitamente criadas e atribuídas a ele. Isso garante segurança, previsibilidade e governança.
Na tela de Ferramentas, você pode criar e gerenciar os seguintes tipos de ferramentas:
HTTP Request
Chamar APIs e serviços externos
MCP
Conectar-se a APIs e serviços baseados em MCP
Verified Queries
Executar consultas SQL pré-aprovadas com segurança
Media File
Selecionar e recuperar arquivos de mídia
Cada tipo de ferramenta é projetado para uma classe específica de ação e possui seu próprio modelo de configuração.
Criando uma Nova Ferramenta
Acesse a seção Tools
Clique no card do tipo de ferramenta desejado
Configure os parâmetros da ferramenta
Clique em Save para salvar a configuração
HTTP Request
Permite que o agente interaja com APIs externas utilizando métodos HTTP padrão.
Casos de uso:
Buscar dados de serviços terceiros
Enviar dados para sistemas externos
Disparar webhooks ou workflows
Características:
Suporte a APIs REST
Parâmetros definidos explicitamente
O agente só pode chamar endpoints previamente configurados
MCP
Permite integração com APIs compatíveis com MCP.
Casos de uso:
Acessar serviços internos ou de parceiros expostos via MCP
Interações padronizadas com APIs
Acesso controlado a sistemas corporativos
Características:
Acesso estruturado e controlado
Projetado para integrações empresariais
Reutilizável entre múltiplos agentes
Verified Queries
Permite que agentes executem consultas SQL previamente aprovadas.
Objetivo:
Evitar execução arbitrária de queries
Garantir governança de dados
Assegurar performance e segurança
Funcionamento:
Queries são definidas e validadas previamente
Apenas essas queries podem ser executadas
Agentes podem passar parâmetros, mas não alterar a lógica
Agentes não podem escrever ou modificar SQL. Apenas executar queries verificadas.
Media Files
Permite que o agente acesse, referencie e entregue arquivos durante uma conversa.
Uso ideal:
Compartilhar documentos
Referenciar materiais oficiais
Fornecer downloads controlados
Enriquecer respostas com conteúdo visual ou técnico
Como Criar seu Agent
Após criar as Tools e os RAGs, o desenvolvedor pode montar um Chat Agent.
Essa etapa define:
Quem é o agente
Como ele se comporta
O que ele pode acessar
Um Chat Agent funciona como camada de orquestração, combinando:
Identidade e propósito
Regras comportamentais
Fontes de conhecimento (RAG ou tabelas)
Diagramas (relacionamentos entre tabelas)
Capacidades de ação (Tools)
Na aba General, você pode:
Definir um nome claro e significativo
Escrever uma descrição resumida do agente
Definir identidade, tom, capacidades e limites
Descrever o objetivo principal e critérios de sucesso
Fornecer contexto, restrições e background do domínio
Inserir perguntas exemplo para orientar o usuário final
Após definir a identidade do agente, configure o que ele poderá acessar.
Para configurações de Discovery, consulte a seção correspondente.
Para criação de Schema, consulte a seção específica deste documento.
Atualizado