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
<a name="kb-test-neptune"></a>

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 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) com um [endpoint de runtime do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt), 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:
+  [Consultar uma base de conhecimento e recuperar dados](kb-test-retrieve.md) 
+  [Consultar uma base de conhecimento e gerar respostas com base nos dados recuperados](kb-test-retrieve-generate.md) 

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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalResult.html) 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
<a name="kb-test-neptune-metadata"></a>

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 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html) 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](https://docs.aws.amazon.com//neptune-analytics/latest/userguide/best-practices-graphrag-filters.html) 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"
                            }
                        }
                    ]
                }
            ]
        }
    }
}
```