Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di un modello di riclassificazione in Amazon Bedrock
<a name="rerank-use"></a>

È possibile utilizzare un modello di riclassificazione direttamente o mentre si recuperano i risultati durante una query sulla knowledge base. Scegli la scheda relativa al metodo che preferisci, quindi segui la procedura:

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

Non è consentito utilizzare un modello di riclassificazione direttamente nella Console di gestione AWS, ma è possibile utilizzarne uno per eseguire query sulla knowledge base effettuando le seguenti operazioni:

1. Quando esegui una query su una knowledge base, apri il riquadro **Configurazioni** scegliendo l’icona ![\[Three horizontal sliders with adjustable circular controls for settings or parameters.\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/images/icons/configurations.png).

1. Espandi la sezione **Riclassificazione**.

1. Scegli **Seleziona modello** per selezionare un modello di riclassificazione.

1. Se al tuo ruolo di servizio per Knowledge Base per Amazon Bedrock mancano le [autorizzazioni per utilizzare il modello di riclassificazione](rerank-prereq.md), seleziona **Aggiorna il ruolo di servizio** per modificarlo con le autorizzazioni appropriate.

1. (Facoltativo) Nella sezione **Opzioni di riclassificazione aggiuntive**, modifica le opzioni necessarie.

1. Inserisci un prompt e seleziona **Esegui**. La risposta è il risultato dopo l’applicazione del modello di riclassificazione.

Per istruzioni più dettagliate su come eseguire query sulla knowledge base, consulta [Interrogare una knowledge base e recuperare dei dati](kb-test-retrieve.md) e [Interrogare una knowledge base e generare risposte basate sui dati recuperati](kb-test-retrieve-generate.md).

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

Per istruzioni su come utilizzare un modello di riclassificazione durante le query sulla knowledge base, consulta [Interrogare una knowledge base e recuperare dei dati](kb-test-retrieve.md) e [Interrogare una knowledge base e generare risposte basate sui dati recuperati](kb-test-retrieve-generate.md).

Per utilizzare un modello di riclassificazione direttamente con l’API Amazon Bedrock, invia una richiesta di [riclassificazione](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rerank.html) con un [endpoint di runtime di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt).

I seguenti campi sono obbligatori:


****  

| Campo | Descrizione di base | 
| --- | --- | 
| queries | Una matrice di un oggetto [RerankQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankQuery.html). Specifica TEXT come type e includi la query nel campo textQuery. | 
| sources | Una matrice di oggetti [RerankSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankSource.html) da inviare al modello di riclassificazione. Per ogni RerankSource, specifica INLINE come type e includi un oggetto [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html) nel campo inlineDocumentSource. Più avanti sono disponibili informazioni dettagliate su RerankDocument. | 
| rerankingConfiguration | Include il nome della risorsa Amazon (ARN) del modello di riclassificazione da utilizzare, il numero di risultati da restituire dopo la riclassificazione e, facoltativamente, le configurazioni di inferenza per il modello. È possibile specificare configurazioni di modello aggiuntive sotto forma di coppie chiave-valore. Per ulteriori informazioni, consulta [Riclassificazione](https://docs.cohere.com/reference/rerank) sul sito web della documentazione di Cohere. | 

I seguenti campi sono facoltativi:


****  

| Campo | Caso d'uso | 
| --- | --- | 
| nextToken | Un token restituito in una risposta precedente che è possibile includere per fornire il successivo batch di risultati. | 

Il formato dell’oggetto `RerankSource` che includi dipende dal formato del documento. Per visualizzare i vari tipi di `RerankSource`, scegli la scheda corrispondente al formato del documento:

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

Se il documento è una stringa, specifica il valore del campo `type` dell’oggetto [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html) come `TEXT` e includi il documento nel campo `text`. Ad esempio:

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

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

Se il documento è un oggetto JSON, specifica il valore del campo `type` dell’oggetto [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html) come `JSON` e includi il documento nel campo `jsonDocument`. Ad esempio:

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

------

La risposta alla tua richiesta di `Rerank` restituisce un elenco di oggetti [RerankResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankResult.html) nel campo `results`. Ogni oggetto include i seguenti campi:
+ `document`: include informazioni sul documento inviato.
+ `relevanceScore`: un punteggio di pertinenza per il documento, assegnato dal modello di riclassificazione.
+ `index`: indica la classificazione del documento rispetto agli altri documenti dell’elenco. Minore è il punteggio, maggiore è la classificazione.

Se Il numero di risultati da visualizzare è eccessivo, la risposta restituisce un valore nel campo `nextToken`. In questo caso, per visualizzare il batch di risultati che segue, includi quel token in una richiesta successiva.

------