> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolzz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Base de Conhecimento

> Módulo responsável pela gestão de arquivos utilizados como Base de Conhecimento para o Agente criado. Ele permite a importação e organização de conteúdos, aprimorando a qualidade das respostas fornecidas aos usuários finais.

## Pré-Requisitos

1. Estar autenticado na plataforma
2. Possuir uma instituição vinculada
3. Possuir uma unidade
4. Assinatura no Plano Magic na ToolzzAI

## Gerenciamento das Bases de Conhecimento

Para acessar as Bases de Conhecimento, o usuário dentro da unidade deve entrar pelo menu lateral na opção “Base de Conhecimento“ onde poderá visualizar quantos documentos foram importados e qual o tamanho da base.

Além de visualizar essas informações, é possível ativar ou desativar a utilização da Base de Conhecimento, de forma que os conteúdos não serão apagados, porém não poderá ser utilizada pelos Agentes.

<Note>Ao desativar uma Base de Conhecimento, os Agentes que estiverem utilizando sua base poderão ter suas respostas impactadas.</Note>

### Criar uma Base de Conhecimento

Ao clicar no botão “+ Criar Base de Conhecimento“ na tela de Base de Conhecimento, o sistema irá abrir um modal onde o usuário poderá inserir Nome e Descrição da Base, esse é o primeiro passo para criar uma base.

Após digitar Nome e Descrição, o sistema leva o usuário diretamente para tela de criação onde é permitido importar arquivos locais e conteúdos externos para a mesma base.

Antes de importar arquivos e conteúdo é obrigatório a criação de uma pasta dentro da Base de Conhecimento:

1. Entrar na Base de Conhecimento
2. Clicar em “Criar Pasta“
3. Escolher o nome da pasta
4. Pasta criada com sucesso”

### Importar Arquivo Local

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/local.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=142485835b708a4c55aa5b01a9c06ef3" alt="Chatbot empty-state" width="1835" height="968" data-path="images/dataset/local.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/local.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=142485835b708a4c55aa5b01a9c06ef3" alt="Hero Dark" width="1835" height="968" data-path="images/dataset/local.png" />
</Frame>

Na Toolzz AI é possível importar conteúdo de arquivos locais para a Base de Conhecimento. Podendo ser importados arquivos em formato PDF, JPG e PNG.

Para realizar o upload dos arquivos, basta o usuário dentro da Base de Conhecimento, clicar em “Upload“ e escolher os arquivos que deseja para exportação

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/arquivo.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=779bd8a856c7a30ba89d6cd2365cb843" alt="Chatbot empty-state" width="977" height="473" data-path="images/dataset/arquivo.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/arquivo.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=779bd8a856c7a30ba89d6cd2365cb843" alt="Hero Dark" width="977" height="473" data-path="images/dataset/arquivo.png" />
</Frame>

Após selecionar os arquivos eles serão exibidos em “Arquivos“ onde pode visualizar:

* **Nome:** Nome do arquivo importado
* **Estado:** Status do upload que pode ser PENDENTE ou SUCESSO
* **Criado em:** Data e Hora da importação do arquivo
* **Ações:** Possíveis ações que podem ser feitas sobre o arquivo
  * **Visualizar o arquivo:** Ao clicar no ícone de olho <Icon icon="eye" iconType="solid" /> o usuário consegue visualizar o arquivo importado
  * **Editar arquivo:** Ao clicar no ícone de lápis <Icon icon="pencil" iconType="solid" /> o usuário consegue alterar o nome do arquivo importado
  * **Deletar arquivo:** Ao clicar no ícone de lixeira <Icon icon="trash" iconType="solid" /> o usuário consegue deletar arquivo importado

## Importar Conteúdo do Toolzz LMS

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/lms.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=25387088ac7c066d9f060ae0f2a69580" alt="Chatbot empty-state" width="1775" height="966" data-path="images/dataset/lms.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/lms.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=25387088ac7c066d9f060ae0f2a69580" alt="Hero Dark" width="1775" height="966" data-path="images/dataset/lms.png" />
</Frame>

Pela ToolzzAI os usuários podem importar conteúdos integrados ao Toolzz LMS diretamente pela Base de Conhecimento conectando sua plataforma com o LMS (Sistema de Gestão do Aprendizado) para centralizar suas informações e facilitar ao Agente o acesso aos conteúdos.

Um dos principais requisitos para Importar os conteúdos LMS é possuir uma credencial LMS criada, que para isso o usuário deve preencher o seguinte formulário:

* **Nome da Credencial:** Campo para inserir o nome da credencial
* **Toolzz API Key:** Campo para inserir a chave de acesso que pode ser buscada na plataforma Toolzz LMS

Usuário dentro da Base de Conhecimento clica em “Importar Conteúdo“, escolhe Toolzz LMS e segue para as etapas de importação:

<AccordionGroup>
  <Accordion title="Informações básicas" icon="square-1">
    * **Conectar Credencial** `obrigatório`: Campo onde usuário poderá selecionar as credenciais LMS criadas.
    * **Escolher Pasta** `obrigatório`: Bloco onde usuário escolherá qual pasta o conteúdo deverá ser importado, caso não seja escolhida nenhuma, o sistema criará uma nova pasta.
    * **Selecionar Filtros:** Bloco onde usuário poderá escolher pelas categorias Grupo, Sub-grupo e Especialidade
  </Accordion>

  <Accordion title="Conteúdos" icon="square-2">
    * **Cursos:** Ao ser ativado poderão ser selecionados quais cursos e quais itens do curso serão importados para a Base de Conhecimento. Usuário poderá escolher importar: Título; Descrição; Link; Capa; Disciplina; Escola e Tags
    * **Conteúdos Exclusivos:** Ao ser ativado poderão ser selecionados quais conteúdos dados como exclusivo no LMS poderão ser importados. Também poderão ser selecionados os itens desses conteúdos como: Título; Descrição; Link; Capa; Preço e Tags
    * **Vídeos:** Ao ser ativado, será possível selecionar quais vídeos disponíveis no LMS poderão ser importados para o sistema. Também poderão ser selecionados os seguintes itens associados aos vídeos: Título; Descrição; Link e Tags.
    * **Áudios:** Ao ser ativado, será possível selecionar quais arquivos de áudio disponíveis no LMS poderão ser importados para o sistema. Também poderão ser selecionados os seguintes itens associados aos áudios: Título; Descrição; Link e Tags.
    * **PDFs:** Ao ser ativado, será possível selecionar quais arquivos PDF disponíveis no LMS poderão ser importados para o sistema. Também poderão ser selecionados os seguintes itens associados aos PDFs: Título; Descrição; Link e Tags.
  </Accordion>

  <Accordion title="Revisar" icon="square-3">
    * Etapa onde é possível ter uma visão ampla para revisar e confirmar as escolhas feitas durante as configurações de importação, assim podendo importar os conteúdos corretos.
  </Accordion>
</AccordionGroup>

## Importar Conteúdo da Web

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/web.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=6acdf7a3ee2a82edd5b553df60cebf0f" alt="Chatbot empty-state" width="1849" height="957" data-path="images/dataset/web.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/labzzllc/gWasifl5HhCRLmZ2/images/dataset/web.png?fit=max&auto=format&n=gWasifl5HhCRLmZ2&q=85&s=6acdf7a3ee2a82edd5b553df60cebf0f" alt="Hero Dark" width="1849" height="957" data-path="images/dataset/web.png" />
</Frame>

Para importar conteúdos da Web o usuário deve entrar na Base de Conhecimento, clicar em “Importar Conteúdo“, escolher a opção “Importar Conteúdo da Web“ e completar as seguintes etapas de importação.

<AccordionGroup>
  <Accordion title="Informações básicas" icon="square-1">
    * **Importar de Site**:
      * **Link do Site:** Campo para inserir a URL do site a ser importado
      * **Quantidade de Páginas:** Campo inserir quantas páginas devem ser consideradas para importação na Base de Conhecimento
    * **Escolher Pasta:** Campo onde usuário pode escolher qual pasta os conteúdos devem ser armazenados, caso não seja escolhida nenhuma, o próprio sistema irá criar uma pasta.
  </Accordion>

  <Accordion title="Conteúdos" icon="square-2">
    * **Importar de Site:** Bloco onde usuário poderá escolher quais páginas buscadas serão utilizadas na Base de Conhecimento
  </Accordion>

  <Accordion title="Revisar" icon="square-3">
    * **Detalhe da Importação:** Bloco onde usuário consegue ter uma visão ampla sobre as configurações de importação feita podendo visualizar:
    * **Site:** O site inserido na Etapa 1
    * **Pasta:** A pasta que os arquivos serão importados
    * **Páginas:** A quantidade de páginas selecionadas na Etapa 2
  </Accordion>
</AccordionGroup>

## Editar uma Base de Conhecimento

1. Selecione os três pontinhos superiores à Base de Conhecimento
2. Selecione a opção “Editar“
3. Altere os campos Nome e Descrição da Base de Conhecimento
4. Clique em “Salvar“
5. Base de Conhecimento atualizada com sucesso!

## Duplicar uma Base de Conhecimento

1. Selecione os três pontinhos superiores à Base de Conhecimento
2. Selecione a opção “Duplicar“
3. Base de Conhecimento duplicada com sucesso!
4. Deletar uma Base de Conhecimento
5. Selecione os três pontinhos superiores à Base de Conhecimento
6. Selecione a opção “Excluir“
7. Base de Conhecimento deletada com sucesso!