Agentes de IA

Um agente é uma pessoa artificial do seu time: tem um nome, instruções de como se comportar, um modelo que pensa por ele e um conjunto de competências que dizem o que ele sabe fazer. Você conversa com ele pela tela, ou o aciona dentro de um fluxo pelo nó Executar agente de IA.

A tela fica em Agentes de IA, no menu. Se ela não aparecer para você, peça a quem administra a sua organização.

Não confunda com Agentes locais, no mesmo menu: aqueles consultam bancos dentro da sua rede e não têm nada a ver com IA. Veja Agente local.

Três níveis: agente, competência, ferramenta

• O agente é quem responde: instruções, modelo e limites.
• A competência (skill) reúne instruções e ferramentas em torno de um assunto — Cobrança, Matrícula — e serve a vários agentes ao mesmo tempo. Ajuste uma vez, todos passam a seguir.
• A ferramenta é o que o agente consegue acionar. A mais usada é do tipo fluxo: um fluxo daqui mesmo que ganhou o gatilho Ferramenta de IA (veja Gatilhos) e passou a se oferecer aos agentes. Assim, tudo o que você já sabe montar num fluxo vira habilidade de um agente.

Criando um agente

1. Em Agentes de IA, clique em + Novo agente.
2. Dê um nome (ex.: Atendimento) e escreva para que serve.
3. Na tela do agente, preencha as três abas abaixo e salve.

Aba Instruções

• Credencial de IA — qual acesso ao modelo usar. Cadastre em Credenciais, no tipo Modelo de linguagem (IA).
• Modelo — escolha na lista ou digite. Vazio usa o modelo da credencial. A lista aparece depois que a credencial tiver sido testada em Credenciais; se você digitar um modelo que não está lá, ele é salvo do mesmo jeito.
• Diga quem o agente é e como deve responder — as instruções. Curto funciona melhor que longo: o detalhe de cada tarefa mora na competência, não aqui.
• Temperatura — perto de 0 ele responde sempre igual; acima de 1 varia mais.
• Máximo de idas e voltas — quantas vezes ele pode acionar ferramentas antes de ter de responder.

Aba Skills

Lista as competências deste agente, na ordem em que entram nas instruções. Use + Adicionar skill para incluir uma, e o menu de ações de cada linha para Subir, Descer ou Remover.

Competência marcada como Pausada está ligada ao agente mas não entra no que ele sabe fazer — clique no aviso para abri-la e voltar a usá-la.

Aba Limites

• Memória da conversa — Não lembra do que foi dito ou Lembra das últimas mensagens.
• Quantas mensagens ele lembra — vale quando a memória está ligada. Quanto mais mensagens, mais cara fica cada resposta.

Nesta aba você também registra o teto de gasto por mês e se o agente deve pedir aprovação antes de agir. Os dois campos guardam a sua intenção, mas ainda não travam nada: o gasto continua correndo e as ferramentas rodam sem confirmação. Para acompanhar o custo de verdade, use o painel de consumo e o histórico de chamadas — e combine com a LBHM antes de soltar um agente que gaste sem alguém olhando.

Conversar com o agente

No menu de ações do agente (na lista ou na tela dele), use Conversar com o agente. É onde você confere se as instruções e as competências estão do jeito certo antes de pôr o agente num fluxo.

A resposta vai aparecendo enquanto ele trabalha, e cada ferramenta acionada aparece na conversa — com o que foi perguntado e o que voltou. É essa trilha que permite corrigir a descrição de uma ferramenta quando a resposta vem errada: sem ela, sobra adivinhar.

As conversas ficam guardadas: a lista à esquerda (no celular, um seletor no topo) traz as anteriores, para retomar de onde parou ou reler o que aconteceu. Use + Nova para começar outra.

Duas coisas que você pode encontrar aqui:

• Este agente está pausado — volte a usá-lo pelo menu de ações para conversar.
• Há muitas conversas acontecendo agora — há um limite de conversas simultâneas na sua organização, para que uma rodada de perguntas não segure a plataforma inteira. Tente de novo em um minuto.

Montar um agente com IA

Na lista, o botão ✨ Montar com IA abre um assistente: descreva o problema em português — "um agente para o pessoal da secretaria tirar dúvidas de matrícula e saber se o aluno está em dia" — e ele monta o conjunto, conferindo antes o que já existe para reaproveitar em vez de duplicar.

A cada resposta você vê, em uma linha, o que ele fez: conferiu as competências que já existem, criou uma competência, anexou uma ferramenta, criou o agente.

Tudo o que sai dali nasce pausado. É rascunho: abra o que foi criado, ajuste as instruções e as ferramentas e só então volte a usá-lo. O botão só aparece quando a IA está habilitada na sua organização.

Pausar e excluir

No menu de ações, Pausar tira o agente de circulação sem apagar nada — inclusive as conversas. Excluir é definitivo: os fluxos que acionam esse agente param de funcionar e o histórico de conversas vai junto. A tela pede confirmação antes.

Para dar habilidades ao agente, veja Skills. Para acioná-lo dentro de um fluxo, veja Inteligência artificial.