Configurar e gerenciar a base de conhecimento
Com a base de conhecimento, a organização disponibiliza informações confiáveis de forma centralizada. Os administradores podem publicar links e documentos de conhecimento. Documentos de conhecimento publicados também são automaticamente pesquisados quando seu conteúdo é relevante para uma pergunta comum no chat.
Você gerencia a base de conhecimento via Administração → Base de Conhecimento. Links existentes e documentos centrais de conhecimento aparecem juntos em uma única tabela.
O que os colaboradores veem
Itens publicados são visíveis em Base de Conhecimento → Organização → Documentos (ou na própria filial). Os colaboradores veem apenas informações para toda a organização ou para sua própria filial. Modelos de documentos destinados a determinados departamentos também aparecem para os colaboradores desses departamentos em filial → Meus departamentos.
Um documento de conhecimento pode ser usado de duas maneiras:
- O colaborador abre o documento a partir de Documentos.
- O AI-Public pesquisa automaticamente o documento em uma pergunta relevante no chat, sem que o colaborador precise selecioná-lo com o clipe de papel.
Um Link comum apenas direciona para uma página web, vídeo ou fonte externa. Apenas um documento de conhecimento processado contém Markdown canônico que pode ser pesquisado como fonte central no chat.
Nível organizacional e de filial
Cada documento de conhecimento tem um alcance:
- Toda a organização — disponível para todos os colaboradores no ambiente.
- Filiais — disponível apenas para colaboradores de uma ou mais filiais selecionadas.
Administradores do ambiente podem gerenciar conhecimento para toda a organização e para filiais selecionadas. Um administrador de filial gerencia apenas o conhecimento das filiais para as quais tem direitos de administração.
Escolha o alcance com base no conteúdo. Políticas organizacionais, por exemplo, pertencem a Toda a organização; uma instrução de trabalho local pertence à filial correspondente.
Visão geral da base de conhecimento
Na visão geral você pode:
- buscar e filtrar;
- adicionar itens com o botão de mais;
- ajustar a ordem com o controle de arrastar;
- editar links e documentos de conhecimento;
- publicar, arquivar ou excluir documentos;
- importar ou exportar um pacote OKF.
O índice e a ordem definida determinam como os itens são organizados em Documentos.
Adicionar um item
Clique no botão de mais acima da tabela. Você pode escolher entre três tipos de conteúdo.
Link
Escolha Link para uma página web existente, vídeo, curso ou outra fonte externa. Preencha um título reconhecível, descrição, categoria e URL. O link fica visível na base de conhecimento, mas a página externa não é automaticamente indexada como documento central.
Adicionar documento
Escolha Adicionar documento para escrever diretamente um documento de conhecimento.
- Preencha um nome de arquivo único e um título claro.
- Escolha um tipo e adicione uma descrição e tags.
- Escreva ou cole o conteúdo no editor Markdown.
- Escolha o status e o alcance.
- Salve o documento.
Use títulos claros, parágrafos curtos e independentes e termos consistentes. Isso ajuda tanto o leitor quanto a recuperação automática de fragmentos relevantes.
Adicionar arquivo fonte
Escolha Adicionar arquivo fonte para usar um arquivo do Gerenciador de Arquivos como documento de conhecimento. Você pode escolher um arquivo existente ou primeiro fazer upload de um novo arquivo.
O AI-Public armazena o arquivo original e cria Markdown canônico adicionalmente. Arquivos PDF, Word, PowerPoint, Markdown e outros suportados recebem assim um formato consistente para exibição, exportação e indexação de busca.
Arquivos PDF, Word e PowerPoint são processados automaticamente. Texto, estrutura do documento e, quando possível, informações visuais relevantes como tabelas, gráficos, formulários e imagens são incluídos. Isso mantém mais conteúdo útil disponível do que apenas extração de texto simples.
Antes da publicação, verifique:
- se todos os capítulos importantes estão presentes;
- se tabelas e listas são compreensíveis;
- se gráficos e imagens estão bem descritos em termos de conteúdo;
- se título, descrição, tipo e tags estão corretos;
- se alertas de qualidade exigem ação;
- se status e alcance da filial estão corretos.
Um processamento tecnicamente bem-sucedido não garante que todo o significado visual foi corretamente transferido. Sempre compare o conhecimento importante com o arquivo original.
Configurar metadados
Em Configurar documento de conhecimento você gerencia, entre outros:
| Campo | Uso |
|---|---|
| Título | Nome que os colaboradores veem na base de conhecimento e na referência da fonte. |
| Tipo | Tipo de conteúdo, por exemplo, política, protocolo ou manual. |
| Descrição | Breve explicação sobre objetivo e conteúdo. |
| Tags | Termos para busca e gerenciamento, separados por vírgulas. |
| Fonte ou recurso | Origem ou proprietário do conteúdo. |
| URL da fonte | Link para a fonte original ou atual. |
| Data de modificação | Data em que a fonte foi atualizada em conteúdo. |
| Status de publicação | Rascunho, Publicado ou Arquivado. |
| Alcance | Toda a organização ou filiais selecionadas. |
| Markdown canônico | Conteúdo exibido, exportado e indexado. |
Status e publicação
- Rascunho — visível apenas na administração e ainda não disponível para perguntas no chat.
- Publicado — visível em Documentos e pesquisável dentro do alcance definido.
- Arquivado — mantido na administração, mas não disponível ativamente para colaboradores.
Um fluxo seguro é: adicionar como Rascunho, verificar conteúdo e alcance, testar perguntas representativas e depois publicar. Arquive conhecimento desatualizado e evite que versões conflitantes estejam publicadas simultaneamente.
Propriedade organizacional e armazenamento
Quando um arquivo fonte se torna conhecimento central, ele é movido do armazenamento pessoal para o armazenamento da organização. O proprietário pessoal e o vínculo com a pasta são removidos. O documento de conhecimento permanece assim preservado mesmo se a conta do uploader original for excluída posteriormente.
Use Arquivado quando o conhecimento não deve mais estar ativo, mas precisa ser mantido. Exclua um documento apenas se o arquivo fonte, a versão canônica e o índice de busca também puderem ser removidos definitivamente.
O que é OKF?
OKF (Open Knowledge Format) é o formato transferível da base de conhecimento central. Consiste em Markdown comum com frontmatter YAML para metadados de conteúdo.
---
type: "beleid"
title: "Organisatieprotocol"
resource: "organisatieprotocol.pdf"
tags: ["beleid", "uitvoering"]
source_format: "pdf"
source_file: "organisatieprotocol.pdf"
---
# Organisatieprotocol
## Uitvoering
De inhoud staat in normale, leesbare Markdown.
Status de publicação e alcance da filial permanecem configurações de segurança separadas no AI-Public; não fazem parte do documento transferível.
Importar e exportar OKF
Com o botão de exportação você baixa os documentos centrais de conhecimento como um pacote ZIP. O pacote contém documentos Markdown, um index.md e um log de exportação. O arquivo PDF ou Word original permanece armazenado no AI-Public como fonte.
Com o botão de importação você adiciona um pacote ZIP com documentos Markdown. Documentos importados começam como Rascunho, para que um administrador possa verificar título, conteúdo, alcance e metadados antes da publicação.
Um pacote pode conter no máximo 25 documentos Markdown e 8 MB de conteúdo compactado e descompactado. Divida coleções maiores em vários pacotes.
Verificação de ponta a ponta
- Publique um documento com um fato claramente reconhecível.
- Faça login como colaborador dentro do alcance definido.
- Verifique se o documento está em Documentos e pode ser aberto.
- Faça uma pergunta relevante em um chat comum sem selecionar manualmente o documento.
- Verifique se a resposta corresponde ao documento e se a fonte central é mencionada.
- Repita o teste com um colaborador fora do alcance; ele não deve ver o documento nem usá-lo via chat.
Para arquivos que um colaborador vincula apenas a uma conversa, leia Chat com documentos.