For the complete documentation index, see llms.txt. This page is also available as Markdown.

Obter Ficheiro da Base de Conhecimento

Leia dados das suas Bases de Conhecimento usando filtros.

O que é um Passo de Leitura da Base de Conhecimento?

O passo de Leitura da Base de Conhecimento permite consultar as suas Bases de Conhecimento usando filtros para obter quaisquer dados relevantes para utilização nos seus fluxos de trabalho. Isto é especialmente útil quando se está a fazer Geração Aumentada por Recuperação (RAG).

A principal diferença entre este passo e o Pesquisa na Base de Conhecimento passo é que, enquanto no passo de pesquisa pode fazer consultas e obter fragmentos de texto, o passo de leitura permite aplicar filtros e obter documentos completos.

Para mais informações sobre a configuração de uma Base de Conhecimento, consulte a nossa página de documentação aqui.

Como configurar um Passo de Leitura da Base de Conhecimento

Selecione uma Base de Conhecimento

Selecione a Base de Conhecimento que pretende usar no menu suspenso.

Get Knowledge Base File step with the Knowledge Base dropdown open and Products selected
Selecione a Base de Conhecimento a partir da qual pretende ler.

Selecione ficheiros específicos (opcional)

Opcionalmente, pode selecionar vários documentos a partir de uma lista para os quais pretende ler:

Get Knowledge Base File step with marketing_data.csv and marketing_data_2.csv selected
Opcionalmente, escolha os ficheiros a ler.

Adicionar filtros (opcional)

Pode adicionar filtros para restringir os resultados com base em campos de metadados. Isto inclui:

  • Metadados padrão herdados da origem (por exemplo, nome do ficheiro, URL de origem)

  • Metadados personalizados que adicionou para etiquetar ficheiros (por exemplo, país, produto, público)

  • Colunas de CSV/folha de cálculo quando a Base de Conhecimento contém dados estruturados

Exemplo: filtrar por metadados personalizados

Se tiver estudos de caso de clientes etiquetados com um country campo de metadados personalizados, pode filtrar para recuperar apenas estudos de caso de uma região específica:

Get Knowledge Base File filters for Country equal United Kingdom and UnitPrice less than 3
Filtrar registos por metadados ou colunas CSV.

Para que a filtragem seja eficaz, recomendamos ler Metadados das Bases de Conhecimento para aprender como adicionar etiquetas de metadados personalizados aos ficheiros da sua Base de Conhecimento.

Saída do Passo de Leitura da Base de Conhecimento

O passo de Leitura da Base de Conhecimento devolverá uma lista de documentos com os respetivos registos. No nosso exemplo anterior de produtos filtrados, a saída terá este aspeto:

Pode notar que:

  • Apenas os documentos selecionados no menu suspenso são devolvidos.

  • Cada documento tem uma lista de registos associada. Como estes documentos são CSVs, cada registo representa uma linha diferente.

  • Apenas os registos que correspondem aos filtros selecionados são devolvidos (Reino Unido e UnitPrice < 3).

  • Existe um campo especial "__text" que mostra qual é o texto pesquisável selecionado durante o carregamento do CSV. Como, neste caso, apenas as colunas "Description" e "Country" foram selecionadas como pesquisáveis, são essas as colunas incorporadas no campo "__text".

O seguinte é um exemplo de saída ao recuperar um documento PDF:

Usar a saída do passo para fazer RAG

Podemos passar a saída do passo de Leitura da Base de Conhecimento para um passo de LLM para fazer Geração Aumentada por Recuperação.

Seguindo com o nosso exemplo de produtos, podemos obter a lista completa de produtos e passá-la para um passo de LLM assim:

UK Product Finder Workflow passing the Get Knowledge Base File output into a Prompt LLM step
Passe os registos obtidos para um passo de LLM.
Prompt LLM step that references the fetched records, with its answer listing three products under the step on the canvas
O LLM responde usando os registos obtidos.

Última atualização

Isto foi útil?