- Informações Gerais
- Contextos de Chatbots
- Treinamento de Chatbots
- Recursos Adicionais
- API – Autenticação Remota
- API – Conversas com Chatbots
Incorporações de conteúdos em chatbots
As Incorporações de conteúdos, também chamados de Embeddings, que permitem criar uma base de conhecimentos que pode ser consultada pela IA durante as conversas. Na prática, elas permitem que a IA acesse conteúdos específicos, quando eles forem relevantes para responder à pergunta do usuário.
Isso ajuda o chatbot a responder com mais precisão usando, por exemplo, informações da sua empresa, seus procedimentos, manuais, etc..
Ao usar Incorporações, você também consegue manter as instruções (prompt) do chatbot mais enxutas. Em vez de colocar todas as informações diretamente nas instruções, você deixa as regras principais nelas e cadastra os demais conteúdos nas Incorporações. Assim, durante uma conversa, somente os trechos relacionados ao assunto em questão serão incorporados, o que melhora a eficiência e reduzir o gasto com tokens.
Diferente de uma busca simples por palavra-chave, esse processo procura conteúdos com significado semelhante ao da pergunta feita pelo usuário. Em outras palavras, a IA não tenta localizar apenas palavras iguais, mas sim trechos que façam sentido dentro do mesmo tema. Por isso, a IA pode encontrar uma incorporação relevante mesmo sem buscar exatamente os mesmos termos usados pelo usuário.
Em termos práticos: as Incorporações funcionam como uma camada de conhecimento complementar para o chatbot!
Como funciona o uso das Incorporações?
De forma simplificada, o fluxo funciona assim:
- Você adiciona uma incorporação.
- A IA processa o conteúdo para que possa localizá-lo em consultas futuras.
- Quando um usuário faz uma pergunta, o sistema analisa o assunto da mensagem.
- Se encontrar conteúdos relacionados, as respectivas incorporações são às instruções do chatbot e usadas para ele gerar a resposta.
Como os chatbots “veem” as incorporações?
É importante entender que os chatbots não “sabem” que estão consultando incorporações como se estivessem navegando em uma base de dados separada.
Para o chatbot, tudo chega como parte do contexto da conversa. Ou seja, quando o usuário envia uma pergunta e o sistema seleciona uma ou mais incorporações, esse conteúdo é anexado às instruções do chatbot e todo o “pacote” é enviado para a IA analisar e produzir a resposta.
Por isso, do ponto de vista do chatbot, não existe uma distinção explícita entre “instruções fixas” e “conteúdo recuperado”, a não ser pela forma como você organiza esses elementos.
Segue um exemplo de instruções de um chatbot:
Você é um assistente especializado em TI. Seu objetivo é prestar suporte técnico aos colaboradores da <EMPRESA>. Use o seu conhecimento de sistemas operacionais e aplicativos, em conjunto com as instruções abaixo, pra fornecer as respostas. Evite falar sobre outros assuntos. NÃO crie ou repasse links para o usuário, exceto os existentes neste contexto.
Instruções do chatbot x Incorporações
Uma boa prática é sempre separar corretamente:
- as instruções que o chatbot deve seguir;
- os conteúdos que ele poderá consultar para responder ao usuário final.
Essa separação é importante porque cada tipo de informação cumpre um papel diferente.
Coloque nas instruções do chatbot:
- regras de comportamento;
- objetivo do assistente;
- tom de resposta;
- limitações;
- orientações obrigatórias;
- informações essenciais que devem valer em todas as conversas.
Coloque nas Incorporações:
- procedimentos;
- artigos;
- FAQs;
- políticas;
- manuais;
- descrições de produtos e serviços;
- conteúdos de apoio que só precisam ser usados quando forem pertinentes à pergunta.
Se você misturar essas duas coisas, por exemplo colocando instruções de comportamento dentro de uma incorporação, a IA pode interpretar esse conteúdo de forma inadequada durante o processamento e afetar negativamente o resultado.
Em resumo:
- Instruções: informações para comportamento o chatbot;
- Incorporações: conhecimentos que o chatbot poderá consultar dependendo da pergunta do usuário.
Para que um chatbot faça uso deste recurso, ele deve estar configurado para usar um dos ambientes disponíveis no menu “Conhecimento e Contexto”.
As Embeddings que o Gestor criar na aba “Conhecimento” serão processados imediatamente e incluídos no ambiente de incorporações selecionado.
Os Artigos que o Editor cadastrar serão processados a cada 5 minutos e incluídos no ambiente de incorporações padrão, configurado pelo gestor com a opção “Enable Sync” no na aba Conhecimento .
O Editor pode acompanhar o processamento pelo menu “Artigos” > “Status”. Nesta tela, é possível disparar o processamento manualmente e também visualizar como o conteúdo foi incorporado à base de conhecimento da IA, clicando o link “Ver”.
Antes de serem processadas, as incorporações são listadas com status “Pending”, “Outdated” ou “Stale” nas telas do sistema.
Quando uma incorporação é excluída, seja pela aba Conhecimentos ou pelo menu Artigos, o seu conteúdo é deletado automaticamente da base de incorporações da IA.
Não existe um único formato ideal para todas as incorporações. A melhor estrutura depende do tipo de conversa que o chatbot deverá atender.único inidicado para o seu conteúdo.
Quando o objetivo for orientar procedimentos
Nesse caso, o ideal é usar textos organizados, claros e objetivos, por exemplo:
- textos curtos e concisos;
- listas numeradas;
- subtítulos para separar etapas;
- exemplos diretos;
- instruções passo a passo;
- observações explicativas sobre exceções ou cuidados.
Esse formato ajuda a IA a identificar trechos específicos e a responder de maneira mais precisa.
Quando o objetivo for transmitir conhecimento mais geral
Se a intenção for enriquecer o chatbot com conceitos, resumos, briefings, descrições institucionais ou informações amplas sobre um tema, você pode usar textos mais descritivos, desde que continuem bem organizados.
Em ambos os casos, quanto mais claro e bem estruturado for o conteúdo, maiores as chances de ele ser útil nas respostas.
Toda vez que você cadastra uma incorporação, o seu conteúdo é processado para inclusão na base de conhecimento da IA. Nesse processamento é utilizado um prompt cadastrado no menu: “Artigos” > “Prompt de Reescrita”.
Existem dois modelos de prompt de reescrita pré-cadastrados: um que faz um resumo da incorporação (opção padrão) e outro que transcreve a incorporação literalmente. Escolha o prompt de resumir quando quiser que a AI tenha uma visão geral dos conteúdos que você cadastrar (ex. notícias, briefings, conceitos gerais).
Por outro lado, se você estiver cadastrando procedimentos ou manuais técnicos, o prompt de transcrever é a melhor opção.
Sempre que você alterar o prompt de reescrita o sistema irá reprocessar todas as incorporações. Esse processo consome consultas na sua conta (1 consulta por incorporação reprocessada) e também gera gastos com tokens. Portanto, é importante que seja usado com moderação.
As Incorporações não são usadas automaticamente em toda resposta. A IA irá avaliar se o conteúdo tem relação com a pergunta do usuário. Se considerar que sim, ele será usado na resposta.
Isso significa que:
- incorporações bem escritas e focadas em determinado tema tendem a ser usadas com mais frequência;
- incorporações muito genéricas tendem a ser ignoradas;
- mesmo que uma incorporação seja selecionada, a IA ainda irá decidir se e como irá usá-la em uma resposta específica.
Também é importante entender que esse mecanismo não funciona como uma busca exata. A seleção considera similaridade de tema e significado, e não apenas coincidência literal de palavras.
Por isso, instruções do tipo “responda exatamente o que estiver escrito” podem não funcionar como esperado quando colocadas em incorporações. Esse tipo de regra deve ficar nas instruções do chatbot, não na base de conhecimento.
Além de criar conteúdos bem estruturados para as incorporações, existem três parâmetros importantes ao seu dispor, no menu “Incorporações” > “Configurações”:
- Pontuação mínima: corresponde ao score mínimo necessário que as incorporações precisam alcançar para serem selecionadas. A IA define uma nota de 0 a 100 com base no percentual de coincidência de termos entre a incorporação e a pergunta do usuário. Uma pontuação de corte mais elevada torna as respostas mais específicas, mas pode deixar de fora conteúdos importantes. O valor padrão é 75.
- Quantidade de resultados: corresponde ao número máximo de incorporações a serem usadas nas respostas. Quanto maior número, mais conteúdos serão usados, aumentando a base de informações disponíveis. O valor padrão é 3 e pode ser ajustado conforme o caso de uso.
Se você observar que certas incorporações não estão sendo selecionadas quando deveriam, inclua uma relação determos no final do texto, ex.: PALAVRAS-CHAVE: CURSO, TREINAMENTO, FORMAÇÃO.
No painel administrativo da sua conta, o menu “Copilotos” abre uma biblioteca de agentes de IA que ajudam na geração de conteúdo para as incorporações.. Você encontrará assistentes para análise de documentos, análise de páginas web e redação de textos.
Veja para que servem alguns dos agentes disponíveis:
- Análise de Páginas Web: permite extrair textos de sites para geração conteúdos que podem ser usados nas incorporações.
- Análise de Documentos: analisa documentos PDF e DOCX, facilitando a extração de informações de forma rápida e precisa.
- Redação de Textos: usa o poder da IA para criar artigos relevantes e envolventes sobre temas de sua escolha.
- Importação de Sites: gera incorporações automaticamente a partir das páginas existentes em um website.
- Textos a Partir de Imagens: gera textos descritivos ou inspirados pelas imagens que você carregar.
Sim, usando o copiloto de “Importação do WordPress”, você pode importar posts ou páginas do WordPress para suas Incorporações.
Existem duas opções de importação:
1. Via arquivo XML salvo no formato WordPress Extended RSS.
Um arquivo WordPress Extended RSS (WXR) contém os posts ou páginas exportados a partir do site remoto. Para gerá-lo, entre na área administrativa do WordPress e acesse o menu: “Ferramentas” > “Exportar”. Em seguida, selecione a opção para exportar posts, páginas ou ambos, como desejar. O sistema vai baixar um arquivo XML com as informações.
Coloque o arquivo XML em uma pasta do site remoto. Por segurança, use nomes de pasta e de arquivo difíceis de alguém adivinhar, como, por exemplo: https://www.site_remoto/1agy3k8v/arquivo.xml
Após salvar o arquivo no site, acesse o link que você que você criou no seu navegador para confirmar que o download está acessível. Se o arquivo baixar normalmente, insira o mesmo link no campo “Link para o site ou arquivo XML” do formulário para fazer a importação. Se o processo for bem sucedido, as respectivas incorporações serão criadas.
2. Via REST API do site remoto em: https://www.site_remoto
Nesta modalidade, você apenas informa o endereço (URL) do site remoto no campo “Link para o site ou arquivo XML” do formulário para fazer a importação dos posts e páginas. Para que o processo funcione, é necessário que a REST API do WordPress esteja habilitada no site remoto.
Caso deseje que o sistema refaça a importação do arquivo XML ou via REST API diariamente (2x ao dia), marque essa opção no formulário.
Ao importar o conteúdo, o sistema compara os títulos com os das Incorporações. Tanto os posts/páginas novos quanto os que foram atualizados desde a última importação serão importados. Além disso, os posts que forem excluídos na origem também serão excluídos das Incorporações.
Ao final do processo, as novas Incorporações são processadas automaticamente pelo sistema.
Sim, usando o “Upload PDF”, disponível na aba de “Conhecimentos”, você pode carregar arquivos PDF e, se deseja, dividi-los em trechos menores usando os parâmetros “Density” e “Overlap” para gerar incorporações.
Sim, usando os recursos de “Download” e “Importar”, disponíveis no menu “Artigos”, o Gestor ou o Editor pode baixar ou carregar incorporações em lote:
A opção “Download” baixa um arquivo ZIP contendo as incorporações em TXT, no formato:
Date: AAAA-MM-DDD HH:MM:SS
Title: Título da incorporação
Category: Categoria da incorporação
Content:
Conteúdo da incorporação
A opção “Importar” faz o caminho inverso, permite carregar um arquivo ZIP contendo as incorporações, desde que os arquivos TXT estejam no formato acima.
Ao final do processo, as Incorporações importadas serão processadas automaticamente pelo sistema, desde que exista um ambiente ativado para sincronização.
Embora os limites de processamento dos modelos evoluam com frequência, é recomendável manter os conteúdos otimizados.
Na prática, conteúdos menores tendem a trazer dois benefícios:
- menor consumo de tokens;
- respostas mais rápidas,
Por isso, recomendamos que o conteúdo de uma incorporação individual fique sempre abaixo de 16.000 tokens. Para verificar o número de tokens de determinado texto, insira-o aqui: https://platform.openai.com/tokenizer
Se um conteúdo ultrapassar esse tamanho, o ideal é dividi-lo em duas ou mais incorporações, por exemplo:
- FAQ – Título/Assunto – Parte 1
- FAQ – Título/Assunto – Parte 2
- FAQ – Título/Assunto – Parte 3
Essa divisão não prejudica o resultado. Pelo contrário: como a IA tende a recuperar apenas os trechos mais relacionados ao assunto da conversa, separar conteúdos longos pode até melhorar a qualidade das respostas.
