View a markdown version of this page

Consultar uma base de conhecimento conectada a um grafo do Amazon Neptune Analytics - Amazon Bedrock
Usar metadados e filtragem

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á.

Consultar uma base de conhecimento conectada a um grafo do Amazon Neptune Analytics

Você pode consultar uma base de conhecimento que usa um grafo do Amazon Neptune Analytics e exibir somente texto relevante das fontes de dados. Para essa consulta, envie uma solicitação Retrieve com um endpoint de runtime do recurso Agentes para Amazon Bedrock, tal como com uma base de conhecimento padrão. Para ter informações sobre como consultar uma base de conhecimento, recuperar dados e gerar respostas, consulte:

A estrutura de uma resposta retornada de uma base de conhecimento com um gráfico do Amazon Neptune Analytics é a mesma de um padrão. KnowledgeBaseRetrievalResult No entanto, a resposta também inclui alguns campos adicionais do Amazon Neptune.

A tabela a seguir descreve os campos do Neptune Analytics que você pode ver em uma resposta exibida. O Amazon Bedrock obtém esses campos da resposta do Neptune Analytics. Se essa resposta não contiver esses campos, o resultado da consulta exibido pelo Amazon Bedrock também não terá esses campos.

Campo Description

x-amz-bedrock-kb-source-uri

O URL do Amazon S3 do documento exibido.

score

Uma medida de distância que indica o grau de correspondência entre uma resposta e a consulta que foi feita, na qual os valores mais baixos indicam melhores correspondências.

x-amz-bedrock-kb-data-source-id

O ID da fonte de dados usada para a base de conhecimento.

x-amz-bedrock-kb-chunk-id

O ID do fragmento que foi usado para recuperar as informações da consulta e gerar a resposta.

DocumentAttributes

Atributos de documento ou campos de metadados do Amazon Kendra. O resultado exibido da consulta à base de conhecimento os armazena como pares de chave-valor de metadados. Você pode filtrar resultados com a filtragem de metadados do Amazon Bedrock.

Usar metadados e filtragem

Ao consultar a base de conhecimento e gerar respostas, é possível filtrar metadados para encontrar documentos mais relevantes. Por exemplo, é possível filtrar com base na data de publicação do documento. Você pode usar o console do Amazon Bedrock ou a API de runtime RetrievalFilter para essa finalidade, que pode especificar algumas condições gerais de filtro.

Veja a seguir algumas considerações sobre o uso da API RetrievalFilter para grafos do Neptune Analytics.

  • O listContains filtro não é suportado.

  • Não é possível usar a variante de lista do filtro stringContains.

  • Para obter as melhores práticas sobre como escolher tipos de filtro e projetar atributos de metadados para uma filtragem eficiente, consulte Práticas recomendadas para filtragem de metadados no GraphRag.

Por exemplo:

"vectorSearchConfiguration": {
        "numberOfResults": 5,
        "filter": {
            "orAll": [
                {
                    "andAll": [
                        {
                            "equals": {
                                "key": "genre",
                                "value": "entertainment"
                            }
                        },
                        {
                            "greaterThan": {
                                "key": "year",
                                "value": 2018
                            }
                        }
                    ]
                },
                {
                    "andAll": [                        
                        {
                            "startsWith": {
                                "key": "author",
                                "value": "C"
                            }
                        }
                    ]
                }
            ]
        }
    }
}