Como configurar a etapa Assistente de IA?
Crie um agente que responde a perguntas livres com prompt de sistema, modelo, base de conhecimento, ferramentas e integrações; defina transferências e limites.
Para que serve?
A etapa “Assistente de IA” responde com IA às perguntas livres dos visitantes. A conversa fica nesta etapa; o agente usa sozinho a base de conhecimento, suas ferramentas e ações de integração quando necessário e leva o fluxo para outra etapa no momento certo (por exemplo, uma etapa Solicitação).
A conversa também pode ser concluída nesta etapa: quando o visitante diz que terminou, ou 30 minutos depois da última mensagem, se ele escreveu pelo menos uma vez.
A etapa fica na categoria “IA” da paleta. Seu painel tem as abas “Conteúdo”, “Ferramentas”, “Integrações”, “Conhecimento” e “Rastreamento”.
Prompt de sistema e modelo
- Escreva a primeira frase do agente em “Texto na tela” (por exemplo, “Pergunte o que quiser saber.”).
- Em “Prompt de sistema”, descreva quem é o agente, quais assuntos conhece e como deve responder. Se estiver vazio, o agente não consegue responder. Veja Como escrever um prompt de sistema eficaz?
- Se quiser, escolha outro modelo na lista “Modelo”. A lista tem seis famílias de modelos; “Qual devo escolher?” faz algumas perguntas e sugere um modelo adequado. O uso de créditos varia muito de modelo para modelo. “Provedor padrão” usa o modelo Claude padrão. A escolha vale só para esta etapa.
Se o modelo escolhido retornar um erro, a etapa muda uma vez para o modelo de reserva do mesmo fornecedor. Tempos esgotados e limites de taxa não são repetidos.
Conhecimento, ferramentas e integrações
O agente trata essas três fontes por igual e escolhe qual consultar em cada pergunta. Ele não inventa o que nenhuma delas tem; diz que não sabe.
- Aba “Conhecimento”: “Desativado”, “Todas as entradas” (entradas compartilhadas e deste agente, incluindo as adicionadas depois), “Só as entradas deste agente” ou “Entradas que eu escolher” (só as que você ativar; as novas começam desativadas). Veja Base de conhecimento.
- Aba “Ferramentas”: ative uma a uma as ferramentas que o agente pode chamar ou escolha “Todas as ferramentas” (as adicionadas depois também são ativadas). A descrição de cada ferramenta diz ao agente para quais perguntas ela serve.
- “Pode receber tickets” (no topo da aba Ferramentas, ativado por padrão): se um visitante quiser deixar uma solicitação ou passar algo para sua equipe, o agente pede os contatos dele e abre o ticket sozinho; ele aparece na tela Solicitações. Se a mesma pessoa acrescentar informações em até uma hora, nenhum novo ticket é aberto; a informação é adicionada ao ticket aberto e, se o ticket foi enviado à sua central de ajuda, é adicionada lá como nota interna (o cliente não a recebe). Se a etapa leva a uma etapa de ticket, os tickets são recebidos ali. No máximo 5 tickets por hora são recebidos de um visitante. Se você desativar, o agente diz que não pode receber solicitações e não promete nada.
- Aba “Integrações”: ativar uma integração abre uma janela onde você escolhe as ações dela; o agente usa só as escolhidas. A chave “Todas as ações” da janela ativa todas as ações, inclusive as que excluem ou enviam. Use “Configurar” para fixar campos: um campo preenchido fica fixo e não é perguntado ao visitante, e um campo vazio (“Deixar a IA preencher”) é preenchido pela conversa. Uma {variable} dentro de um valor fixo não é substituída; o valor vai como você escreveu. Escolha aqui lugares como quadro, lista ou canal.
Integrações não conectadas aparecem em “Não conectada” com o link “Conectar”; o agente só pode usá-las depois de conectadas.
Transferências
Na seção “Transferências”, use “Adicionar transferência” para adicionar as etapas para onde o agente pode levar o fluxo e, em cada uma, responda a “Quando a IA deve passar para esta etapa?”.
Em uma transferência para uma etapa Solicitação, uma caixa vazia usa a regra padrão: o agente passa para a etapa Solicitação quando o visitante quer deixar uma solicitação ou reclamação, quer ser contatado ou concorda em passar a pergunta adiante quando não há resposta. Nas outras etapas, o editor avisa se nenhuma descrição for escrita.
“Dados a coletar”: em uma transferência, use “Coletar dados primeiro” para adicionar os dados que a IA deve obter do visitante antes de passar para aquela etapa (por exemplo, uma data, o número de pessoas ou um e-mail). Eles são configurados como campos de formulário: “Nome do campo”, “Nome da variável”, “Tipo de campo”, “Obrigatório” e “Regra de validação”. A IA só passa para a etapa quando esses dados estão completos; se um faltar ou não seguir a regra, ela pergunta de novo. Os dados podem ser usados nas etapas seguintes como {variable}, e uma etapa “Resumo e confirmação” posterior os mostra e deixa o visitante corrigi-los.
Segurança e limites
As ações ativadas são chamadas por uma IA que fala com seus visitantes: ela pode dizer ao visitante o que lê, e o que ela exclui ou envia não pode ser desfeito. Essas ações têm os selos “Exclui” e “Envia mensagens” na lista. No agente, elas não precisam de confirmação extra; só levam o selo.
O agente recusa tarefas gerais que não têm relação com seu negócio (como escrever código ou fazer lição de casa).
Para evitar abusos, um espaço de trabalho pode fazer no máximo 20 exclusões e 100 envios de mensagens (como e-mails) por hora; as etapas Ação de integração dos seus agentes compartilham o mesmo limite. Ativar muitas ações pode deixar as respostas mais lentas, então ative só as realmente necessárias.
Artigos relacionados
- Como escrever um prompt de sistema eficaz?Escreva o prompt de sistema da etapa Assistente de IA de forma curta, clara e em seções; saiba o que vai no prompt e o que vai na base de conhecimento e nas transferências.
- Adicionar e editar entradas da base de conhecimentoAdicione os textos, páginas da web, arquivos e imagens com os quais seu agente responde, filtre e exclua entradas.
- Ferramentas: conectar o agente aos seus próprios sistemasAdicione seus próprios endpoints HTTPS que o agente chama durante uma conversa para buscar dados ao vivo ou executar uma ação.
- Como as integrações funcionam?Conecte sua loja, canais de mensagens e ferramentas de trabalho à Agenola para que seus agentes possam trabalhar com eles.
- Como configurar as etapas Ação de integração e Chamada de ferramenta?Faça um trabalho em uma integração conectada ou chame sua própria ferramenta em um ponto do agente: saídas, ramo de falha e novas tentativas.