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 exibida de uma base de conhecimento com um grafo do Amazon Neptune Analytics é a mesma de um [KnowledgeBaseRetrievalResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalResult.html) padrão. 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 | Descrição | 
| --- | --- | 
|  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.
+ Não é possível usar as chaves de filtro `startsWith` e `listContains`.
+ Não é possível usar a variante de lista do filtro `stringContains`.

Por exemplo:

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