Alibaba Cloud Model Studio:Base de conhecimento

Criar uma base de conhecimento

Ao clicar em Create Knowledge Base, crie a base de conhecimento em três etapas: forneça informações básicas e selecione um tipo de base de conhecimento, configure uma fonte de dados e defina parâmetros de índice.

1. Na página de base de conhecimento, clique em Create Knowledge Base.

2. Informações básicas

   Selecione um Knowledge Base Type conforme seu caso de uso. Uma única base de conhecimento suporta apenas um tipo. Se escolher o tipo document search, selecione também um caso de uso: Basic document Q&A, Rich-text Reply.

   • Basic document Q&A: Ideal para busca semântica em documentos de texto simples.

   • Rich-text Reply: Recomendado para casos de uso que exigem respostas contendo texto e imagens.

   Não é possível alterar o tipo da base de conhecimento após sua criação.

   • Document search

     • Casos de uso:

       • Projetado para recuperar informações de dados não estruturados, como documentos corporativos internos e manuais de produtos. Dados não estruturados são informações não organizadas em um modelo ou esquema predefinido, podendo incluir texto, tabelas e imagens.

       • Se seus arquivos contiverem imagens que devem ser incluídas nas respostas da aplicação, selecione document search.

     • Fonte de dados: Faça upload de arquivos locais ou importe-os do Object Storage Service (OSS).

       Criação de busca em documentos

       1. Selecionar dados: Especifique uma fonte de dados (arquivos ou conteúdo) para a base de conhecimento. O sistema importa o conteúdo da fonte para a base de conhecimento visando a recuperação. Utilize upload local ou importação da nuvem (selecionando uma categoria ou arquivo existente).

          • Upload local: Carregue arquivos diretamente do seu computador. Expanda o painel retrátil abaixo para saber como selecionar um método de análise.

            Métodos de análise

            Configure a estratégia de análise conforme suas necessidades. Se não tiver certeza de qual opção escolher, recomendamos usar as configurações padrão.

            • Digital Parsing: Não analisa ilustrações ou gráficos nos arquivos. Este é o método de análise mais rápido. Um documento de texto simples de 10 a 20 páginas é geralmente analisado em poucos segundos a 1 minuto.

            • Intelligent Document Parsing: Reconhece e extrai texto de ilustrações nos arquivos para gerar resumos textuais. Esses resumos, juntamente com outro conteúdo não imagético, são então fragmentados e vetorizados para recuperação. Este método é relativamente rápido. Um documento de 10 a 20 páginas com ilustrações leva tipicamente de 1 a 5 minutos para ser analisado.

            • LLM Parsing: Permite que aplicações usando o modelo Qwen-VL respondam a perguntas sobre o conteúdo de ilustrações e gráficos nos arquivos. Para ativar o reconhecimento e compreensão desse conteúdo, selecione LLM Parsing. Como este método chama um LLM para compreensão profunda, um documento de 10 a 20 páginas com gráficos leva tipicamente de 2 a 10 minutos para ser analisado.

            • Análise Qwen-VL: Projetada especificamente para arquivos de imagem. Especifique um modelo Qwen-VL e forneça um prompt para orientar o reconhecimento e extração do layout e elementos da imagem. Uma única imagem é tipicamente analisada em poucos segundos a 1 minuto.

          • Importação da nuvem: Importe arquivos existentes de Object Storage Service (OSS).

       2. Configuração de índice: Define como os dados importados são processados e armazenados, afetando diretamente o desempenho de recuperação.

          Dentre as configurações a seguir, apenas o armazenamento vetorial com AnalyticDB for PostgreSQL (ADB-PG) pode incorrer em taxas. Todas as outras configurações são gratuitas.

          Extração de metadados

          Metadados consistem em atributos adicionais para dados não estruturados, integrados aos trechos como pares chave-valor.

          • Finalidade: Metadados fornecem contexto importante para os trechos e podem melhorar significativamente a precisão da recuperação da base de conhecimento. Por exemplo, considere uma base de conhecimento com milhares de arquivos de introdução de produtos onde o nome do arquivo é o nome do produto. Quando um usuário busca por "visão geral funcional do Produto A", se o corpo de todos os arquivos contiver "visão geral funcional", mas nenhum mencionar "Produto A", a base de conhecimento poderá recuperar muitos trechos irrelevantes. No entanto, se você adicionar o nome do produto como metadado a todos os trechos, a base de conhecimento conseguirá filtrar com precisão os trechos relacionados ao "Produto A" que também contenham "visão geral funcional". Isso melhora a precisão da recuperação e reduz o consumo de tokens de entrada do LLM.

          • Uso: Ao chamar uma aplicação via API, especifique metadata no parâmetro de solicitação metadata_filter. Quando a aplicação recupera informações da base de conhecimento, ela filtra primeiro os arquivos relevantes com base nos metadata especificados.

          • Nota: Não é possível configurar a extração de metadados após a criação da base de conhecimento.

          Configuração de metadados

          Ative a Extração de metadados e clique em Settings para anexar metadados uniformes ou personalizados a todos os arquivos na base de conhecimento. Durante a fragmentação, os metadados de cada arquivo são integrados aos seus respectivos trechos.

          Novo modelo de metadados

          Métodos de extração de valores

          • Constante: Anexa um atributo fixo a todos os arquivos na base de conhecimento.

            Conforme mostrado no exemplo anterior, se todos os arquivos na base de conhecimento tiverem o mesmo autor, defina uma constante para um campo chamado author .

          • Variável: Anexa um atributo variável a cada arquivo na base de conhecimento. Os atributos suportados atualmente são file_name e cat_name. Se selecionar file_name, o Alibaba Cloud Model Studio anexa o nome do arquivo aos seus metadados, conforme mostrado no exemplo anterior. Se selecionar cat_name, o Alibaba Cloud Model Studio anexa o nome da categoria que contém o arquivo aos metadados do arquivo.

          • LLM: O sistema compara o conteúdo do arquivo com a regra de Entity Description configurada, extrai as informações relevantes e as anexa como um atributo de metadado.

            Conforme mostrado no modelo de metadados do exemplo anterior, para extrair todos os anos que aparecem em cada arquivo como atributos de arquivo, configure um campo LLM chamado date . A descrição da entidade é configurada da seguinte forma:

            Na caixa de entrada Entity Description, insira date information, extract only the year e clique em OK.

          • RegEx: O sistema compara o conteúdo textual de cada arquivo na base de conhecimento com a expressão regular especificada. O conteúdo correspondente à expressão é extraído e adicionado como um atributo aos metadados do arquivo.

            Conforme mostrado no modelo de metainformações do exemplo acima, se precisar extrair todas as referências que aparecem em cada arquivo (assumindo que uma referência seja qualquer texto que comece com '《' e termine com '》'), configure um campo de expressão regular chamado reference . A expressão regular é configurada da seguinte forma:

            Defina o valor da expressão regular como 《.*?》.

          • Busca por palavras-chave: O sistema pesquisa palavras-chave predefinidas em cada arquivo e adiciona as palavras-chave correspondentes como atributos aos metadados do arquivo.

            Por exemplo, no modelo de metadados do exemplo anterior, as palavras-chave predefinidas são:

            Como o arquivo contém apenas as palavras-chave "financiamento", "indústria", "verde" e "capital", o sistema extrai apenas essas quatro palavras-chave como valor para o atributo keywords do arquivo.

          Usado para Recuperação: Se ativado, o campo e o valor de metadados são usados para recuperação na base de conhecimento junto com o conteúdo do trecho. Se desativado, apenas o conteúdo do trecho é usado para recuperação.

          Usado para Resposta do Modelo: Se ativado, o campo e o valor de metadados são fornecidos ao LLM como entrada para geração de resposta junto com o conteúdo do trecho. Se desativado, apenas o conteúdo do trecho é fornecido ao LLM para geração de resposta.

          Montagem de cabeçalho Excel

          Quando ativado, a base de conhecimento trata a primeira linha de todos os arquivos XLSX e XLS como cabeçalho e a anexa automaticamente a cada trecho (linha de dados). Isso evita que o LLM interprete erroneamente o cabeçalho como uma linha de dados comum.

          Escopo: Esta configuração aplica-se apenas a arquivos de tabela XLSX e XLS na base de conhecimento, tratando a primeira linha de cada arquivo como cabeçalho. Não se aplica a formatos não tabulares como PDF, Word ou Markdown. A configuração entra em vigor quando a base de conhecimento é criada (durante a fragmentação de documentos) e, assim como a estratégia de fragmentação, não pode ser alterada após a criação da base de conhecimento.

          Lógica de processamento: A base de conhecimento fragmenta arquivos de tabela por linha de dados: cada linha, exceto a primeira (cabeçalho), torna-se um trecho separado. Quando esta configuração está ativada, a linha de cabeçalho é automaticamente anexada a cada trecho de linha de dados, de modo que cada trecho carrega tanto os nomes das colunas (cabeçalho) quanto os dados da linha. Isso permite que o LLM interprete cada campo corretamente com base no nome da coluna, e a linha de cabeçalho deixa de ser processada como uma linha de dados comum, evitando confusão semântica durante a recuperação e perguntas e respostas.

          Não é necessário ativar esta configuração se a base de conhecimento contiver arquivos em outros formatos, como PDF, ou se os arquivos de tabela não contiverem uma linha de cabeçalho.

          Método de fragmentação

          Selecione fragmentação inteligente (recomendado).

          Finalidade: Uma base de conhecimento divide arquivos em trechos e os converte em vetores usando um modelo de embedding. Os trechos e vetores são então armazenados como pares chave-valor em um banco de dados vetorial. Após a criação da base de conhecimento, visualize ou edite o conteúdo específico (texto e imagens) de cada trecho.

          Título do trecho: Além do conteúdo do corpo, cada trecho carrega um título exibido na lista de trechos, usado para identificar o trecho e incluído na recuperação. A base de conhecimento gera o título do trecho automaticamente durante a análise inteligente de documentos , com base na hierarquia de títulos detectada. Possui duas formas: um título curto ( title , o título mais próximo ao qual o trecho pertence) e um título hierárquico ( hier_title , o caminho completo do título de nível superior até o título atual, com níveis unidos por |> , por exemplo Heading 1|>Heading 2 ). Portanto, quanto mais clara for a estrutura de títulos de um documento (como arquivos PDF, Word ou Markdown com títulos de seção bem formados), mais completos serão os títulos dos trechos gerados; para arquivos semelhantes a tabelas divididos por linhas de dados e que geralmente carecem de uma hierarquia textual de títulos (como Excel), o título do trecho depende de uma hierarquia de títulos ser detectada durante a análise, podendo estar vazio quando nenhuma for detectada. Edite também o título do trecho manualmente no gerenciamento de trechos.

          Nota: Após a criação da base de conhecimento, não é possível alterar as configurações de fragmentação de documentos . Uma estratégia de fragmentação inadequada pode reduzir o desempenho de recuperação e recall.

          Reescrita de conversa em múltiplas rodadas

          Quando ativado, este recurso usa um modelo dedicado para reescrever a consulta do usuário incorporando o histórico da conversa. Esse processo cria uma consulta completa e autônoma para recuperação na base de conhecimento.

          Modelo de embedding

          Um modelo de embedding converte o prompt de entrada original e o texto de conhecimento em vetores numéricos para que o sistema possa calcular a similaridade semântica. O modelo padrão Official Vector (text-embedding-v2) suporta vários idiomas além de chinês e inglês e normaliza os vetores resultantes. Esta configuração não pode ser alterada.

          As dimensões de vetor para são fixas e não podem ser modificadas:

          • Official Vector (text-embedding-v2): 1.536 dimensões

          • qwen3-vl-embedding: Ativado automaticamente quando o caso de uso de compreensão visual é selecionado. Suporta a geração de vetores para imagens e documentos rich-text após a compreensão visual.

          Modelo de reranking

          Um modelo de reranking é externo à base de conhecimento. Ele reclassifica os fragmentos candidatos da recuperação vetorial inicial e retorna os K principais fragmentos com as maiores pontuações de similaridade. O reranker oficial recomendado, qwen3-rerank (hybrid), considera tanto a relevância semântica quanto os recursos de correspondência de texto (como pontuações BM25) para lidar melhor com consultas que exigem correspondências precisas de palavras-chave. Se você precisar apenas de classificação semântica, selecione qwen3-rerank.

          Modo do modelo de reranking

          Ao criar uma base de conhecimento, você pode selecionar um dos três modos seguintes para o modelo de reranking:

          • Modo Q&A (padrão): Pontua com base na "relevância de Q&A" entre a consulta e os fragmentos candidatos. Adequado para cenários onde os usuários fazem uma pergunta completa e esperam encontrar a resposta dentro de um fragmento.

          • Modo Similaridade: Pontua com base na "similaridade semântica" entre a consulta e os fragmentos candidatos. Indicado para cenários onde a consulta e os fragmentos têm um estilo de expressão semelhante.

          • Modo avançado personalizado: Permite inserir uma instrução em linguagem natural de até 200 caracteres para influenciar o processo de reranking. Projetado para cenários com requisitos especiais de classificação.

          Aviso

          A seleção do modo do modelo de reranking só é possível durante a criação da base de conhecimento. Não é possível alterá-lo após a criação. Antes de configurar esta definição, observe as seguintes limitações:

          • Limitação de tipo de base de conhecimento: Este recurso aplica-se apenas a bases de conhecimento de busca de documentos, Data Query e busca de áudio/vídeo. Não há suporte para bases de conhecimento de Q&A de Imagens.

          • Limitação de caso de uso: Há suporte para este recurso apenas nos casos de uso de Q&A básica de documentos e Resposta Rich-text. Não há suporte para os casos de uso de compreensão visual (documentos rich-text) e Q&A Rápida.

          Limiar de similaridade

          Este limiar define a pontuação mínima de similaridade necessária para que um fragmento seja recuperado dos resultados do modelo de reranking.

          Nota

          Este é o limiar de similaridade padrão para a base de conhecimento. Ao associar a base de conhecimento a um aplicativo específico do Alibaba Cloud Model Studio, defina um limiar separado para esse aplicativo, o qual substitui o limiar padrão da base de conhecimento.

          Reduzir este limiar recupera mais fragmentos, mas pode incluir conteúdo menos relevante. Por outro lado, aumentá-lo recupera menos fragmentos e pode causar o descarte de conteúdos relevantes se definido muito alto.

          Use testes de acerto para ajustar finamente o limiar de similaridade e equilibrar recuperação e precisão.

          Contagem máxima de recuperação

          O sistema recupera fragmentos relacionados à entrada de todas as bases de conhecimento associadas, reclassifica-os usando um modelo de reranking e seleciona os K fragmentos mais relevantes para adicionar à entrada do LLM como contexto. Este valor K é a contagem máxima de recuperação (até 20) e determina o número de fragmentos que o modelo de reranking fornece ao LLM para contexto.

          Aumentar este valor pode melhorar a precisão da resposta do LLM, mas também aumenta o consumo de tokens de entrada do LLM.

          Armazenamento vetorial

          Selecione um banco de dados vetorial para armazenar vetores de texto. O banco de dados vetorial Built-in é suficiente para operações básicas da base de conhecimento. Para capacidades avançadas, como gerenciamento de banco de dados, auditoria ou monitoramento, recomendamos o AnalyticDB for PostgreSQL (ADB-PG).

          Ao adquirir uma instância do AnalyticDB for PostgreSQL (ADB-PG), ative a Vector Engine Optimization . Caso contrário, o Alibaba Cloud Model Studio não poderá usar a instância.

       Criação de compreensão visual

       Ao selecionar o caso de uso de compreensão visual (documentos rich-text), a base de conhecimento usa um modelo de embedding multimodal para compreender visualmente os documentos e preservar as informações originais de layout, em vez de usar métodos tradicionais de fragmentação.

       Restrições de formato de arquivo

       Na área de upload de arquivos da aba Select data, passe o mouse sobre View format requirements para visualizar os requisitos.

       Diferenças na configuração de índice

       A configuração de índice para o caso de uso de compreensão visual difere daquela para Q&A básica de documentos:

       • Modelo de embedding: O modelo qwen3-vl-embedding é selecionado automaticamente e não pode ser alterado após a criação.

       • Reescrita de conversa em múltiplas rodadas: Pode ser ativada ou desativada.

       • Limiar de similaridade: O padrão é 0,20.

       • Contagem máxima final de recuperação: O padrão é 5.

       • Método de fragmentação: A compreensão visual não usa métodos tradicionais de fragmentação, como fragmentação inteligente ou personalizada. Em vez disso, ela compreende toda a página do documento com base na indexação visual.

       Restrições de edição

       • O modelo de embedding (qwen3-vl-embedding) e o tipo de armazenamento vetorial (built-in) não podem ser alterados após a criação.

       • A edição da base de conhecimento só pode ser alterada uma vez por dia.

   • Data query

     • Casos de uso:

       • Ideal para construir sistemas de Q&A baseados em dados estruturados (dados organizados de acordo com um esquema de tabela predefinido), como assistentes para consultar FAQs, dados de produtos ou informações de pessoal.

       • Se seus dados consistem em pares completos de perguntas e respostas de FAQ, selecione Data Query. Por exemplo, se um arquivo Excel contiver duas colunas, Question e Answer, uma base de conhecimento Data Query pode usar a coluna Question para recuperação e a coluna Answer como contexto para a resposta do LLM.

         Este processamento específico por coluna não está disponível no tipo de base de conhecimento de busca de documentos.

       • É possível importar vários arquivos Excel, mas seus esquemas de tabela devem ser idênticos.

     • Integração de fonte de dados: Faça upload de arquivos XLS ou XLSX locais .

       Criação de Data query

       1. Selecionar dados: Especifique uma fonte de dados (arquivos ou conteúdo) para a base de conhecimento. O sistema importa o conteúdo da fonte para a base de conhecimento para recuperação. Use upload local ou importação da cloud.

          Nota

          A fonte de dados não pode ser alterada após a criação da base de conhecimento. Uma única base de conhecimento suporta apenas uma fonte de dados.

          • Upload local: Faça upload de tabelas de dados nos formatos XLS ou XLSX do seu computador. A primeira linha deve ser o cabeçalho da tabela.

          • Importação da cloud (selecionar tabela de dados): Selecione uma tabela de dados existente de um do Alibaba Cloud Model Studio.

       2. Configuração de índice: Define como os dados importados são processados e armazenados, o que afeta diretamente o desempenho da recuperação.

          Dentre as configurações abaixo, apenas o armazenamento vetorial com AnalyticDB for PostgreSQL (ADB-PG) pode gerar taxas. Todas as outras configurações são gratuitas.

          Configurações de recuperação e resposta

          • Used for Retrieval: Se ativado, a base de conhecimento executa a recuperação nesta coluna.

          • Used for Model Reply: Se ativado, os resultados da recuperação desta coluna são fornecidos ao LLM como contexto para geração de resposta. Por exemplo, se você ativar Used for Retrieval para as colunas "Nome", "Gênero", "Cargo" e "Idade", mas ativar Used for Model Reply apenas para as colunas "Nome" e "Cargo", a base de conhecimento recuperará dados de todas as quatro colunas. No entanto, apenas o conteúdo das colunas "Nome" e "Cargo" dos dados recuperados será fornecido ao LLM como contexto para sua resposta.

            Como a coluna "Idade" não está habilitada para respostas do modelo, o LLM associado a esta base de conhecimento não pode responder à pergunta "Qual é a idade de Zhang San?".

          Reescrita de conversa em múltiplas rodadas

          Quando ativado, este recurso usa um modelo dedicado para reescrever a consulta do usuário incorporando o histórico da conversa. Esse processo cria uma consulta completa e autônoma para recuperação na base de conhecimento.

          Modelo de embedding

          Um modelo de embedding converte o prompt de entrada original e o texto de conhecimento em vetores numéricos para que o sistema possa calcular a similaridade semântica. O modelo padrão Official Vector (text-embedding-v2) suporta vários idiomas além de chinês e inglês e normaliza os vetores resultantes. Esta configuração não pode ser alterada.

          As dimensões de vetor para são fixas e não podem ser modificadas:

          • Official Vector (text-embedding-v2): 1.536 dimensões

          • qwen3-vl-embedding: Ativado automaticamente quando o caso de uso de compreensão visual é selecionado. Suporta a geração de vetores para imagens e documentos rich-text após a compreensão visual.

          Modelo de reranking

          Um modelo de reranking é externo à base de conhecimento. Ele reclassifica os fragmentos candidatos da recuperação vetorial inicial e retorna os K principais fragmentos com as maiores pontuações de similaridade. O reranker oficial recomendado, qwen3-rerank (hybrid), considera tanto a relevância semântica quanto os recursos de correspondência de texto (como pontuações BM25) para lidar melhor com consultas que exigem correspondências precisas de palavras-chave. Se você precisar apenas de classificação semântica, selecione qwen3-rerank.

          Modo do modelo de reranking

          Ao criar uma base de conhecimento, você pode selecionar um dos três modos seguintes para o modelo de reranking:

          • Modo Q&A (padrão): Pontua com base na "relevância de Q&A" entre a consulta e os fragmentos candidatos. Adequado para cenários onde os usuários fazem uma pergunta completa e esperam encontrar a resposta dentro de um fragmento.

          • Modo Similaridade: Pontua com base na "similaridade semântica" entre a consulta e os fragmentos candidatos. Indicado para cenários onde a consulta e os fragmentos têm um estilo de expressão semelhante.

          • Modo avançado personalizado: Permite inserir uma instrução em linguagem natural de até 200 caracteres para influenciar o processo de reranking. Projetado para cenários com requisitos especiais de classificação.

          Aviso

          A seleção do modo do modelo de reranking só é possível durante a criação da base de conhecimento. Não é possível alterá-lo após a criação. Antes de configurar esta definição, observe as seguintes limitações:

          • Limitação de tipo de base de conhecimento: Este recurso aplica-se apenas a bases de conhecimento de busca de documentos, Data Query e busca de áudio/vídeo. Não há suporte para bases de conhecimento de Q&A de Imagens.

          • Limitação de caso de uso: Há suporte para este recurso apenas nos casos de uso de Q&A básica de documentos e Resposta Rich-text. Não há suporte para os casos de uso de compreensão visual (documentos rich-text) e Q&A Rápida.

          Limiar de similaridade

          Este limiar define a pontuação mínima de similaridade necessária para que um fragmento seja recuperado dos resultados do modelo de reranking.

          Nota

          Este é o limiar de similaridade padrão para a base de conhecimento. Ao associar a base de conhecimento a um aplicativo específico do Alibaba Cloud Model Studio, defina um limiar separado para esse aplicativo, o qual substitui o limiar padrão da base de conhecimento.

          Reduzir este limiar recupera mais fragmentos, mas pode incluir conteúdo menos relevante. Por outro lado, aumentá-lo recupera menos fragmentos e pode causar o descarte de conteúdos relevantes se definido muito alto.

          Use testes de acerto para ajustar finamente o limiar de similaridade e equilibrar recuperação e precisão.

          Contagem máxima de recuperação

          O sistema recupera fragmentos relacionados à entrada de todas as bases de conhecimento associadas, reclassifica-os usando um modelo de reranking e seleciona os K fragmentos mais relevantes para adicionar à entrada do LLM como contexto. Este valor K é a contagem máxima de recuperação (até 20) e determina o número de fragmentos que o modelo de reranking fornece ao LLM para contexto.

          Aumentar este valor pode melhorar a precisão da resposta do LLM, mas também aumenta o consumo de tokens de entrada do LLM.

          Armazenamento vetorial

          Selecione um banco de dados vetorial para armazenar vetores de texto. O banco de dados vetorial Built-in é suficiente para operações básicas da base de conhecimento. Para capacidades avançadas, como gerenciamento de banco de dados, auditoria ou monitoramento, recomendamos o AnalyticDB for PostgreSQL (ADB-PG).

          Ao adquirir uma instância do AnalyticDB for PostgreSQL (ADB-PG), ative a Vector Engine Optimization . Caso contrário, o Alibaba Cloud Model Studio não poderá usar a instância.

   • Q&A de Imagens

     • Casos de uso:

       • Ideal para construir aplicações de recuperação multimodal que suportam busca por imagem e busca por imagem mais texto, como assistentes de descoberta de produtos ou assistentes de Q&A visual.

     • Integração de fonte de dados: Faça upload de arquivos XLS ou XLSX locais .

       Arquivos XLS e XLSX devem conter URLs de imagens publicamente acessíveis para criar índices de imagem. Para detalhes, veja as instruções de criação abaixo.

       Criação de Q&A de Imagens

       1. Selecionar dados: Especifique uma fonte de dados (arquivos ou conteúdo) para importar para a base de conhecimento para recuperação. Use upload local ou importação da cloud (selecione uma tabela de dados existente de um conector de dados).

          Nota

          A fonte de dados não pode ser alterada após a criação, e uma única base de conhecimento suporta apenas uma fonte de dados.

          • Upload local: Faça upload de tabelas de dados nos formatos XLS ou XLSX diretamente do seu computador.

            Nota

            • Requisito de campo: A tabela de dados deve conter pelo menos um campo do tipo image_url para gerar o índice de imagem.

            • Processo de construção: A base de conhecimento acessa a URL da imagem no campo image_url, extrai características visuais e as converte em vetores para armazenamento.

            • Processo de recuperação: A base de conhecimento compara o vetor gerado a partir da imagem enviada pelo usuário com os vetores de imagem armazenados e retorna os registros mais relevantes.

          • Importação da cloud (selecionar uma tabela de dados): Selecione uma tabela de dados existente dos dados do seu aplicativo no Alibaba Cloud Model Studio.

       2. Configuração de índice: Define como os dados importados são processados e armazenados, o que afeta diretamente o desempenho da recuperação.

          Dentre as configurações abaixo, apenas o armazenamento vetorial com AnalyticDB for PostgreSQL (ADB-PG) pode gerar taxas. Todas as outras configurações são gratuitas.

          Configurações de recuperação e resposta

          • Used for Retrieval: Se ativado, a base de conhecimento executa a recuperação nesta coluna.

          • Used for Model Reply: Se ativado, os resultados da recuperação desta coluna são fornecidos ao LLM como contexto para geração de resposta. Por exemplo, se você ativar Used for Retrieval para as colunas "Nome", "Gênero", "Cargo" e "Idade", mas ativar Used for Model Reply apenas para as colunas "Nome" e "Cargo", a base de conhecimento recuperará dados de todas as quatro colunas. No entanto, apenas o conteúdo das colunas "Nome" e "Cargo" dos dados recuperados será fornecido ao LLM como contexto para sua resposta.

            Como a coluna "Idade" não está habilitada para respostas do modelo, o LLM associado a esta base de conhecimento não pode responder à pergunta "Qual é a idade de Zhang San?".

          Reescrita de conversa em múltiplas rodadas

          Quando ativado, este recurso usa um modelo dedicado para reescrever a consulta do usuário incorporando o histórico da conversa. Esse processo cria uma consulta completa e autônoma para recuperação na base de conhecimento.

          Modelo de embedding

          Um modelo de embedding converte prompts de entrada originais, texto de conhecimento e imagens em vetores numéricos para permitir comparações de similaridade. Para mais informações, consulte Vetorização de texto e multimodal.

          • qwen2.5-vl-embedding: Representa entradas unimodais ou mistas como um vetor unificado, adequado para recuperação cross-modal e busca de imagens. Por exemplo, se você inserir uma imagem de uma camisa com o texto "encontre um estilo semelhante que pareça mais jovem", o modelo pode fundir a imagem e as instruções de texto em um único vetor para compreensão.

          • multimodal-embedding-v1: Gera vetores separados para cada parte da entrada (imagem e texto).

          • qwen3-vl-embedding: Uma versão atualizada do qwen2.5-vl-embedding que melhora ainda mais a compreensão da fusão imagem-texto e a precisão da recuperação cross-modal.

          Modelo de reranking

          Um modelo de reranking é externo à base de conhecimento. Ele reclassifica os fragmentos candidatos da recuperação vetorial inicial e retorna os K principais fragmentos com as maiores pontuações de similaridade. O reranker oficial recomendado, qwen3-rerank (hybrid), considera tanto a relevância semântica quanto os recursos de correspondência de texto (como pontuações BM25) para lidar melhor com consultas que exigem correspondências precisas de palavras-chave. Se você precisar apenas de classificação semântica, selecione qwen3-rerank.

          Modo do modelo de reranking

          Ao criar uma base de conhecimento, você pode selecionar um dos três modos seguintes para o modelo de reranking:

          • Modo Q&A (padrão): Pontua com base na "relevância de Q&A" entre a consulta e os fragmentos candidatos. Adequado para cenários onde os usuários fazem uma pergunta completa e esperam encontrar a resposta dentro de um fragmento.

          • Modo Similaridade: Pontua com base na "similaridade semântica" entre a consulta e os fragmentos candidatos. Indicado para cenários onde a consulta e os fragmentos têm um estilo de expressão semelhante.

          • Modo avançado personalizado: Permite inserir uma instrução em linguagem natural de até 200 caracteres para influenciar o processo de reranking. Projetado para cenários com requisitos especiais de classificação.

          Aviso

          A seleção do modo do modelo de reranking só é possível durante a criação da base de conhecimento. Não é possível alterá-lo após a criação. Antes de configurar esta definição, observe as seguintes limitações:

          • Limitação de tipo de base de conhecimento: Este recurso aplica-se apenas a bases de conhecimento de busca de documentos, Data Query e busca de áudio/vídeo. Não há suporte para bases de conhecimento de Q&A de Imagens.

          • Limitação de caso de uso: Há suporte para este recurso apenas nos casos de uso de Q&A básica de documentos e Resposta Rich-text. Não há suporte para os casos de uso de compreensão visual (documentos rich-text) e Q&A Rápida.

          Limiar de similaridade

          Este limiar define a pontuação mínima de similaridade necessária para que um fragmento seja recuperado dos resultados do modelo de reranking.

          Nota

          Este é o limiar de similaridade padrão para a base de conhecimento. Ao associar a base de conhecimento a um aplicativo específico do Alibaba Cloud Model Studio, defina um limiar separado para esse aplicativo, o qual substitui o limiar padrão da base de conhecimento.

          Reduzir este limiar recupera mais fragmentos, mas pode incluir conteúdo menos relevante. Por outro lado, aumentá-lo recupera menos fragmentos e pode causar o descarte de conteúdos relevantes se definido muito alto.

          Use testes de acerto para ajustar finamente o limiar de similaridade e equilibrar recuperação e precisão.

          Contagem máxima de recuperação

          O sistema recupera fragmentos relacionados à entrada de todas as bases de conhecimento associadas, reclassifica-os usando um modelo de reranking e seleciona os K fragmentos mais relevantes para adicionar à entrada do LLM como contexto. Este valor K é a contagem máxima de recuperação (até 20) e determina o número de fragmentos que o modelo de reranking fornece ao LLM para contexto.

          Aumentar este valor pode melhorar a precisão da resposta do LLM, mas também aumenta o consumo de tokens de entrada do LLM.

          Armazenamento vetorial

          Selecione um banco de dados vetorial para armazenar vetores de texto. O banco de dados vetorial Built-in é suficiente para operações básicas da base de conhecimento. Para capacidades avançadas, como gerenciamento de banco de dados, auditoria ou monitoramento, recomendamos o AnalyticDB for PostgreSQL (ADB-PG).

          Ao adquirir uma instância do AnalyticDB for PostgreSQL (ADB-PG), ative a Vector Engine Optimization . Caso contrário, o Alibaba Cloud Model Studio não poderá usar a instância.

   Selecione um caso de uso com base em seus requisitos, como Q&A Básica de Documentos, Resposta Rich-text.

Durante horários de pico, a criação da base de conhecimento pode levar várias horas, dependendo do volume de dados.

Atualizar uma base de conhecimento

As alterações em uma base de conhecimento são sincronizadas em tempo real com todas as aplicações que a referenciam.

Editar base de conhecimento

Após criar uma base de conhecimento, modifique apenas seu nome da base de conhecimento, descrição da base de conhecimento e limiar de similaridade. Para alterar quaisquer outras configurações, exclua e recrie a base de conhecimento. Esta operação está disponível apenas no console e não possui uma API correspondente.

Procedimento: Na página Base de Conhecimento, localize a base de conhecimento alvo, clique no ícone em seu cartão e, em seguida, clique em Edit. Observação: Modifique a configuração de uma base de conhecimento apenas uma vez por dia civil. Tentativas subsequentes serão rejeitadas silenciosamente.

Excluir uma base de conhecimento

Antes de excluir uma base de conhecimento, recomendamos desassociá-la de todas as aplicações do Model Studio publicadas.

Ainda é possível excluir uma base de conhecimento associada a aplicações não publicadas.

Alterar configuração

A Enterprise Edition usa RCUs para garantir alto desempenho de recuperação com alto QPS e suporta maior capacidade de armazenamento. A Standard Edition é adequada para desenvolvimento, testes ou cenários de baixa concorrência.

RCU: Uma Unidade de Computação de Recuperação (RCU) é uma medida da concorrência de recuperação para uma base de conhecimento. 1 RCU suporta até aproximadamente 50 QPS para recuperação online. Uma contagem maior de RCU suporta maior concorrência.

• Observação:

  • Se uma base de conhecimento Enterprise Edition usar o armazenamento da plataforma, reduza seu espaço de armazenamento utilizado para abaixo de 80 GB antes de fazer o downgrade para a Standard Edition.

    Libere espaço de armazenamento excluindo arquivos ou dados da base de conhecimento.

• Procedimento:

  1. Na página Base de Conhecimento, localize a base de conhecimento a ser reconfigurada. Clique no ícone em seu cartão e, em seguida, clique em Edit.

  2. Na caixa de diálogo, selecione uma ação com base na edição atual:

     • Standard Edition: Selecione Upgrade.

     • Enterprise Edition: Selecione Downgrade ou Change RCU Count.

  3. Siga as instruções na tela para concluir o processo. A nova configuração entra em vigor imediatamente após clicar em OK.

Teste de acerto

Utilize testes de acerto para verificar se sua base de conhecimento fornece contexto preciso para sua aplicação de IA. Esse processo envolve simular consultas de usuários, avaliar resultados de recuperação e ajustar o limiar de similaridade.

O modelo de reranking no teste de acerto suporta três modos: Modo Q&A (padrão), projetado para consultas que não correspondem perfeitamente ao conteúdo do documento; modo de similaridade, ideal para consultas altamente semelhantes ao conteúdo do documento; e modo avançado personalizado. As pontuações de classificação para a mesma consulta podem variar significativamente dependendo do modo selecionado. Por exemplo, o mesmo segmento de texto pode pontuar 47% no modo Q&A, mas até 69% no modo de similaridade.

Com o teste de acerto, você pode:

• Verificar se a base de conhecimento fornece contexto eficaz para sua aplicação de IA

• Ajustar o limiar de similaridade para equilibrar taxa de recuperação e precisão

• Identificar lacunas de conteúdo ou problemas de qualidade em sua base de conhecimento