--- title: "Como integrar Inteligência Artificial no meu bot" slug: "como-integrar-inteligência-artificial-no-meu-bot" updated: 2025-05-26T14:13:10Z published: 2025-05-26T14:13:10Z canonical: "help.hiplatform.com/como-integrar-inteligência-artificial-no-meu-bot" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.hiplatform.com/llms.txt > Use this file to discover all available pages before exploring further. # Como integrar Inteligência Artificial no meu bot ## Sobre a função: A funcionalidade de **base de conhecimento com IA Generativa** permite que o Hi Bot utilize dados proprietários da sua empresa para gerar respostas automáticas e personalizadas por meio de Inteligência Artificial Generativa. Essa ferramenta otimiza o atendimento ao cliente, proporcionando respostas assertivas e contextualizadas, com suporte para fluxos de atendimento de SAC, vendas ou marketing, diminuindo a necessidade de intervenção humana. #### Características principais A base de conhecimento integra a tecnologia de *Retrieval-Augmented Generation* (RAG), combinando dados da base de conhecimento da empresa com o processamento da IA. Entenda: **RAG (Retrieval-Augmented Generation)**: Utiliza uma base de conhecimento externa à IA para gerar respostas mais precisas. **Embeddings**: Técnica de processamento de linguagem natural que transforma palavras em números para melhorar a compreensão da IA. Esse recurso requer contratação Para integrar a base de conhecimento no fluxo do seu assistente virtual, é necessária contratação. Consulte as condições com o seu Gerente de Contas ou, caso não seja um cliente Hi, [fale com um de nossos especialistas](https://api.whatsapp.com/send/?phone=5511971402140&text=Estava+navegando+no+site+da+Hi+e+quero+saber+mais&type=phone_number&app_absent=0). ## Veja como fazer Para configurar sua base de conhecimento, primeiro, acesse a [Central Administrativa](https://horus.hiplatform.com/). Vá até o departamento onde o fluxo do bot está localizado. Clique em **Configurações** > **Geral** > **Inteligência Artificial** > **Base de Conhecimento**: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-KG5SBZX3.png) Adicione uma nova base de conhecimento: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-YU9P0WOR.png) Clique no botão azul à direita da tela para adicionar uma nova base. Selecione a opção Documento para fazer upload do arquivo CSV: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-U1T57RRU.png) --- #### Configuração do arquivo CSV O arquivo CSV deve conter as colunas **Title**, **Answer** e **Categories**. Lembre-se de revisar o conteúdo, ajustar desvios ortográficos, excluir conteúdos duplicados, antigos ou diferentes das regras de negócio da sua empresa antes de subir a planilha: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-4J4L7IC2.png) --- Nomeie a base de conhecimento (dê um nome que facilite o gerenciamento do conteúdo da base) e faça upload do arquivo: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-E3IN99W5.png) --- ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-WOA2RAPX.png) --- Após subir o arquivo, o status será exibido como **Processando**, como mostra a imagem abaixo: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-VXJWVARJ.png) --- Aguarde até que mude para **Disponível** para utilizá-lo. ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-W1KY39MG.png) --- Importante Use a funcionalidade de **Combinação de conteúdos** para tornar suas respostas mais completas. Entenda: Com a **Combinação de conteúdos**, sempre que o consumidor fizer uma pergunta, a IA pode consultar mais de um conteúdo da sua base para construir uma resposta mais rica. Essa seleção acontece em tempo real e leva em conta o grau de semelhança entre as palavras da pergunta e os conteúdos disponíveis (quanto maior a semelhança, maior a prioridade na escolha), combine até 5 conteúdos simultaneamente: ![2025-05-26_11h07_10.gif](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/2025-05-26_11h07_10.gif) --- #### Gerenciamento da base Caso haja necessidade de renomear a base ou visualizar exemplos, utilize o campo **Ações**, como indicado a seguir: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-RSUY7P6D.png) --- Se você precisar atualizar o conteúdo da base: - Faça o download do arquivo existente, edite-o com as novas informações ou ajustes necessários; - Feito isso, suba o arquivo atualizado na plataforma; - Aguarde o status "Processando" ser alterado para "Disponível" antes de utilizá-lo. ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-KUF91P2Y.png) Fique de olho nesses comportamentos: **i.** Ao importar um arquivo duplicado, o status ficará como "**Conteúdo duplicado"**. Nesse caso, deve ser feita uma verificação para que a nova base seja liberada. Veja: ![conteúdo-duplicado-base-de-conhecimento.gif](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/conte%C3%BAdo-duplicado-base-de-conhecimento.gif) **ii.** Caso você faça upload de um arquivo com conteúdos que já foram importados anteriormente, apenas o conteúdo novo será inserido na base. Por exemplo, imagine que a planilha a seguir possui conteúdos que já foram importados, porém, apenas a linha destacada é uma nova informação: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-DBJOFI8O.png) Quando você fizer upload novamente, apenas o novo conteúdo destacado vai ser adicionado. Tenha atenção com esse comportamento para evitar a perda de conteúdos já existentes. Recomenda-se que seja feito um novo upload com um nome diferente sempre que você precisar inserir novas informações. **iii.** Garanta que suas bases de conhecimento tenham nomes diferentes para evitar instabilidade nos conteúdos. ## Integração com o fluxo do bot Adicione um **Bloco de pergunta**, antes de inserir sua base de conhecimento. Assim, você poderá armazenar a resposta do consumidor em uma varável e, por meio da variável de registro, analisar a interação do seu público com o bot: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-1FMFBN5J.png) --- Para adicionar a base de conhecimento clique em "Adicionar ação" > Inteligência Artificial > Assistente de IA > Base de conhecimento: ![2024-10-14_11h43_24 online-video-cutter.com 1.gif](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/2024-10-14_11h43_24%20%28online-video-cutter.com%29%20%281%29.gif) Escolha a opção "base de conhecimento" e insira a(s) base(s) importada para que a IA para utilizá-la nas respostas: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-RLY5QQ72.png) Entenda como funciona a fonte de consulta externa ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-HX5WGQ7Z.png) Ao escolher a opção "**Externa**", você segue diretamente às configurações a seguir, fazendo as configurações diretamente do assistente de IA. Essa opção não terá referências sobre o seu negócio, diferentemente da base de conhecimento. #### Configure o seu assistente Siga o passo a passo: - **Tom de voz (opcional)**: Selecione uma das opções disponíveis (amigável, casual, persuasivo, profissional ou objetivo) pensando no relacionamento com o seu consumidor. Nesse caso, a curadoria irá apresentar a melhor sugestão para a sua empresa: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-R7D9OHM1.png) --- - **Descrição adicional (opcional)**: Caso queira que o tom de voz da IA tenha um tom de voz ainda mais específico, descreva suas intenções no campo indicado (e inclua - ou não - emojis): ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-UVCPCZZC.png) --- - Explique, de forma breve, como a IA irá atuar para que ela entenda o seu objetivo: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-QHXDB7SN.png) "Context" é o termo que se refere à base de conhecimento da assistente (IA), que inclui informações fornecidas ao longo das interações. No campo de "Instrução para a assistente", você pode usar esse termo para que ela acesse e utilize dados relevantes já mencionados, otimizando as respostas. --- - **Exemplos (opcional)**: Adicione exemplos para ampliar as chances de assertividade do seu bot, detalhando uma mensagem hipotética na qual você acredita que seu consumidor vai enviar como pergunta, e uma resposta ideal que a IA deve fornecer: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-WKJ9FHPZ.png) --- - **Entrada do usuário**: Identifique a mensagem do consumidor a ser respondida pela assistente a partir de uma variável ou um texto contendo uma mensagem esperada dele. ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-LYSIHPF8.png) --- - **Temperatura**: A régua de temperatura controla o nível de aleatoriedade nas interações do ChatGPT. Por padrão, a configuração tem o valor 0.7, mas, para produzir respostas mais precisas e repetitivas, utilize valores próximos a 0, para respostas mais criativas e inesperadas, utilize valores próximos a **2**: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-DIXXGSPD.png) --- - **Variável para salvar o retorno**: Insira uma variável para armazenar a resposta da IA: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-G61MOVYF.png) Adicione variável responsável em armazenar a resposta da IA dentro de um bloco de texto (a mesma que você indicou no campo **Variável para salvar o retorno**). Visualize a base de conhecimento dentro do fluxo: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-W5Q9YYYP.png) --- Agora, a visão do consumidor final: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-691Z02FW.png) ## Bloco extração de variáveis Você percebeu que a resposta dada pela IA veio um pouco "estranha"? Essa resposta é o retorno contém informações que podem ser importantes em decisores, por exemplo. Entretanto, para o seu consumidor, o que vale mesmo é apenas resposta. Então, para que ele a receba sem as informações retornadas como o Title, \n\n, Categories etc., você precisa usar o bloco de extração de variáveis. **Veja como fazer**: --- Adicione o bloco **Extração de variáveis**: ![2024-10-15_11h40_30-_online-video-cutter.com_.gif](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/2024-10-15_11h40_30-_online-video-cutter.com_.gif) --- Selecione a variável que armazena as respostas da IA (a mesma do bloco texto anterior): ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-PYYG50AA.png) Em **Tratamento de varável**, insira as informações conforme indicado: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-C75CQF9L.png) --- - Copie e cole a resposta anteriormente enviada pela IA: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-YJHTSHGR.png) --- - Em **Identificação do seletor**, escreva `$.Completion` e, em seguida, clique em **Testar seletor**: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-NXHC1CQ2.png) --- - Crie uma variável que irá armazenar a resposta da IA após esse tratamento. Feito isso, clique em **Atualizar variável** e > **Finalizar**: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-UKMJU45R.png) --- Para finalizar, adicione um **Bloco de texto** com a variável que armazena a resposta com o tratamento feito pelo bloco extração de variáveis: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-NOVECR6E.png) --- Agora sim! Veja a visão final do consumidor após o tratamento com feito pelo bloco extração de variáveis: ![image.png](https://cdn.document360.io/fbdc20e9-fffd-4203-8df2-642bdec311ea/Images/Documentation/image-881E5BD0.png) ---