Studio: Base de Conhecimento

Índice:

1. Introdução
2. Como acessar a Base de Conhecimento
3. Catálogo
4. Configurar o catálogo
5. Configurando a Base de Conhecimento na aba Ferramentas
6. Potencialize sua Base de Conhecimento com Pré-Processamento
7. Boas práticas
8. Blip Academy
    

Introdução

A Base de Conhecimento é uma funcionalidade que centraliza documentos, links e artigos para que o agente virtual acesse rapidamente informações confiáveis durante as interações com usuários.

Ela permite organizar conteúdos em catálogos, importar arquivos, vincular URLs e manter as informações sempre atualizadas.

Como acessar a Base de Conhecimento

Esta é a tela inicial que permite acessar a área de gerenciamento de catálogos da Base de Conhecimento. Para acessar, siga o caminho:

1. No painel do contrato, localize o card Base de conhecimento.
2. Clique em Importar base.

Catálogo

É um agrupador de informações dentro da Base de Conhecimento. Ele centraliza arquivos e URLs sobre um mesmo tema, permitindo que o agente virtual utilize esses dados para responder aos usuários com precisão.

Como criar um catálogo

• Ao acessar a Base de conhecimento, clique em Criar catálogo.

Essa tela será exibida somente no primeiro acesso

• Na janela exibida, digite o nome do catálogo. Clique em Salvar para concluir ou Cancelar para sair.

Adicionar conteúdo ao catálogo

Após criar um catálogo, a tela Configurar catálogo será exibida. Nela, você poderá adicionar arquivos e URLs que o agente de IA utilizará para responder aos usuários.

Passos

1. Clique em Adicionar conteúdo.

2. Escolha entre:

   • Importar arquivo – enviar um documento do seu computador.

   • Adicionar URL – vincular uma página da web pública.

Importar arquivo

Permite enviar documentos diretamente do seu computador para o catálogo.

Passos

1. Selecione a opção Importar arquivo. Formatos aceitos: XLSX, CSV, JSON, PDF, TXT, DOCX, PPTX, MD.

2. Arraste e solte o documento ou clique para selecionar.

3. Clique em Salvar para concluir ou Cancelar para voltar.

Pontos importantes

• Os arquivos adicionados servem como base para as respostas do agente.

• É possível combinar diversos tipos de arquivo num mesmo catálogo; entretanto, cada envio — mesmo que contenha documentos duplicados — será adicionado ao histórico do agente.

• Arquivos não podem ser editados: caso seja necessário modificar conteúdo, você deve excluir o arquivo antigo ou atualizar uma nova versão.

• O agente não interpreta conteúdo em imagens, portanto, certifique-se de que todas as informações relevantes estejam no texto.

• Para que o agente possa enviar mídias (imagens, áudios, vídeos, PDFs ou links) como resposta, a Base de Conhecimento deve seguir um modelo específico (disponível abaixo em Exemplos de modelos de arquivo. Utilize o arquivo Base de conhecimento exemplo Agente de IA como referência para estruturar o conteúdo).

• Todos os links para mídias devem ser públicos, garantindo que o agente consiga acessá-los e entregá-los corretamente ao usuário.

Exemplos de modelos de arquivo  

Após adicionar uma URL ou arquivo pela primeira vez, você será direcionado para a tela Configurar catálogo, onde poderá gerenciar todos os arquivos e URLs vinculados a esse catálogo. Nesta tela, também é possível incluir novos itens clicando no botão Adicionar conteúdo.

Observação: O processo de importação de arquivos segue o mesmo procedimento descrito no tópico Importar arquivo.

Adicionar URL

Permite vincular uma página da web pública ao catálogo, garantindo que o conteúdo esteja acessível ao agente sem autenticação

Passos

1. Clique em Adicionar conteúdo;

2. Insira o endereço completo (incluindo https://);

3. Clique em Salvar ou Cancelar.

Configurar o catálogo

Tela que permite visualizar e configurar todos os itens (arquivos e URLs) de um catálogo. Para cada conteúdo, são exibidas informações como nome e tipo, data e autor da última atualização, além do status de sincronização (Ativo, Inativo ou Sincronizando).

Passos

1. Na tela Base de conhecimento, localize o catálogo desejado.

2. Clique no menu de opções (ícone de três pontos) e selecione Abrir.

Ao abrir o catálogo, será exibida a listagem completa de arquivos e URLs, permitindo consultar detalhes e utilizar o menu de ações.

Menu de ações (ícone de três pontos) disponível para cada item:

• Abrir: Exibe o conteúdo do item selecionado;
• Baixar: Faz o download do arquivo no formato original para o seu dispositivo;
• Atualizar: Substitui o conteúdo existente por uma nova versão;
• Restaurar: Reverte o conteúdo para a versão anterior mais recente salva no Blip;
• Ativar/Desativar: Define se o conteúdo estará disponível para uso pelo agente de IA;
• Excluir: Remove permanentemente o conteúdo do catálogo.

Gerenciar URLs vinculadas

Exibe todas as páginas associadas a uma URL pública cadastrada no catálogo. Apenas URLs acessíveis sem autenticação ou bloqueios podem ser sincronizadas corretamente.

Passos

1. No conteúdo do tipo URL, clique em Abrir.
2. Ative ou desative a sincronização de cada página.
3. Exclua páginas quando necessário.
4. Use a busca para localizar páginas específicas.

Configurando a Base de Conhecimento na aba Ferramentas

A aba Ferramentas permite que o seu agente interaja com recursos externos e consulte informações específicas para enriquecer as suas respostas. Atualmente, a base de conhecimento é conectada ao agente como uma ferramenta, permitindo que o agente tenha acesso a múltiplos contextos de forma organizada.

Como adicionar uma Base de Conhecimento

Ao clicar em Adicionar ferramenta, será exibida uma lista de opções. No submenu Consultar, selecione a opção Base de Conhecimento.

Diferente de versões anteriores, agora o seu agente pode ter uma ou várias ferramentas deste tipo. Isto é útil para separar assuntos diferentes (ex: uma base para "Dúvidas Técnicas" e outra para "Políticas de RH"), permitindo um referenciamento mais preciso nas instruções do agente.

Configurações Principais

Para cada ferramenta de base de conhecimento, será necessário definir os seguintes campos:

1. Nome: Um nome único que ajude a identificar a ferramenta.

2. Descrição: Este campo é fundamental. É aqui que você explicará ao agente quando ele deve consultar esta base e o que encontrará nela.

   • Exemplo: "Utilize esta ferramenta para responder a dúvidas sobre preços, planos e métodos de pagamento."

Selecionando os Conteúdos (Catálogos)

Para que a ferramenta tenha informações para consultar, ela precisa de Catálogos. Os catálogos centralizam os seus arquivos e URLs.

1. Clique em Adicionar catálogo.

2. Na janela que será aberta, pode selecionar catálogos já existentes ou clicar em Criar catálogo para ser redirecionado à área de gestão de conteúdos.

Dica Prática: Pode selecionar um catálogo inteiro ou apenas conteúdos específicos dentro dele, marcando as caixas de seleção (checkboxes). Isto te dá um controle total sobre o que cada ferramenta pode "ler".

Otimização e Definições de Consulta

Para garantir que o agente responda de forma rápida e econômica, a plataforma utiliza a tecnologia de RAG (Retrieval Augmented Generation). Isto significa que, em vez de ler todos os documentos de uma vez, o agente procura apenas os trechos mais relevantes para o contexto do usuário.

Na seção Definições da Consulta, é possível ajustar:

• Trechos retornados (Chunks): Define quantos "pedaços" de informação o agente recebe por consulta.

• Recomendação: O valor padrão é 3. Adicionar mais trechos pode ajudar o agente a responder melhor, mas consome mais tokens e pode ultrapassar a janela de contexto do modelo.

Potencialize sua Base de Conhecimento com Pré-Processamento

O pré-processamento otimiza os documentos da sua base de conhecimento antes que eles sejam disponibilizados para os agentes do Studio. Esse processo melhora a qualidade da informação, a precisão das buscas e a eficiência das respostas geradas.

Oferecemos três tipos de pré-processamento que podem ser habilitados de acordo com sua necessidade.

1. Otimização (Limpeza de Ruídos)

O que é?

A Otimização é um processo automático de limpeza que remove "ruídos" e formatações desnecessárias do texto dos seus documentos. O objetivo é padronizar o conteúdo, garantindo que a IA foque apenas na informação relevante.

Como funciona?

Este processador aplica um conjunto de regras para refinar o texto. Com base na sua configuração padrão, ele executa as seguintes ações em cada trecho do documento:

• Correção de Unicode: Repara caracteres que foram corrompidos ou mal codificados.

• Remoção de HTML: Elimina todas as tags HTML (ex: <div>, <p>, <span>) que podem estar presentes em documentos extraídos da web.

• Normalização de Espaços: Remove espaços múltiplos, tabulações e quebras de linha excessivas, substituindo-os por um único espaço ou quebra de linha, respectivamente.

Exemplo Prático:

• Texto Original:

<p>A Reunião será na terça.

Confira o t&oacute;pico principal.</p>

• Texto Otimizado:

A Reunião será na terça.

Confira o tópico principal.

2. Indexação (Resumos e Tags com IA)

O que é?

A Indexação utiliza um AI Agente para enriquecer cada fragmento (chunk) do seu documento com um resumo conciso e palavras-chave relevantes. Isso cria um "índice semântico" que melhora drasticamente a capacidade do sistema de encontrar a informação exata que o usuário procura.

Como funciona?

Um agente de IA especializado em síntese de conhecimento analisa cada trecho de texto e gera:

• Resumo: Um sumário curto (2-3 sentenças) que explica o tópico específico daquele trecho.

• Palavras-chave: Uma lista de 5 a 8 termos essenciais, entidades ou jargões técnicos encontrados no texto.

• O processo é realizado no mesmo idioma do documento original para manter a consistência.

Exemplo Prático:

• Texto do Chunk:
  "O Artigo 14 do contrato de serviço estipula que a parte contratada deve notificar a contratante com 30 dias de antecedência sobre qualquer interrupção programada. A falha em cumprir esta cláusula resultará em penalidades financeiras, conforme detalhado no Anexo B."

• Resultado da Indexação:

  • Resumo: "Este trecho detalha a cláusula do Artigo 14 sobre a obrigatoriedade de notificação prévia de 30 dias para interrupções de serviço. O não cumprimento da notificação acarreta em multas financeiras."

  • Palavras-chave: "contrato de serviço, Artigo 14, notificação prévia, interrupção programada, cláusula, penalidades financeiras, Anexo B"

Quando usar?

Em documentos que funcionam como uma coleção de informações independentes, onde cada trecho tem valor por si só. Ideal para:

• Bases de Pergunta e Resposta (FAQ): Onde cada par de pergunta/resposta é um "fato" que precisa ser encontrado de forma isolada.

• Conteúdo tabular ou dividido: Documentos em que a informação já está segmentada em blocos, como uma planilha com descrições de produtos ou uma lista de políticas internas.

• Artigos ou posts de blog: Onde cada parágrafo ou seção aborda um sub-tópico específico que pode ser resumido para facilitar a busca.

Benefício principal

Cria um "índice" rico que permite ao buscador encontrar trechos específicos com alta precisão, mesmo que a busca do usuário use sinônimos ou termos relacionados.

Custo

Consome tokens de IA de acordo com o tamanho do documento.

3. Contextualização (Leitura Semântica Global com IA)

O que é?

A Contextualização é o pré-processamento mais avançado. Ele utiliza um AI Agent para realizar uma "leitura semântica global" de todo o documento. Para cada fragmento de texto, a IA descreve onde ele se encaixa no contexto geral do documento, agindo como um "GPS" para o motor de busca.

Como funciona?

Diferente da Indexação que foca no conteúdo do trecho, a Contextualização foca em sua localização e propósito. O agente de IA lê o documento inteiro para entender sua estrutura (capítulos, seções, fluxo de ideias) e, em seguida, gera uma frase curta (15-25 palavras) para cada trecho, descrevendo seu papel contextual.

Exemplo Prático:

• Documento: "Manual de Segurança de TI da Empresa"

• Texto do Chunk:
  "Todos os funcionários devem usar senhas com no mínimo 12 caracteres, incluindo letras maiúsculas, minúsculas, números e símbolos."

• Resultado da Contextualização:

  • Contexto Gerado: "Seção de 'Política de Senhas' do manual, especificando os requisitos de complexidade para as credenciais de acesso dos funcionários."

Quando usar?

Em documentos longos, contínuos e estruturados, onde a posição de uma informação dentro do todo é crucial para seu significado. Ideal para:

• Manuais técnicos e guias de usuário: Onde é importante saber se um trecho está na seção de "Instalação", "Solução de Problemas" ou "Configurações Avançadas".

• Contratos e documentos jurídicos: Onde o contexto de uma cláusula (ex: "Cláusula de Rescisão", "Anexo de Penalidades") é fundamental.

• Artigos científicos e relatórios de pesquisa: Onde a estrutura (Introdução, Metodologia, Resultados, Conclusão) dá sentido a cada parte do texto.

Benefício principal

Age como um "GPS" para a busca, informando ao sistema não apenas o que está no trecho, mas onde ele se encaixa no fluxo de informações do documento.

Custo

Consome tokens de IA de acordo com o tamanho do documento.
 

Tabela Comparativa

Regra de Ouro

• Se seus documentos são uma coleção de fatos, onde cada um pode ser lido de forma independente, escolha a Indexação.

• Se seus documentos contam uma história ou seguem uma estrutura lógica, onde o contexto é rei, escolha a Contextualização.

• A Otimização é como arrumar a casa antes de decorar: use sempre que possível.
   

Como usar o Pré-Processamento no Studio

Agora, ao clicar em “Importar arquivos” dentro do catálogo, um menu lateral será aberto:

Neste menu lateral, é possível fazer upload de múltiplos arquivos e escolher qual pré-processamento deseja aplicar em cada um deles. Basta selecionar o checkbox do pré-processamento desejado e depois clicar em salvar:

As bases serão carregadas e pré-processadas. O tempo de processamento pode variar conforme o tamanho da base e as configurações selecionadas.

Boas práticas

• Mantenha os conteúdos sempre atualizados.
• Utilize nomes claros e padronizados para facilitar buscas.
• Revise URLs periodicamente para evitar links quebrados.

Blip Academy

Quer aprender como funciona e como trabalhar com o Blip Studio? Acesse o Blip Academy e aprenda gratuitamente. 

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃