Todos os produtos
Search
Central de documentação

Platform For AI:Gerenciar bases de conhecimento

Última atualização: Jun 27, 2026

As bases de conhecimento do LangStudio transformam documentos do OSS em índices vetoriais para geração aumentada por recuperação (RAG). Crie uma base de conhecimento uma única vez e reutilize-a em vários fluxos de aplicação.

Como funciona

Uma base de conhecimento converte arquivos do OSS em conteúdo recuperável por LLMs em três etapas:

  1. Leitura e fragmentação de dados: Lê os arquivos de origem no OSS e os divide em unidades processáveis.

    • Documentos não estruturados são analisados e divididos em blocos de texto menores e semanticamente completos (chunks).

    • Dados estruturados são fragmentados por linha.

    • Imagens são processadas integralmente, sem fragmentação.

  2. Vetorização: Chama um modelo de embedding para converter cada chunk ou imagem em um vetor numérico que representa seu significado semântico.

  3. Armazenamento e indexação: Armazena os dados vetoriais em um banco de dados vetorial e cria um índice para recuperação.

Primeiros passos

Crie uma base de conhecimento do tipo Documento e utilize-a em um fluxo de aplicação:

  1. Crie uma base de conhecimento. Acesse o LangStudio e selecione um workspace. Na aba Knowledge Base, clique em Create Knowledge Base. Configure os parâmetros abaixo e clique em OK.

    Parâmetro

    Descrição

    Basic Configuration

    Name

    Insira um nome personalizado para a base de conhecimento, como test_kg.

    Data Source OSS Path

    Local onde os arquivos de origem estão armazenados. Exemplo: oss://examplebucket.oss-cn-hangzhou-internal.aliyuncs.com/test/original/.

    Output OSS Path

    Armazena resultados intermediários de análise e dados de índice. A saída final depende do tipo de banco de dados vetorial selecionado. Exemplo: oss://examplebucket.oss-cn-hangzhou-internal.aliyuncs.com/test/output/.

    Importante

    Se a Instance RAM Role do runtime for a função padrão do PAI, defina este parâmetro como um diretório dentro do caminho de armazenamento padrão do workspace atual no bucket do OSS.

    Type

    Selecione Document.

    Embedding Model and Database

    Embedding Type

    Selecione Alibaba Cloud Model Studio Service (crie uma conexão primeiro, consulte Configuração de conexão) e, em seguida, selecione a conexão e o modelo.

    Vector Database Type

    Selecione FAISS para testes rápidos.

  2. Faça upload dos arquivos.

    1. Na aba Knowledge Base, clique na base de conhecimento desejada. Na página Overview, alterne para a aba Documents. Esta aba exibe os documentos da fonte de dados do OSS configurada.

    2. Adicione ou atualize arquivos usando o botão Upload ou faça upload diretamente na fonte de dados do OSS. Por exemplo, envie o arquivo rag_test_doc.txt pela página. Para formatos de arquivo suportados, consulte Tipos de base de conhecimento.

      image

  3. Atualize o índice. Após o upload dos arquivos, clique em Update Index no canto superior direito. Na caixa de diálogo, configure os recursos de computação e a rede. Quando a tarefa for concluída com êxito, o status do arquivo mudará para Indexed. Clique em um arquivo para visualizar seus chunks. Para bases de conhecimento de imagens, o sistema retorna listas de imagens.

    Nota

    Para chunks de documentos armazenados no Milvus, defina o status individualmente como Enabled ou Disabled. Chunks desativados não são recuperados durante as buscas.

    image

  4. Execute um teste de recuperação. Após atualizar o índice, alterne para a aba Recall Test. Insira uma consulta e ajuste os parâmetros de recuperação para testar o desempenho.

    image

  5. Use a base de conhecimento em um fluxo de aplicação. Após os testes, recupere informações da base de conhecimento em um fluxo de aplicação. No nó da base de conhecimento, ative os recursos de reescrita de consulta e reclassificação de resultados e visualize a consulta reescrita no rastreamento de execução.

    image

    O resultado é uma List[Dict]. Cada Dict possui as chaves content e score, que representam o chunk recuperado e sua pontuação de similaridade com a consulta.

    [
      {
        "score": 0.8057173490524292,
        "content": "Due to the uncertainty caused by the pandemic, XX Bank proactively increased provisions for impairment losses on loans, advances, and non-credit assets based on economic trends and forecasts for China or the Chinese mainland. The bank also increased the write-off and disposal of non-performing assets to improve the provision coverage ratio. In 2020, the net profit reached 28.928 billion CNY, a year-on-year increase of 2.6%, and profitability gradually improved.\n(CNY in millions) 2020 2019 Change (%)\nOperating Results and Profitability\nOperating Income 153,542 137,958 11.3\nOperating Profit Before Impairment Losses 107,327 95,816 12.0\nNet Profit 28,928 28,195 2.6\nCost-to-Income Ratio(1)(%) 29.11 29.61 down 0.50 percentage points\nAverage Return on Total Assets (%) 0.69 0.77 down 0.08 percentage points\nWeighted Average Return on Equity (%) 9.58 11.30 down 1.72 percentage points\nNet Interest Margin(2)(%) 2.53 2.62 down 0.09 percentage points\nNote: (1) Cost-to-Income Ratio = Business and management fees / Operating income.",
        "id": "49f04c4cb1d48cbad130647bd0d75f***1cf07c4aeb7a5d9a1f3bda950a6b86e",
        "metadata": {
          "page_label": "40",
          "file_name": "2021-02-04_XX_Insurance_Group_Co_Ltd_XX_China_XX_2020_Annual_Report.pdf",
          "file_path": "oss://my-bucket-name/datasets/chatglm-fintech/2021-02-04__XX_Insurance_Group_Co_Ltd__601318__China_XX__2020_Annual_Report.pdf",
          "file_type": "application/pdf",
          "file_size": 7982999,
          "creation_date": "2024-10-10",
          "last_modified_date": "2024-10-10"
        }
      },
      {
        "score": 0.7708036303520203,
        "content": "7.2 billion CNY, a year-on-year increase of 5.2%.\n2020\n(CNY in millions) Life and Health Insurance Business, Property and Casualty Insurance Business, Banking Business, Trust Business, Securities Business, Other Asset Management Business, Technology Business, Other Business and Consolidation Elimination, Group Consolidated\nNet profit attributable to shareholders of the parent company 95,018 16,083 16,766 2,476 2,959 5,737 7,936 (3,876) 143,099\nMinority interest 1,054 76 12,162 3 143 974 1,567 281 16,260\nNet profit (A) 96,072 16,159 28,928 2,479 3,102 6,711 9,503 (3,595) 159,359\nItems excluded:\n Short-term investment fluctuation(1)(B) 10,308 – – – – – – – 10,308\n Impact of discount rate change (C) (7,902) – – – – – – – (7,902)\n One-time significant items and others excluded by management as not part of daily operating income and expenditure (D) – – – – – – 1,282 – 1,282\nOperating profit (E=A-B-C-D) 93,666 16,159 28,928 2,479 3,102 6,711 8,221 (3,595) 155,670\nOperating profit attributable to shareholders of the parent company 92,672 16,",
        "id": "8066c16048bd722d030a85ee8b1***36d5f31624b28f1c0c15943855c5ae5c9f",
        "metadata": {
          "page_label": "19",
          "file_name": "2021-02-04_XX_Insurance_Group_Co_Ltd_XXX_China_XX_2020_Annual_Report.pdf",
          "file_path": "oss://my-bucket-name/datasets/chatglm-fintech/2021-02-04__XX_Insurance_Group_Co_Ltd__601318__China_XX__2020_Annual_Report.pdf",
          "file_type": "application/pdf",
          "file_size": 7982999,
          "creation_date": "2024-10-10",
          "last_modified_date": "2024-10-10"
        }
      }
    ]

Recursos

Tipo de base de conhecimento

Escolha o tipo de base de conhecimento correspondente aos seus arquivos:

  • Documentos: Suporta .html, .htm, .pdf, .txt, .docx, .md e .pptx.

  • Dados estruturados: Compatível com .jsonl, .csv, .xlsx e .xls.

  • Imagens: Aceita .jpg, .jpeg, .png e .bmp.

Configurações especiais:

  • Para bases de conhecimento do tipo Documento, configure a Chunk Configuration. Esses campos são obrigatórios. Para obter orientações sobre como definir parâmetros de fragmentação, consulte Ajuste de parâmetros de fragmentaçãofragmentação.

    • Chunk Size: Número máximo de caracteres por chunk de texto. Padrão: 1024 caracteres.

    • Chunk Overlap: Quantidade de caracteres sobrepostos entre chunks adjacentes para garantir continuidade contextual. Padrão: 200 caracteres.

  • Em bases de conhecimento de dados estruturados, configure as Field Settings. Faça upload de um arquivo (como animal.csv) ou adicione campos manualmente para especificar quais campos de dados participam da indexação e recuperação.

Escolha um banco de dados vetorial

  • Ambientes de produção: Utilize Milvus ou Elasticsearch, que oferecem suporte ao processamento de dados vetoriais em grande escala.

  • Ambiente de teste: Utilize FAISS, que não exige banco de dados adicional. Os arquivos da base de conhecimento e os arquivos de índice gerados são armazenados no Output OSS Path. O FAISS é adequado para testes funcionais ou pequenos conjuntos de dados, mas o desempenho pode diminuir com grandes volumes de dados.

    Nota

    Bases de conhecimento do tipo Imagem não suportam FAISS.

Estratégia de atualização de índice

Método de atualização

Descrição

Observações

Atualização manual

Clique em Update Index no console. Ideal quando os arquivos mudam com pouca frequência.

Processa arquivos de forma completa ou incremental.

Atualização automática

Cria uma regra no EventBridge que aciona a indexação quando há alterações nos arquivos do OSS.

Importante

Taxas de mensagens são cobradas durante atualizações automáticas.

  • As regras levam alguns minutos para entrar em vigor. Aguarde pelo menos 3 minutos antes de modificar arquivos no OSS.

  • Regiões suportadas atualmente: China (Hangzhou), China (Shanghai), China (Beijing), China (Ulanqab) e China (Shenzhen).

Atualização agendada

Utiliza uma tarefa recorrente do DataWorks para atualizar o índice conforme uma programação (por exemplo, diariamente).

Depende do DataWorks. Tarefas recorrentes entram em vigor em base T+1 (configurações feitas hoje serão executadas amanhã).

Métodos de configuração:

Atualização manual

Clique em Update Index. O sistema envia uma tarefa de workflow do PAI para pré-processar, fragmentar, vetorizar e indexar os arquivos. Parâmetros da tarefa:

Parâmetro

Descrição

Recurso de computação

Recursos de computação para nós do workflow. Use recursos públicos ou utilize recursos Lingjun e recursos de computação geral por meio de cotas de recursos.

  • Para bases de conhecimento do tipo Imagem, o número de nós deve ser superior a 2.

  • Para extrair gráficos de alta qualidade de PDFs complexos, use recursos GPU com driver versão 550 ou superior ao atualizar o índice. O sistema utiliza automaticamente modelos de reconhecimento de gráficos ou OCR para tarefas que atendem aos requisitos de tipo de recurso e versão do driver. As imagens são armazenadas no diretório chunk_images do caminho de saída. Quando usadas em um fluxo de aplicação, as imagens no texto são substituídas por uma tag HTML <img>, como <img src="temporary-signed-url">.

Configuração de VPC

Se acessar o banco de dados vetorial ou o serviço de Embedding via rede interna, garanta que a VPC selecionada seja a mesma ou possa se comunicar com as VPCs desses serviços.

Configuração de Embedding

  • Concorrência máxima (obrigatório para bases de conhecimento do tipo Imagem): Número de solicitações simultâneas ao serviço de Embedding. Como o serviço de modelo multimodal do Model Studio limita as solicitações a 120 por minuto, aumentar essa concorrência pode acionar limitação de taxa.

  • Tamanho do lote (obrigatório para bases de conhecimento do tipo Documento/Dados estruturados): Número de chunks de texto processados em cada lote durante a vetorização. Definir um valor apropriado com base no limite de QPS do serviço de modelo pode melhorar a velocidade de processamento.

Atualização automática

  1. Acesse o console do EventBridge e ative o EventBridge.

  2. Configure as atualizações automáticas de índice. Acesse a página de detalhes da base de conhecimento. Na aba Overview, na seção Automatic File Indexing no canto inferior direito, clique em Modify.image

  3. Configure os recursos de computação e a VPC e clique em OK. Depois disso, alterações nos arquivos acionam automaticamente tarefas de indexação sem intervenção manual.

    Importante

    Os recursos de computação configurados aqui são usados apenas quando os arquivos são atualizados. Nenhuma taxa de recurso será cobrada se os arquivos não forem alterados.

  4. Faça alterações nos arquivos do OSS.

    • Após configurar atualizações automáticas de arquivos, há um atraso de alguns minutos até que as regras entrem em vigor. Aguarde pelo menos 3 minutos antes de operar nos arquivos.

    • Para excluir um arquivo usando a API do OSS, especifique uma versão para acionar o evento de alteração.

    • Para excluir um arquivo no console, selecione o arquivo e clique em Permanently Delete na parte inferior.

      image

  5. Visualize as tarefas de indexação. Após a alteração de um arquivo, aguarde cerca de 3 minutos. A tarefa de construção de índice acionada automaticamente aparecerá na lista de registros de operação.

Atualização agendada

Importante

O recurso de atualização agendada depende do DataWorks. Certifique-se de ter ativado este serviço. Caso não esteja ativado, consulte o Guia de compra.

Na página de detalhes da base de conhecimento, clique em More > Configure Scheduling no canto superior direito, conclua as configurações e envie.

image

  • Visualize configurações de agendamento e tarefas recorrentes

    O sistema cria um workflow no DataWorks DataStudio e o publica como uma tarefa recorrente no DataWorks Operation Center. Tarefas recorrentes entram em vigor em base T+1. Visualize a configuração de agendamento na página de configuração de agendamento da base de conhecimento.

    image

  • Descrições dos parâmetros de configuração agendada:

    • Ciclo de agendamento: Frequência com que o nó é executado em produção (quantidade de instâncias de ciclo geradas e quando são executadas).

    • Horário agendado: Momento específico em que o nó é executado.

    • Definição de tempo limite: Duração após a qual um nó em execução falha e encerra.

    • Data de vigência: Intervalo de tempo durante o qual o nó é executado em seu agendamento automático. Fora desse intervalo, o nó deixa de ser agendado automaticamente.

    • Grupo de recursos de agendamento: Usado para atualizações agendadas do DataWorks. Se você ainda não criou um grupo de recursos do DataWorks, clique em Create Now na lista suspensa para acessar a página de criação. Após a criação, vincule o grupo de recursos ao workspace atual.

      image

    Os parâmetros de agendamento são descritos em Descrição da configuração de propriedades de tempo.

Visualize o conjunto de dados

Após uma atualização de índice bem-sucedida, o sistema registra o Output OSS Path como um conjunto de dados. Visualize-o em AI Asset Management - Datasets. O conjunto de dados compartilha o nome da base de conhecimento e registra a saída da construção do índice.

image

Configure o runtime

Selecione um runtime para visualizar chunks e executar testes de recuperação. Essas operações acessam o banco de dados vetorial e o serviço de Embedding.

Requisitos do runtime:

  • Se acessar o banco de dados vetorial ou o serviço de Embedding via endereço de rede interna, garanta que a VPC do runtime seja a mesma ou possa se comunicar com as deles.

  • Se selecionar uma função personalizada para Instance RAM Role, conceda a essa função permissões de acesso ao OSS (recomendamos AliyunOSSFullAccess). Consulte Concessão de permissões a uma função RAM.

Importante

Se a versão do runtime estiver desatualizada (anterior à 2.1.4), ela pode não aparecer na lista suspensa. Crie um novo runtime.

Gerencie múltiplas versões

Clone uma versão testada da base de conhecimento como uma nova versão oficial para isolar ambientes de desenvolvimento e produção.

Alterne entre versões usando a lista suspensa ao lado do tipo na página de detalhes da base de conhecimento. Selecione a versão desejada no nó da base de conhecimento de um fluxo de aplicação.

image

A clonagem envia uma tarefa de workflow visível nos registros de operação.

image

Configure parâmetros de recuperação

  • Top K: Máximo de chunks relevantes a serem recuperados. Intervalo: 1 a 100.

  • Limiar de pontuação: Limiar de pontuação de similaridade (0 a 1). Apenas chunks com pontuação acima deste valor são retornados.

  • Padrão de recuperação: O padrão é Dense (vetor). A recuperação híbrida (vetor + palavra-chave) requer Milvus 2.4.x+ ou Elasticsearch. Consulte Selecionar um modo de recuperação.

  • Condição de filtro de metadados: Restringe o escopo de busca usando metadados. Consulte Usar metadados.

  • Reescrita de consulta: Usa um LLM para esclarecer consultas vagas ou dependentes de contexto, melhorando a precisão da recuperação. Consulte Reescrita de consulta.

  • Reclassificação de resultados: Usa um modelo de reclassificação para reordenar resultados, colocando os mais relevantes no topo. Consulte Reclassificação de resultados.

    Nota

    Requer um modelo de reclassificação. Tipos de conexão suportados: Model Studio, AI Search Open Platform Model Service e General Reranker Model Service.

Otimize o desempenho de recuperação

Ajuste parâmetros de fragmentação

Princípios orientadores

  1. Limite de contexto do modelo: O tamanho do chunk não deve exceder o limite de tokens do modelo de Embedding.

  2. Integridade da informação: Os chunks devem conter significado semântico completo, sem excesso de ruído. Considere fragmentar por parágrafo para textos estruturados.

  3. Mantenha a continuidade: Defina a sobreposição como 10%-20% do tamanho do chunk para evitar perda de contexto nas fronteiras.

  4. Evite interferência repetitiva: Sobreposição excessiva introduz redundância e reduz a eficiência da recuperação.

Sugestões de depuração

  • Otimização iterativa: Comece com um valor inicial (como tamanho de chunk de 300 e sobreposição de 50) e itere com base nos resultados de recuperação e P&R para encontrar as configurações ideais para seus dados.

  • Limites de linguagem natural: Se seu texto tiver uma estrutura clara (por exemplo, dividido por capítulos ou parágrafos), considere dividi-lo ao longo de seus limites naturais para preservar a integridade semântica.

Guia rápido de otimização

Problema

Sugestão de otimização

Resultados de recuperação irrelevantes

Aumente o tamanho do chunk, diminua a sobreposição do chunk.

Contexto do resultado incoerente

Aumente a sobreposição do chunk.

Não encontra correspondência adequada (baixa revocação)

Aumente moderadamente o tamanho do chunk.

Custos elevados de computação ou armazenamento

Diminua o tamanho do chunk, diminua a sobreposição do chunk.

A tabela a seguir fornece tamanhos recomendados de chunk e sobreposição para diferentes tipos de texto com base em experiências anteriores:

Tipo de texto

Tamanho de chunk recomendado (chunk_size)

Tamanho de sobreposição recomendado (chunk_overlap)

Texto curto (FAQ, resumo)

100 a 300

20 a 50

Texto regular (notícias, blog)

300 a 600

50 a 100

Documentos técnicos (API, artigo acadêmico)

600 a 1024

100 a 200

Documentos longos (jurídico, livro)

1024 a 2048

200 a 400

Escolha um modo de recuperação

Cada modo de recuperação tem pontos fortes adequados a diferentes cenários:

  • Recuperação densa (vetorial): Excelente para compreender semântica. Converte tanto a consulta quanto os documentos em vetores e determina a relevância semântica calculando a similaridade vetorial.

  • Recuperação esparsa (palavra-chave): Destaca-se na correspondência exata. Baseada em modelos tradicionais de frequência de termos (como BM25), calcula a relevância com base na frequência e posição da palavra-chave em um documento.

  • Recuperação híbrida: Combina o melhor de ambos. Mescla resultados de busca vetorial e busca por palavra-chave e os reclassifica usando algoritmos como Reciprocal Rank Fusion (RRF) ou fusão ponderada.

Modo de recuperação

Prós e contras

Cenários

Recuperação densa (vetorial)

  • Prós: Forte compreensão semântica, captura relações complexas como sinônimos e contexto. Lida bem com consultas complexas, adequado para textos longos e P&R de domínio aberto.

  • Contras: Insensível a palavras-chave, pode perder correspondências exatas de termos; o desempenho depende da qualidade do modelo de Embedding.

  • P&R de domínio aberto: Cenários que exigem compreensão semântica profunda (como recuperação de artigos acadêmicos, P&R de conhecimento geral).

  • Cenários de polissemia/sinônimos: Quando a consulta e o documento usam palavras diferentes, mas têm significados relacionados (ex.: "doença cardíaca" vs. "infarto do miocárdio").

  • Correspondência de texto longo: Recuperação de parágrafos de documentos técnicos ou relatórios extensos.

Recuperação esparsa (palavra-chave)

  • Prós: Correspondência precisa de palavras-chave, resultados altamente interpretáveis e fáceis de depurar.

  • Contras: Não compreende semântica, tem baixo desempenho com sinônimos ou terminologia inconsistente. Depende da qualidade da tokenização e é sensível a erros de ortografia e tokenização.

  • Recuperação de dados estruturados: Como consultas de campos de banco de dados ou correspondência de dados tabulares.

  • Cenários específicos de palavras-chave: Quando usuários inserem termos precisos (ex.: "formato de endereço IPv6").

  • Idiomas com poucos recursos: Não requer modelos vetoriais pré-treinados de alta qualidade, adequado para idiomas com escassez de recursos.

Recuperação híbrida

  • Prós: Equilibra compreensão semântica e correspondência de palavras-chave, é mais robusta (mantém o desempenho mesmo se um modo falhar) e geralmente oferece os melhores resultados.

  • Contras: Requer a execução de dois sistemas de recuperação simultaneamente, resultando em custos de computação mais altos. Exige ajuste de pesos de fusão e parâmetros, o que pode ser complexo.

  • Requisitos mistos complexos: Quando tanto a correspondência semântica quanto a correspondência exata de palavras-chave são necessárias (ex.: P&R médica que precisa entender descrições de sintomas e corresponder a termos profissionais).

  • Alta demanda por diversidade de resultados: Para evitar homogeneidade causada por um único modo de recuperação (ex.: busca de e-commerce que precisa cobrir necessidades de usuários "sensíveis a preço" e "semanticamente relacionadas").

  • Fase de cold-start: Quando modelos vetoriais de alta qualidade não estão disponíveis, misturar resultados de palavras-chave pode melhorar o desempenho inicial.

Use metadados para filtrar a recuperação

Valor da filtragem por metadados

  1. Recuperação precisa, menos ruído: Metadados podem servir como filtro durante a recuperação. Filtrar com metadados permite excluir documentos irrelevantes e impede que o modelo generativo receba conteúdo não relacionado. Por exemplo, quando um usuário pergunta "Encontre romances de ficção científica escritos por Liu Cixin", o sistema pode usar as condições de metadados author=Liu Cixin e category=science fiction para localizar diretamente os documentos mais relevantes.

  2. Experiência do usuário aprimorada

    • Recomendações personalizadas: Use metadados para fornecer recomendações personalizadas com base nas preferências históricas de um usuário (como preferência por documentos de "ficção científica").

    • Interpretabilidade aprimorada: Incluir metadados de um documento (como autor, fonte, data) nos resultados ajuda os usuários a julgar sua credibilidade e relevância.

    • Suporte à expansão multilíngue ou multimodal: Metadados como "idioma" ou "tipo de mídia" simplificam o gerenciamento de bases de conhecimento com vários idiomas ou mídias mistas, como texto e imagens.

Como usar

Importante

Limitações do recurso:

  • Versão da imagem do runtime: Deve ser 2.1.8 ou posterior.

  • Banco de dados vetorial: Apenas Milvus e Elasticsearch são suportados.

  • Tipo de base de conhecimento: Suporta documentos ou dados estruturados. Imagens não são suportadas.

  1. Configure variáveis de metadados. Para bases de conhecimento que usam Milvus, localize a seção Metadata na aba Overview. Clique em Edit para configurar variáveis (por exemplo, uma variável chamada author). Não use campos reservados.

    image

  2. Marque documentos. Acesse a página de detalhes do chunk do documento, clique em Edit Metadata e adicione a variável de metadados e seu valor (por exemplo, author=Alex). Na página Overview, visualize o uso de metadados e a contagem de valores.

    image

  3. Teste o efeito de filtragem. Na aba Recall Test, adicione uma condição de filtro de metadados e execute um teste.

    image

    Nota: Os documentos recuperados na imagem foram marcados na etapa 2.

  4. Use em um fluxo de aplicação. Configure a condição de filtro de metadados no nó da base de conhecimento.

    image

Reescrita de consulta e reclassificação de resultados

Reescrita de consulta

Reescreve consultas vagas, coloquiais ou dependentes de contexto em perguntas claras e independentes para melhor recuperação.

  • Cenários recomendados:

    • A consulta do usuário é vaga ou incompleta (ex.: "Quando ele nasceu?" sem contexto).

    • Em uma conversa de múltiplas voltas, a consulta depende do contexto (ex.: "O que ele fez depois disso?").

    • O recuperador ou LLM tem baixo desempenho e não compreende a consulta com precisão.

    • Uso de método tradicional de recuperação por índice invertido (como BM25) em vez de recuperação semântica.

  • Não recomendado para:

    • A consulta do usuário já é muito clara e específica.

    • O LLM tem excelente desempenho e forte compreensão da consulta.

    • O sistema exige baixa latência e não pode arcar com atrasos adicionais da reescrita.

Reclassificação de resultados

Reordena os resultados de recuperação para priorizar os documentos mais relevantes.

  • Cenários recomendados:

    • O recuperador inicial fornece resultados instáveis (como de BM25 ou DPR).

    • A classificação dos resultados de recuperação é crítica (como exigir alta precisão Top-1 em sistemas de busca ou P&R).

  • Não recomendado para:

    • O sistema tem recursos limitados e não pode arcar com sobrecarga adicional de inferência.

    • O desempenho do recuperador inicial já é suficientemente forte e a reclassificação oferece melhoria limitada.

    • O tempo de resposta é crítico, como em cenários de busca em tempo real.

FAQ

Como solucionar falhas em tarefas de atualização de índice ou clonagem de versão?

Siga estas etapas quando uma tarefa falhar:

  1. Visualize registros de operação: Na página de detalhes da base de conhecimento, localize a tarefa com falha nos Operation Records e clique em View Task.

    image

  2. Verifique os logs da tarefa: O sistema redireciona você para a página de workflow do PAI. Verifique os logs do nó com falha.

    image

    Por exemplo, a tarefa de workflow para atualizar o índice de uma base de conhecimento do tipo Documento inclui os três nós a seguir. Exceto pelo nó read-oss-file, cada nó cria uma tarefa PAI-DLC. Você também pode visualizar detalhes da tarefa DLC através da URL da tarefa nos logs.

    • read-oss-file: Lê arquivos do OSS.

    • rag-parse-chunk: Responsável pelo pré-processamento e fragmentação de documentos.

    • rag-sync-index: Responsável por gerar embeddings dos chunks de texto e sincronizá-los com o banco de dados vetorial.

Por que arquivos de sistema (como requirements.txt) aparecem na base de conhecimento?

Causa: A base de conhecimento indexa todos os arquivos no Input OSS Path configurado. Defini-lo como a raiz do projeto pode indexar involuntariamente arquivos de sistema como requirements.txt, .DS_Store, .git/, __pycache__/ ou *.pyc.

Solução:

  1. Crie um diretório dedicado (por exemplo, knowledge-base-docs/) no OSS contendo apenas os arquivos que deseja indexar.

  2. Atualize o Input OSS Path da base de conhecimento para apontar para este diretório.

  3. Arquivos comuns a excluir: requirements.txt, .DS_Store, .git/, __pycache__/, *.pyc, *.log.

Como remover arquivos indexados incorretamente da base de conhecimento?

Para remover um arquivo já indexado dos resultados de recuperação:

  1. Exclua do OSS: Remova o arquivo usando um destes métodos:

    • Console: Selecione o arquivo e clique em Permanently Delete.

    • API: Especifique um parâmetro de versão para acionar o evento de alteração.

  2. Aguarde a reindexação automática: Se você configurou a Automatic Update (consulte Atualização automática):

    • Aguarde pelo menos 3 minutos para que a regra entre em vigor.

    • Verifique a aba Operation Records para confirmar que a tarefa de reindexação foi concluída.

  3. Atualização manual (se a atualização automática não estiver configurada): Clique em Update Index no canto superior direito para acionar uma reindexação completa.

  4. Verifique a remoção: Confira a aba Documents para confirmar que o status do arquivo mudou de Indexed para removido.

Nota

Os registros de índice podem levar alguns minutos para se propagarem totalmente ao banco de dados vetorial. Se o arquivo ainda afetar a recuperação após a reindexação, tente acionar outra atualização manual de índice.