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. Boas práticas
7. 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.

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. 😃