Conversas
Seus agentes falam por três canais. É sempre o mesmo agente, com a mesma memória — muda só por onde a mensagem chega.
Chat do painel
Em Chat, escolha o agente na coluna da esquerda e escreva. É o caminho mais direto, e o que você vai usar para testar uma persona nova.
A coluna do meio lista as conversas daquele agente. Cada conversa é um contexto separado: começar uma Nova é útil quando você muda de assunto e não quer que o histórico anterior influencie a resposta.
As respostas chegam sozinhas, sem recarregar a página.
Telegram
Para colocar um agente no Telegram:
- Crie um bot no Telegram (falando com o
@BotFather) e copie o token. - Cadastre o token em Credenciais → Chat para interações.
- Na edição do agente, selecione esse bot como canal e reaplique.
Cada agente precisa do seu próprio bot. O Telegram não permite dois processos consultando o mesmo token ao mesmo tempo — se você reaproveitar um token, os dois agentes brigam pelas mensagens e nenhum funciona direito.
Você também controla quem pode falar com o bot: só as pessoas autorizadas nas credenciais recebem resposta. Um bot do Telegram é público por natureza — qualquer um que descubra o nome dele consegue mandar mensagem —, então essa lista é o que impede um estranho de conversar com o seu agente.
Widget no seu site
O widget embute o agente numa página sua, para os seus visitantes. Você ativa o canal na edição do agente e pega o link e o trecho de código em Agentes → ⋮ → Widget web.
Este link é de acesso aberto. Qualquer pessoa que tiver o link fala com o agente, na hora. Nenhuma senha, login ou qualquer outra identificação é solicitada. A Bia não restringe quem chega até ele — protegê-lo é responsabilidade de quem faz a integração: coloque-o atrás do seu próprio login, restrinja-o a páginas que já exigem um, ou publique-o apenas onde o acesso aberto é o que você quer. Trate-o como público: tudo o que esse agente pode fazer ou dizer, ele fará ou dirá para quem abrir o link.
Vale lembrar disso ao escrever a persona: o agente vai falar com pessoas que você não conhece, então diga na persona o que ele não deve discutir.
O que fica registrado
Toda conversa — de qualquer canal — aparece no histórico do agente, em Memória. É assim que você audita o que foi dito.
Se você preferir que a Bia não guarde o conteúdo das conversas, isso se desliga em Credenciais → Dados. Veja Credenciais e privacidade.
Quando o agente não responde
Quase sempre é uma destas três coisas:
- O servidor está offline. Confira em Servidores.
- O agente não está Pronto. Ele pode estar instalando, ou a instalação falhou.
- Os agentes estão pausados. Se você usou a parada de emergência, ela continua valendo até ser desligada — veja Parar agentes.
Se nenhuma dessas for o caso, veja Solução de problemas.
Próximos passos
- Memória e diretrizes — ler o histórico e corrigir o comportamento.
- Arquivos — o que foi enviado e gerado nas conversas.