Criar e configurar agentes
O agente é quem conversa. Uma solução pode ter vários; sem nenhum agente ativo, o chat não responde nada.
A lista de agentes
Seção intitulada “A lista de agentes”Abra a solução e clique em Agentes.
A lista pode ser vista em grade ou em árvore. A visualização em árvore mostra o agente principal, seus especialistas e os agentes ainda não vinculados — é a melhor forma de entender uma solução que você não construiu.
Criar o agente
Seção intitulada “Criar o agente”Clique em + Novo Agente e preencha o formulário.
| Campo | O que informar |
|---|---|
| Nome | Como o agente será identificado nas telas. |
| Descrição | Em que assunto este agente é bom. Quando a solução tem vários agentes, é por esta descrição que a MarIA decide qual deles responde. |
| Instruções | O comportamento do agente: idioma, tom, o que ele deve fazer e o que deve recusar. É o campo mais importante da tela. |
| Provedor Padrão | O provedor de IA usado pelo agente. |
| Modelo Padrão | O modelo dentro desse provedor. |
| Ativo | Agentes inativos nunca respondem. |
As abas do agente
Seção intitulada “As abas do agente”Depois de salvar, o agente abre com cinco abas.
Arquivos
Seção intitulada “Arquivos”Documentos de referência que o agente consulta para responder. Você envia os arquivos e acompanha o status de cada um. Os tipos e tamanhos aceitos são definidos nas configurações da solução, por provedor — se um envio for recusado, é essa regra que está agindo.
Especialistas
Seção intitulada “Especialistas”Sub-assistentes focados em um assunto, que o agente principal consulta quando a pergunta exige profundidade. Cada especialista tem nome, descrição, instruções e pode ter arquivos próprios. A descrição é o que orienta o agente principal a consultá-lo na hora certa.
Ferramentas
Seção intitulada “Ferramentas”O que o agente consegue fazer além de conversar.
| Tipo | O que faz |
|---|---|
| API Externa | Chama um endpoint de outro sistema e usa a resposta |
| Sub Agente | Delega parte do trabalho a outro agente |
| Cards | Exibe conteúdo formatado dentro (ou fora) da janela do chat |
| Formulários | Coleta dados estruturados durante a conversa |
| Mapa | Mostra e permite interagir com pontos no mapa |
| Pesquisa na web | Busca informação atual, com as fontes citadas |
| Geração de imagem | Cria imagens a partir da conversa |
Toda ferramenta tem uma descrição para a IA. Escreva-a como uma instrução de quando usar aquela ferramenta — é o que determina se o agente vai acioná-la na hora certa.
Conecta o agente aos servidores externos de ferramentas cadastrados na solução e permite escolher quais dessas ferramentas ele pode usar.
Memória
Seção intitulada “Memória”Define o que o agente guarda entre conversas e com qual permissão — só leitura ou também escrita.
Vários agentes na mesma solução
Seção intitulada “Vários agentes na mesma solução”Quando a solução tem mais de um agente ativo, a MarIA escolhe qual responde a cada mensagem, com base nas descrições. Por isso, mantenha as descrições precisas e sem sobreposição: dois agentes descritos de forma parecida disputam as mesmas perguntas e o resultado fica imprevisível.
Depois de configurar, abra o chat e teste.