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

# Usar um modelo reclassificador no Amazon Bedrock
<a name="rerank-use"></a>

É possível usar um modelo reclassificador diretamente ou ao recuperar resultados durante consultas à base de conhecimento. Escolha a guia correspondente ao método de sua preferência e siga as etapas:

------
#### [ Console ]

Você não pode usar um modelo de reclassificação diretamente no Console de gerenciamento da AWS, mas você pode usar um modelo de reclassificação ao consultar sua base de conhecimento fazendo o seguinte:

1. Ao consultar uma base de conhecimento, abra o painel **Configurações** escolhendo o ícone ![\[Three horizontal sliders with adjustable circular controls for settings or parameters.\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/images/icons/configurations.png).

1. Expanda a seção **Reclassificação**.

1. Escolha **Selecionar modelo** e escolha um modelo reclassificador.

1. Se seu perfil de serviço das Bases de Conhecimento do Amazon Bedrock não tiver [permissões para usar o modelo reclassificador](rerank-prereq.md), selecione **Atualizar perfil de serviço** para modificar o perfil com as permissões adequadas.

1. (Opcional) Na seção **Opções adicionais de reclassificação**, modifique as opções necessárias.

1. Insira um prompt e selecione **Executar**. A resposta é o resultado obtido após a aplicação do modelo reclassificador.

Para obter instruções mais detalhadas sobre como realizar consultas à base de conhecimento, consulte [Consultar uma base de conhecimento e recuperar dados](kb-test-retrieve.md) e [Consultar uma base de conhecimento e gerar respostas com base nos dados recuperados](kb-test-retrieve-generate.md).

------
#### [ API ]

Para obter instruções sobre como usar um modelo reclassificador durante a consulta à base de conhecimento, consulte [Consultar uma base de conhecimento e recuperar dados](kb-test-retrieve.md) e [Consultar uma base de conhecimento e gerar respostas com base nos dados recuperados](kb-test-retrieve-generate.md).

Para usar um modelo reclassificador diretamente com a API do Amazon Bedrock, envie uma solicitação [Rerank](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rerank.html) com um [endpoint de runtime do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt).

Os seguintes campos são obrigatórios:


****  

| Campo | Descrição básica | 
| --- | --- | 
| queries | Uma matriz de um [RerankQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankQuery.html)objeto. Especifique TEXT como type e inclua a consulta no campo textQuery. | 
| sources | Uma matriz de [RerankSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankSource.html)objetos a serem enviados ao modelo de reclassificação. Para cada umRerankSource, especifique INLINE como type e inclua um [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objeto no inlineDocumentSource campo. Consulte abaixo para obter detalhes RerankDocument. | 
| rerankingConfiguration | Inclui o nome do recurso da Amazon (ARN) do modelo reclassificador a ser usado, o número de resultados a serem obtidos após a reclassificação e, opcionalmente, as configurações de inferência do modelo. Especifique as configurações adicionais do modelo como pares de chave-valor. Para ter mais informações, consulte [Rerank](https://docs.cohere.com/reference/rerank) no site de documentação da Cohere. | 

Os seguintes campos são opcionais:


****  

| Campo | Caso de uso | 
| --- | --- | 
| nextToken | Um token exibido em uma resposta anterior que você pode incluir para fornecer o próximo lote de resultados. | 

O formato do objeto `RerankSource` que você inclui depende do formato do documento. Para ver o formato dos diferentes tipos de `RerankSource`, escolha a guia que corresponde ao formato do documento:

------
#### [ String ]

Se o documento for uma string, especifique o valor do `type` campo do [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objeto como `TEXT` e inclua o documento no `text` campo. Por exemplo:

```
{
    "inlineDocumentSource": {
        "textDocument": {
            "text": "string"
        },
        "type": "TEXT"
    },
    "type": "INLINE"
}
```

------
#### [ JSON object ]

Se o documento for um objeto JSON, especifique o valor do `type` campo no [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objeto como `JSON` e inclua o documento no `jsonDocument` campo. Por exemplo:

```
{
    "inlineDocumentSource": {
        "jsonDocument": JSON value,
        "type": "JSON"
    },
    "type": "INLINE"
}
```

------

A resposta à sua `Rerank` solicitação retorna uma lista de [RerankResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankResult.html)objetos no `results` campo. Cada objeto contém os seguintes campos:
+ `document`: inclui informações sobre o documento que você enviou.
+ `relevanceScore`: uma pontuação de relevância para o documento, atribuída pelo modelo reclassificador.
+ `index`: indica a classificação do documento em relação aos outros documentos na lista. Quanto menor a pontuação, maior a classificação.

Se houver muitos resultados para exibir, a resposta exibirá um valor no campo `nextToken`. Nesse caso, para ver o próximo lote de resultados, inclua esse token em uma solicitação subsequente.

------