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?”

Base de conteúdos

Permite um carregamento mais rápido e respostas mais precisas do bot, utilizando as bases disponíveis. A atualização se aplica tanto ao Bot Designer com Agentes de IA quanto a qualquer versão da Botmaker.

A qualidade e a estrutura das informações impactam diretamente na precisão das respostas da IA. Mantenha a base sempre clara, atualizada e bem organizada para garantir o melhor desempenho do bot.

Para saber mais e conhecer melhores práticas sobre a base de conteúdos, você pode ler o seguinte artigo: https://help.botmaker.com/pt/help/4174346223833880536

Recomendações gerais para base de conteúdos:

• Organize os arquivos por tema (ex: Manual_de_usuário.pdf, Produtos.xlsx.
• Priorize arquivos com texto (textos em imagens não são lidos pela IA).
• Para tabelas extensas ou listas estruturadas, use arquivos XLS/XLSX com cabeçalhos claros.
• Para documentos, prefira PDF/DOC/TXT com no máximo 150 páginas e evite blocos longos de texto.
• Textos dentro de imagens: a IA não os lê. Use sempre texto plano.
• Tabelas complexas: prefira XLS/XLSX; evite células mescladas ou fórmulas complexas.
• Sites web: a capacidade de leitura depende do desenvolvimento e organização interna (HTML, tags, acessibilidade etc.).

Formatos e estrutura recomendados:

• Título (Nível 1): obrigatório, identifica o tema.
• Subtítulo (Nível 2): opcional, adiciona detalhes.
• Conteúdo detalhado: use parágrafos curtos e bullets para melhor clareza visual.
• Divida o material por grandes temas: Manual de produto, Regras, Processos, FAQs.
• Utilize nomes descritivos e padronizados para os arquivos.

Exemplo prático:

Curso de Português

Curso voltado para quem deseja aprender português do zero ou aperfeiçoar habilidades para viagens, estudos ou trabalho.

Níveis disponíveis:

• Iniciante (A1-A2)
• Intermediário (B1-B2)
• Avançado (C1)
  

Modalidade:

• Presencial
• Online ao vivo (em grupo)
• Aulas particulares
  
  

Duração e frequência:

• Regular: 3 meses (2 aulas semanais, 90 minutos)
• Intensivo: 1 mês (3 aulas semanais)
  
  

Requisitos:

• Não é necessário conhecimento prévio (nível inicial)
• Teste de nivelamento disponível
  
  

Outros dados:

• Material digital incluso
• Certificado ao final do curso
• Vagas limitadas (máx. 8 pessoas por grupo)
  

Atualização da base de conteúdos: 

Manual: toda vez que atualizar um arquivo, será necessário carregá-lo novamente na plataforma.

O conteúdo atualizado estará disponível após encerrar a sessão de conversa atual.

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.