Leitura de 10 minutos Atualizada: 06/11/2025 Criado pela: Equipe Botmaker

Boas práticas de Agentes de IA na Plataforma Botmaker

Descubra os principais componentes e as melhores práticas para otimizar a experiência com inteligência artificial dentro da plataforma Botmaker.



Agentes de IA

O que são e quando usá-los?


Os Agentes de IA são ideais para tarefas complexas que exigem ações específicas, como coletar dados de usuários ou interagir com sistemas externos.


Casos de uso recomendados:

  • Coleta estruturada de informações (nome, e-mail, CPF etc.).
  • Realização de integrações com APIs externas, consultas, validações e outras ações.
  • Processos como cadastro de usuários, autenticações e consultas personalizadas.


Funcionamento: O Agente de IA atua de forma autônoma para executar tarefas específicas, sendo integrado ao fluxo principal apenas após concluir sua atividade. Isso garante modularidade e máxima eficiência.


Casos de uso não recomendados:

  • Processos de negociação complexa ou resolução de conflitos.
  • Conversas longas e abertas, sem um objetivo claro e bem definido.
  • Suporte avançado em situações delicadas ou de contenção emocional.
  • Operações críticas ou de alto risco, como simulação de empréstimos, manipulação de dados financeiros sensíveis ou ações com possíveis consequências legais ou economicas relevantes, já que há margem de erro ou desvio nas respostas da IA.



O que significa delegar tarefas a um Agente de IA?


Ao utilizar Agentes de IA em um fluxo conversacional, é importante entender que parte do controle sobre as respostas do sistema está sendo delegada. Diferente dos bots tradicionais, que seguem regras fixas e respostas pré-definidas, a IA generativa interpreta as informações disponíveis e gera respostas próprias, inclusive diante de perguntas pouco específicas ou que não estejam diretamente contempladas na base de conhecimento.

Isso significa que:

  • Nem sempre haverá total certeza sobre a resposta exata que o agente irá gerar.
  • Se as informações da base não forem claras, suficientes ou estiverem desatualizadas, a IA pode tentar preencher essas lacunas, gerando respostas que podem divergir do esperado ou desejado.
  • Existe uma margem de variabilidade natural na forma como a IA responde, mesmo quando está corretamente configurada.

Por isso, é fundamental manter a base de conhecimento sempre atualizada, clara e o mais completa possível  e considerar esse grau de autonomia ao desenhar processos críticos ou situações em que a precisão e o controle são essenciais.




Identidade do Bot

Definir a identidade do bot é essencial para que a Inteligência Artificial compreenda o contexto geral do chatbot. O que isso significa?

  • Certifique-se de incluir informações relevantes sobre o bot.
    Ajuste o tom de voz de acordo com o propósito e o público-alvo do projeto.
    Garanta que a comunicação seja coerente e alinhada aos objetivos do seu negócio.


Exemplo prático:

Instrução:

Você é um bot de uma escola de idiomas, especializado em fornecer informações sobre cursos de português, inglês, francês e alemão. Mantenha um tom amigável, claro e prestativo. Seu objetivo é orientar o usuário e responder às suas dúvidas de forma eficiente e respeitosa, sempre utilizando uma linguagem simples e positiva. Conduza a conversa passo a passo, garantindo que a experiência seja organizada, informativa e agradável para quem busca informações sobre os cursos.


Instruções

As instruções definem o comportamento da IA. Elas devem ser claras, diretas e alinhadas com o objetivo da tarefa. Indique quais dados devem ser solicitados, especifique como as respostas devem ser apresentadas e estabeleça as restrições necessárias.

Exemplo prático

Instrução:

#OBJETIVO

Seu objetivo é ajudar o usuário a reservar um curso de idiomas oferecido por nossa empresa. Você deve guiá-lo de forma clara, organizada e gentil para coletar todas as informações necessárias e confirmar sua inscrição no curso desejado.

#PASSO A PASSO A SEGUIR

1 - Solicite o nome e sobrenome do usuário e salve em ${nomeCompleto}

2 - Solicite o CPF e salve em ${cpfCurso}

3 - Solicite o e-mail e salve em ${emailCurso}

4 - Pergunte qual curso ele deseja fazer e salve em ${cursoEscolhido}

5 - Mostre uma lista com todos os dados coletados e peça confirmação para finalizar. O usuário pode alterar os dados e deve confirmar novamente.

6 - Aguarde o envio da confirmação. Após a resposta positiva, armazene as informações usando a ação de criação de registro no Google Sheets. Agradeça ao usuário pela informação, avise que em breve ele será contatado por e-mail e despeça-se.

#REGRAS

  • O tom deve ser amigável.
  • Incluir apenas um emoji por resposta.
  • Cada resposta deve ter no máximo 25 palavras.
  • Aceite apenas respostas relacionadas à coleta de dados e cursos de idiomas.

Para conhecer mais boas práticas na criação de instruções, acesse este artigo:#REGRAS

  • O tom deve ser amigável.
  • Incluir apenas um emoji por resposta.
  • Cada resposta deve ter no máximo 25 palavras.
  • Aceite apenas respostas relacionadas à coleta de dados e cursos de idiomas.

Para conhecer mais boas práticas na criação de instruções, acesse o seguinte artigo: https://help.botmaker.com/es/help/6634855130683497129



Lenguagem natural com instrução generativa


Expande a capacidade do bot para identificar intenções complexas, interpretando o contexto completo da mensagem — e não apenas palavras soltas.


Exemplo:

Configure seu modelo de Linguagem Natural para entender não apenas termos como “produtos” ou “empresa”, mas também o contexto de perguntas como:

  • “Quantos produtos a empresa oferece?”
  • “Há quanto tempo vocês estão no mercado?”




Perguntas Frequentes


Qual a diferença entre um Agente de IA e a Resposta Generativa?
O Agente de IA executa tarefas ou completa fluxos coletando dados, enquanto a Resposta Generativa apresenta informações existentes de forma clara e compreensível.

Para mais informações, recomendamos este artigo: https://help.botmaker.com/pt/help/8783707342642706995


A base de conteúdo deve ser atualizada manualmente? Sim, sempre que atualizar um documento, você deverá enviar a nova versão.


O que fazer se a IA não encontrar informação na base de conteúdo?A IA generativa tentará criar respostas, mas elas podem não estar alinhadas com as expectativas caso o conteúdo não esteja claro ou disponível.



Lembre-se de visitar nossa Central de Ajuda para obter mais informações.