As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Bases de conhecimento
Uma base de conhecimento é uma coleção organizada e indexada de documentos ou conteúdo de fontes de dados otimizadas para recuperação generativa baseada em IA e resposta a perguntas. Se sua equipe armazena documentação no Confluence, colabora ou gerencia arquivos no armazenamento em nuvem, você pode reunir todas essas informações em uma experiência de pesquisa unificada criando bases de conhecimento. SharePoint
As integrações integradas podem ser configuradas com apenas alguns cliques para sincronizar seus dados no Quick e facilitar o acesso ao conhecimento da sua organização no Google Drive, Confluence OneDrive SharePoint, S3 e Web Crawler. Se sua equipe armazena documentação no Confluence, colabora ou gerencia arquivos no armazenamento em nuvem, você pode reunir todas essas informações em uma experiência de pesquisa unificada com a ajuda de bases de conhecimento. SharePoint
## Como funcionam as bases de conhecimento
A base de conhecimento é uma coleção indexada de documentos ou conteúdo de fontes de dados como o Google Drive, otimizada para recuperação generativa baseada em IA e resposta a perguntas. Várias bases de conhecimento podem ser criadas a partir da mesma fonte e todas podem residir em um Índice Rápido compartilhado. Por exemplo, se você sincronizar duas pastas do Google Drive e criar duas bases de conhecimento — uma para “Documentos de política” para responder perguntas como *“Qual é a nossa política de reembolso”* e outra para “Feedback do cliente” para responder perguntas como *“Quais são as reclamações comuns dos clientes”* — ambas podem fazer parte do mesmo índice. O Quick faz a distinção entre eles usando o ID da base de conhecimento, para que as consultas possam ser filtradas para recuperar somente os documentos relevantes da base de conhecimento desejada. Isso permite que os usuários organizem, protejam e recuperem informações relevantes para diferentes domínios ou casos de uso, mesmo que os dados subjacentes sejam indexados juntos.
Suas bases de conhecimento podem ser usadas individualmente ou compartilhadas com membros da equipe por meio do Amazon Quick Spaces. Nosso controle de acesso de baixa granularidade permite a segurança no nível da base de conhecimento, garantindo que os usuários só recebam informações das bases de conhecimento que estão autorizados a acessar.
### Processo de criação
Você pode criar bases de conhecimento ao configurar uma nova integração de acesso a dados e usar as integrações existentes para criar bases de conhecimento adicionais:
1. **Configuração da integração de acesso a dados** - Conecte-se à sua fonte de dados externa
1. **Seleção de conteúdo** - Escolha qual conteúdo incluir por meio de filtros e configurações de escopo
1. **Indexação** - O Amazon Quick processa e indexa o conteúdo selecionado
1. **Disponibilidade** - A base de conhecimento fica disponível para uso em espaços e por agentes de IA
### Capacidades
Cada base de conhecimento fornece os seguintes recursos:
+ **Indexação de conteúdo** - processa texto, documentos e dados estruturados de fontes externas
+ Pesquisa **semântica - Permite a pesquisa** baseada em IA em conteúdo indexado
+ **Sincronização automática** - Mantém o conteúdo up-to-date com agendas de sincronização configuráveis
+ **Controle de acesso de baixa granularidade** - garante que os usuários só recebam informações das bases de conhecimento que estão autorizados a acessar.
+ **Uso de vários espaços** - Pode ser usado em vários espaços e por diferentes agentes de IA
## Fluxo de trabalho geral
O fluxo de trabalho típico para trabalhar com bases de conhecimento segue estas etapas:
1. **Configure a integração da fonte de dados** - Conecte-se ao seu aplicativo externo (como SharePoint Google Drive ou Confluence) com a autenticação apropriada. Para obter mais informações, consulte [Guias específicos de integração](integration-guides.md).
1. **Crie uma base de conhecimento** - Você pode criar uma base de conhecimento enquanto configura sua nova integração. Configure seus filtros de conteúdo configurando filtros de inclusão, restrições de tipo de arquivo e seleções de pastas para focar no conteúdo relevante.
1. **Definir cronograma de sincronização** - A frequência de atualização de dados é definida como diária por padrão. Você pode editar a frequência de sincronização para configurar com que frequência a base de conhecimento deve ser atualizada com o novo conteúdo da fonte.
1. **Monitore e gerencie** - revise o status da sincronização, gerencie as permissões de acesso.
## Definições de configuração comuns
As bases de conhecimento compartilham padrões de configuração comuns em diferentes integrações de fontes de dados. Compreender essas configurações ajuda você a otimizar a indexação de conteúdo e gerenciar o comportamento de sincronização de forma eficaz.
**nota**
Embora essas opções de configuração estejam disponíveis na maioria das integrações, as configurações específicas e as opções disponíveis podem variar dependendo da integração da fonte de dados escolhida.
### Limites de tamanho e conteúdo do arquivo
Configure limites de tamanho de arquivo para otimizar o desempenho do processamento e gerenciar os custos de armazenamento. Os limites específicos variam de acordo com o tipo de conteúdo e são exibidos no console quando você configura sua base de conhecimento.
**Documentos de texto padrão**
Aplica-se a documentos como PDFs arquivos do Word e arquivos de texto. O limite de tamanho do arquivo é de 500 MB.
**Arquivos de vídeo**
Disponível quando o processamento de vídeo está ativado. Os formatos suportados incluem`.mp4`,`.mov`,`.m4v`. O limite de tamanho do arquivo é de 10 GB (10240 MB). O Quick Index suporta até **10 arquivos de vídeo por GB de armazenamento**. Se seu caso de uso exigir maiores volumes de vídeo, abra um ticket com o AWS suporte para estender esse limite.
**Arquivos de áudio**
Disponível quando o processamento de áudio está ativado. Os formatos compatíveis incluem `.mp3` ` .wav`` .m4a`,`.flac`,, ` .ogg` e. O limite é de 2 GB (2048 MB) para arquivos de áudio.
Arquivos com texto extraído que exceda o limite de 30 MB do sistema não são indexados, independentemente do tamanho do arquivo original. A quantidade máxima de texto que pode ser extraída de um único documento é de 30 MB.
**Imagens**
O Quick Index aplica os seguintes limites às imagens:
+ **Limite por documento**: 500 imagens por documento
+ **Limite por GB**: 10 mil imagens por GB de armazenamento de índice
+ **Limite por índice**: 2 milhões de imagens por índice
Se seu caso de uso exigir maiores volumes de imagem, abra um ticket com o AWS suporte para estender esses limites.
### Cronograma e salvaguardas de sincronização
Configure com que frequência sua base de conhecimento é atualizada e proteja-se contra a exclusão não intencional de conteúdo:
#### Frequência de sincronização
A frequência de atualização de dados é definida como diária por padrão. Você pode editar a frequência de sincronização para configurar com que frequência a base de conhecimento deve ser atualizada com o novo conteúdo da fonte
#### Proteção contra exclusão de documentos
Proteja seu conteúdo indexado contra exclusão acidental em massa definindo um limite máximo de porcentagem de exclusão. Se um trabalho de sincronização excluir mais documentos do que o limite permitido, a fase de exclusão será ignorada, preservando o conteúdo indexado existente.
Essa proteção protege contra problemas temporários de rede, alterações de permissão ou problemas no sistema de origem que podem tornar o conteúdo temporariamente indisponível.
# Melhores práticas para gerenciamento ACLs em bases de conhecimento
Ao usar bases de conhecimento com listas de controle de acesso (ACLs), você é responsável por manter as identidades e permissões dos usuários precisas. Isso garante que as pessoas certas possam acessar os documentos certos. Por padrão, o Quick sincroniza automaticamente as alterações de ACL em nível de documento e de identidade a cada 24 horas. Qualquer atualização de usuários ou permissões levará até um dia para aparecer no sistema, a menos que você tenha configurado um cronograma de atualização diferente para suas bases de conhecimento.
Para obter mais informações sobre a configuração ACLs de uma fonte de dados específica, consulte[Integração do Amazon S3](s3-integration.md).
**nota**
O Quick trata todos os endereços de e-mail como não diferenciando maiúsculas de minúsculas. `JohnDoe@example.com`,`johndoe@example.com`, e `JOHNDOE@example.com` são todos considerados o mesmo usuário.
## Cenários importantes de gerenciamento de usuários
**Compreendendo a vinculação de e-mail**
Os endereços de e-mail são vinculados dinamicamente aos usuários do Quick quando os usuários iniciam interações de bate-papo. Essa ligação segue uma first-come-first-serve abordagem. O primeiro usuário a conversar com um determinado endereço de e-mail estabelece a vinculação dessa identidade no namespace.
**Quando um funcionário deixa sua organização**
Quando um funcionário sair, limpe seu acesso imediatamente:
1. Atualize os arquivos de configuração da ACL para remover referências ao endereço de e-mail. Por exemplo, no Amazon S3, atualize o arquivo ACL global ou os arquivos de metadados.
1. Atualize as bases de conhecimento para aplicar as mudanças.
Isso evita possíveis problemas de segurança se o e-mail for posteriormente reatribuído a outra pessoa.
**Quando um endereço de e-mail é reatribuído a um novo funcionário**
+ O acesso à base de conhecimento com reconhecimento de ACL é bloqueado automaticamente para o endereço de e-mail reatribuído para proteger a segurança dos dados.
+ Entre em contato com o suporte rápido para limpar o acesso do usuário anterior antes que o novo funcionário possa acessar os documentos associados a esse e-mail.
## Limitações
Ao configurar o nível do documento ACLs para suas bases de conhecimento, esteja ciente dessas limitações:
+ A **configuração da ACL em nível de documento é permanente** — você não pode habilitá-la ACLs em bases de conhecimento criadas sem o suporte da ACL. Você também não pode desativar ACLs uma vez ativado. Para alterar a configuração da ACL, crie uma nova base de conhecimento com a configuração desejada desde o início.
+ **Endereços de e-mail compartilhados em um namespace** — Se vários usuários do Quick compartilharem o mesmo endereço de e-mail em um namespace, o sistema negará acesso a todos que usam esse e-mail compartilhado. Essa proteção evita a concessão acidental de acesso ao documento à pessoa errada.
+ **Escopo de resolução da ACL** — todos ACLs são resolvidos no namespace Quick do criador da base de conhecimento. Isso se aplica se ACLs forem especificados por endereço de e-mail ou nome do grupo. O Quick pesquisa identidades no contexto organizacional do criador para garantir uma resolução consistente de identidade.
+ **Tempo de reciclagem de endereços de e-mail** — Se sua organização reatribuir um endereço de e-mail de um funcionário para outro, há uma consideração importante sobre o tempo. Se o funcionário anterior nunca usou o Quick para interações de bate-papo ou IA e o e-mail for reatribuído antes da próxima atualização da ACL, o novo funcionário poderá acessar temporariamente os documentos destinados ao funcionário anterior.
Para evitar isso, conclua as seguintes etapas na ordem:
1. Atualize seu ACLs (se aplicável, como no Amazon S3) para remover o usuário antigo e adicionar o novo usuário.
1. Atualize manualmente sua base de conhecimento ou aguarde a atualização diária automática.
1. Atribua o endereço de e-mail ao novo funcionário.
Isso garante que as permissões de acesso sejam sincronizadas adequadamente antes que o novo usuário comece a usar o Quick.
+ **Compatibilidade de pesquisa** — As bases de conhecimento com nível de documento ACLs ativado atualmente não são compatíveis com a Pesquisa Rápida. Se você precisar usar documentos de uma base de conhecimento habilitada para ACL para fins de pesquisa, crie uma base de conhecimento separada sem ACLs usar esses documentos.
# Bases de conhecimento sobre solução de
Ao encontrar problemas com sua base de conhecimento do Quick, você pode usar este guia de solução de problemas para identificar e resolver problemas comuns. Os problemas da base de conhecimento geralmente envolvem sincronização de documentos, falhas na tarefa de atualização ou permissões de acesso.
## Os documentos não aparecem na sua base de conhecimento
Quando os documentos que você espera ver não aparecem na sua base de conhecimento, vários fatores podem causar esse problema.
**Causas comuns:**
+ **Sincronização em andamento** — Os documentos ainda podem estar sendo processados. Verifique o status da atualização para confirmar que a atualização foi concluída.
+ **Formato de arquivo incompatível** — Verifique se seus documentos estão em formatos compatíveis: Word, Excel, PDF PowerPoint, CSV, TXT, RTF, JSON, XML, HTML
+ **Tamanho do arquivo muito grande** — Cada arquivo deve ter menos de 50 MB.
+ **Permissões de acesso insuficientes** — Confirme se a base de conhecimento tem as permissões adequadas para acessar a fonte do documento.
+ **Filtragem de documentos** — Verifique se os filtros ou as regras de exclusão impedem que determinados documentos sejam indexados.
**Para solucionar problemas:**
1. Verifique o histórico de atualização para ver se há mensagens de erro relacionadas a documentos específicos que falharam na sincronização.
1. Verifique se os formatos de documentos e os tamanhos dos arquivos atendem aos requisitos.
1. Verifique suas permissões de acesso e configurações de conexão.
## Falha na tarefa de atualização
Normalmente, um trabalho de atualização falha quando há um erro de configuração na base de conhecimento ou na conexão da fonte de dados.
**Causas comuns:**
+ **Problemas de permissão** — A integração não tem permissões suficientes para acessar a fonte de dados.
+ **Erros de configuração** — Configurações incorretas URLs ou de conexão da fonte de dados.
+ **Limitações de recursos** — Limitação de taxa do sistema de origem.
**Para resolver:**
1. Verifique os detalhes do histórico de atualização para ver mensagens de erro específicas.
1. Verifique se todas as configurações e permissões de conexão estão configuradas corretamente.
1. Execute a ação recomendada com base na mensagem de erro.
## O trabalho de atualização é concluído com problemas
Quando um trabalho de atualização é concluído com problemas, o trabalho foi processado com êxito, mas encontrou problemas com alguns documentos.
**O que isso significa:**
+ **Sucesso parcial** — Alguns documentos foram sincronizados com sucesso, enquanto outros falharam.
+ **Erros em nível de documento** — arquivos individuais podem ter problemas de formatação, corrupção ou problemas de acesso.
+ Problemas de **metadados — Problemas** com metadados de documentos ou informações associadas.
+ **Violações de tamanho ou formato** — Alguns arquivos podem exceder os limites de tamanho ou estar em formatos incompatíveis.
**Para resolver:**
1. Analise os relatórios de atualização detalhados para identificar quais documentos tiveram problemas.
1. Resolva os problemas individuais dos documentos.
1. Execute outra atualização depois de resolver os problemas.
## O trabalho de atualização foi bem-sucedido, mas nenhum documento aparece
Se um trabalho de atualização for exibido como bem-sucedido, mas nenhum documento aparecer em sua base de conhecimento, verifique essas possíveis causas.
**Causas comuns:**
+ **Fonte vazia** — O local da fonte de dados configurada não contém documentos.
+ **Configuração de caminho incorreta** — O caminho de origem ou as configurações de conexão não apontam para o local correto.
+ **Filtros de documentos — os** critérios de inclusão ou exclusão podem filtrar todos os documentos.
+ **Permissões de leitura ausentes** — A tarefa foi conectada com sucesso, mas não tinha permissões para ler os documentos reais.
**Para resolver:**
1. Verifique se a configuração da fonte de dados aponta para o local correto.
1. Confirme se os documentos estão presentes no local especificado.
1. Verifique se as permissões de acesso apropriadas estão configuradas.
1. Revise todos os filtros de documentos que possam excluir conteúdo.
## Problemas de formato de arquivo durante a atualização
As bases de conhecimento rápidas oferecem suporte a formatos de arquivo específicos. Os arquivos devem atender aos requisitos de formato, tamanho e limite de caracteres.
**Requisitos:**
+ **Formatos suportados:** Word, Excel, PDF PowerPoint, CSV, TXT, RTF, JSON, XML, HTML
+ **Limite de tamanho de arquivo:** 50 MB por arquivo
+ **Condição do arquivo:** Não corrompido ou protegido por senha
**Para resolver problemas de formato:**
1. Verifique se seus arquivos atendem aos requisitos de formato e tamanho.
1. Converta formatos não suportados em formatos compatíveis.
1. Remova a proteção por senha dos arquivos.
1. Verifique se os arquivos não estão corrompidos.
## Erros de acesso negado
Os erros de acesso negado geralmente ocorrem devido a problemas de autenticação ou autorização.
**Causas comuns:**
+ **Credenciais inválidas — os** tokens ou senhas de autenticação podem ter expirado.
+ **Permissões insuficientes** — A conta usada na integração não tem acesso de leitura à fonte de dados.
+ **Restrições de rede** — O firewall ou as políticas de segurança bloqueiam o acesso.
+ Problemas de **SSL/TLS — Problemas** de certificado com conexões seguras.
**Para resolver:**
1. **Verifique as credenciais de autenticação** — confirme se as credenciais de autenticação são atuais e válidas. Edite a integração para reautenticar e gerar um novo token.
1. **Para fontes de dados de rastreadores da Web** — verifique se as conexões seguras estão configuradas corretamente e se os certificados SSL estão configurados e são confiáveis.
1. **Entre em contato com o administrador do sistema** — Se você continuar enfrentando problemas de acesso, entre em contato com o administrador do sistema. Talvez precisem ajustar as permissões ou as configurações de segurança.