Conhecimento por empresa
Conhecimento é uma capacidade opcional para consultar documentos publicados por empresa. O padrão é KNOWLEDGE_ENABLED=false; este guia descreve o recurso quando a equipe do COBRES o disponibiliza. A presença da documentação não significa que o chat esteja liberado na sua organização.
O recurso utiliza os documentos publicados para preparar respostas com fontes. Não treina um modelo com os arquivos, não pesquisa na web e não executa ações de cobrança.
Disponibilidade e acesso
O backoffice consulta GET /api/v1/knowledge/capabilities, que informa se a capacidade está habilitada e quais ações o operador possui. A seção Conhecimento pode oferecer Documentos, Conversas e Configurações.
| Ação | Permissão |
|---|---|
| Consultar documentos | knowledge.documents.read |
| Enviar e manter documentos | knowledge.documents.manage |
| Publicar conteúdo | knowledge.documents.publish |
| Conversar com a base | knowledge.chat.use |
| Alterar configurações da organização | knowledge.settings.manage, com escopo global |
As permissões se combinam com o escopo das empresas. Ler exige ao menos uma empresa acessível; alterar as associações de um documento exige acesso a todas as empresas antigas e novas. Publicar é uma autorização separada de enviar.
Preparar e publicar documentos
- Abra Conhecimento → Documentos e defina título e empresas destinatárias.
- Envie um TXT em UTF-8 ou um PDF com texto selecionável, de até 10 MiB.
- Acompanhe o processamento até o estado
readyou consulte o motivo defailed. - Revise as associações e publique explicitamente com uma pessoa autorizada.
- Use Testar chat ou Conversas para conferir uma pergunta cuja resposta esteja no conteúdo publicado.
O ciclo é uploading → queued → processing → ready → published. Um documento pronto ainda não participa das respostas. PDFs sem texto legível, protegidos ou malformados podem falhar; esta capacidade não realiza OCR.
O conteúdo publicado é imutável. Para atualizar o texto, envie e publique um novo documento e retire o anterior conforme o procedimento da organização. A despublicação devolve o documento a ready e altera a versão da base. Limites incluem 300 páginas por PDF, 1.000 documentos vivos e 500 MiB de originais por organização.
Consultar e conferir a resposta
Escolha a empresa, abra uma conversa e faça uma pergunta objetiva. Confira as fontes citadas antes de usar uma resposta em uma decisão operacional. A validação de fontes reduz respostas sem fundamento, mas não substitui a leitura dos documentos.
Uma conversa pertence à pessoa, à organização e à empresa. Um gestor de configuração não ganha acesso às conversas de terceiros. Testar chat usa a base publicada e o acesso da própria equipe; não assume a identidade do credor.
Arquivar preserva o conteúdo até a retenção aplicável e bloqueia novas mensagens enquanto a conversa permanecer arquivada. Restaurar permite continuar. Uma mudança da base marca o histórico anterior como desatualizado e impede sua reutilização como se ainda fosse atual.
Configurações e público externo
A organização pode ajustar nome do assistente, saudação, perguntas sugeridas, estilo de resposta, cota diária e retenção. A retenção padrão é 90 dias, configurável de 7 a 365 dias; sua redução pode excluir conversas antigas na próxima manutenção, inclusive arquivadas.
O chat externo exige, além da capacidade, vínculo Audience ativo, configuração audience_enabled e um provedor do produto que autorize as empresas daquele relacionamento. Sem esse provedor, não há empresas disponíveis para o participante. Não interprete acesso ao Portal do Credor como autorização automática para qualquer base.
Quando algo não funcionar
| Sinal | Conferência |
|---|---|
| Documento parado em fila | Encaminhe à equipe técnica a verificação do worker e do estado de processamento |
| PDF rejeitado | Confira formato, tamanho, proteção e existência de camada de texto |
| Informação não encontrada | Verifique empresa, publicação e presença efetiva da resposta nas fontes |
knowledge_base_changed | Atualize a conversa e confira a base antes de uma nova tentativa |
knowledge_quota_exceeded | Aguarde a renovação diária UTC ou solicite avaliação da cota |
knowledge_provider_unavailable | Registre o request_id; evite repetir mensagens sem conferir o resultado |
Envios usam request_nonce próprio e recusam Idempotency-Key. Uma resposta incerta não deve provocar repetição automática de consultas. Continue em privacidade e erros.