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à.
# Miglioramento della pertinenza delle risposte alle query con un modello di riclassificazione in Amazon Bedrock
Amazon Bedrock fornisce l’accesso a modelli di riclassificazione che puoi utilizzare durante le query per migliorare la pertinenza dei risultati recuperati. Un modello di riclassificazione calcola la pertinenza dei chunk rispetto a una query e riordina i risultati in base ai punteggi calcolati. Utilizzando un modello di riclassificazione, è possibile restituire risposte più adeguate alla query. Oppure, è possibile includere i risultati in un prompt durante l’esecuzione dell’inferenza del modello per generare risposte più pertinenti e accurate. Con un modello di riclassificazione, è possibile recuperare un numero inferiore di risultati, ma più pertinenti. Inserendo questi risultati nel modello di fondazione utilizzato per generare una risposta, è inoltre possibile ridurre i costi e la latenza.
I modelli di riclassificazione vengono addestrati per identificare i segnali di pertinenza sulla base di una query e quindi utilizzare tali segnali per classificare i documenti. Per questo motivo, i modelli possono fornire risultati più pertinenti e accurati.
**Nota**
È possibile utilizzare la riclassificazione solo per i dati testuali.
Per informazioni sui prezzi dei modelli di riclassificazione, consulta [Prezzi di Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
La riclassificazione richiede almeno i seguenti input:
+ Un modello di riclassificazione che accetta la query di un utente e valuta la pertinenza delle origini dati a cui può accedere.
+ La query dell’utente.
+ Un elenco di documenti che devono essere riordinati dal modello di riclassificazione in base alla loro pertinenza rispetto alla query.
Puoi utilizzare modelli di riclassificazione in Amazon Bedrock nei modi seguenti:
+ Chiama l’operazione [Riclassifica](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rerank.html) direttamente tramite l’API Amazon Bedrock. L’operazione `Rerank` invia la query, i documenti e tutte le configurazioni aggiuntive come input a un modello di riclassificazione. Il modello riclassifica quindi i documenti in base alla pertinenza rispetto alla query e restituisce i documenti nella risposta.
+ Se utilizzi [Knowledge Base per Amazon Bedrock](knowledge-base.md) per creare l’applicazione di generazione potenziata da recupero dati (RAG), utilizza un modello di riclassificazione mentre chiami l’operazione [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) o [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) o quando esegui una query sulla tua knowledge base nella Console di gestione AWS. I risultati della riclassificazione sostituiscono la classificazione predefinita determinata di Knowledge Base per Amazon Bedrock.
**Topics**
+ [Regioni/modelli supportati](rerank-supported.md)
+ [Permissions](rerank-prereq.md)
+ [Utilizzo di un modello di riclassificazione](rerank-use.md)
# Regioni e modelli supportati per la riclassificazione in Amazon Bedrock
L’elenco seguente fornisce collegamenti a informazioni generali sul supporto di Regioni e modelli in Amazon Bedrock:
+ Per un elenco dei codici e degli endpoint delle Regioni supportati in Amazon Bedrock, consulta [Endpoint e quote di Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bedrock_region).
+ Per un elenco dei modelli Amazon Bedrock da utilizzare IDs per chiamare le operazioni dell'API Amazon Bedrock, consulta. [Modelli di fondazione supportati in Amazon Bedrock](models-supported.md)
La tabella seguente mostra i modelli degli strumenti di riclassificazione che puoi utilizzare e le Regioni in cui sono supportati:
**Nota**
Il modello Amazon Rerank 1.0 non è supportato nella Regione AWS Stati Uniti orientali (Virginia settentrionale). In questa Regione puoi utilizzare solo il modello Cohere Rerank 3.5.
La tabella seguente mostra il supporto del modello per il riordinamento:
| Provider | Modello | ID modello | Supporto per modelli a regione singola |
| --- | --- | --- | --- |
| Amazon | Rerank 1.0 | amazon.rerank-v1:0 | ap-northeast-1 ca-central-1 eu-central-1 us-west-2 |
| Cohere | Rerank 3.5 | cohere.rerank-v3-5:0 | ap-northeast-1 ca-central-1 eu-central-1 us-east-1 us-west-2 |
Per ulteriori informazioni sul riposizionamento con i modelli Cohere e i relativi parametri di inferenza, consulta [Riclassifica](https://docs.cohere.com/reference/rerank) nel sito web della documentazione di Cohere.
# Autorizzazioni per la riclassificazione in Amazon Bedrock
Per utilizzare la riclassificazione, un utente richiede le seguenti autorizzazioni:
+ Accesso ai modelli di riclassificazione che intende utilizzare. Per ulteriori informazioni, consulta [Accesso ai modelli di fondazione Amazon Bedrock](model-access.md).
+ Autorizzazioni per il ruolo e, se intende utilizzare la riclassificazione in un flusso di lavoro [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), autorizzazioni per il ruolo di servizio di Knowledge Base per Amazon Bedrock che ha una [relazione di attendibilità](kb-permissions.md#kb-permissions-trust) con il suo ruolo.
**Suggerimento**
Per configurare rapidamente le autorizzazioni richieste, è possibile:
Allega la policy [AmazonBedrockFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess)AWSgestita al ruolo utente. Per ulteriori informazioni sul collegamento di una policy a un ruolo IAM, consultare [Aggiunta e rimozione di autorizzazioni per identità IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).
Utilizzare la console Amazon Bedrock per creare un ruolo di servizio di Knowledge Base per Amazon Bedrock durante la [creazione di una knowledge base](knowledge-base-create.md). Se esiste già di un ruolo di servizio di Knowledge Base per Amazon Bedrock creato dalla console, è possibile utilizzare la console per aggiornarlo durante il [recupero delle origini](kb-test-retrieve.md) nella console.
**Importante**
Quando si utilizza la riclassificazione in un flusso di lavoro `Retrieve` con un ruolo di servizio di Knowledge Base per Amazon Bedrock, tenere presente quanto segue:
Se modifichi manualmente la policy AWS Identity and Access Management (IAM) creata da Amazon Bedrock per il tuo ruolo di servizio della knowledge base, potresti riscontrare errori durante il tentativo di aggiornare le autorizzazioni in. Console di gestione AWS Per risolvere questo problema, nella console IAM, eliminare la versione della policy creata manualmente. Poi aggiornare la pagina della riclassificazione nella console Amazon Bedrock e riprovare.
Se viene utilizzato un ruolo personalizzato, Amazon Bedrock non può aggiornare il ruolo di servizio della knowledge base per conto dell’utente. Verificare che le autorizzazioni siano configurate correttamente per il ruolo di servizio.
Per un riepilogo dei casi d’uso e delle autorizzazioni necessarie, consultare la tabella seguente:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/rerank-prereq.html)
Ad esempi di policy di autorizzazione che è possibile collegare a un ruolo IAM, espandere la sezione corrispondente al tuo caso d’uso:
## Policy di autorizzazione per utilizzare un modello di riclassificazione in modo indipendente
Per utilizzare [Rerank](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rerank.html) direttamente con un elenco di origini, il ruolo utente richiede le autorizzazioni per utilizzare sia le azioni `bedrock:Rerank` che le azioni `bedrock:InvokeModel`. Allo stesso modo, per impedire l’utilizzo di un modello di riclassificazione, è necessario negare le autorizzazioni per entrambe le azioni. Per consentire al ruolo utente di utilizzare un modello di riclassificazione in modo indipendente, è possibile collegare la seguente policy al ruolo:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RerankSid",
"Effect": "Allow",
"Action": [
"bedrock:Rerank"
],
"Resource": "*"
},
{
"Sid": "InvokeModelSid",
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel"
],
"Resource": [
"arn:aws:bedrock:us-east-1::foundation-model/model-id"
]
}
]
}
```
------
Nella policy precedente, per l’azione `bedrock:InvokeModel` l’ambito delle autorizzazioni è limitato ai modelli che si vuole consentire al ruolo di utilizzare per la classificazione. Per consentire l'accesso a tutti i modelli, utilizzate un wildcard () nel campo. *\$1* `Resource`
## Policy di autorizzazione per utilizzare un modello di riclassificazione in un flusso di lavoro Retrieve
Per utilizzare la riclassificazione durante il recupero di dati da una knowledge base, è necessario configurare le seguenti autorizzazioni:
**Per il ruolo utente**
Il ruolo utente richiede e autorizzazioni per utilizzare l’azione `bedrock:Retrieve`. Per consentire al ruolo utente di recuperare i dati da una knowledge base, è possibile collegare la seguente policy al ruolo:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RetrieveSid",
"Effect": "Allow",
"Action": [
"bedrock:Retrieve"
],
"Resource": [
"arn:aws:bedrock:us-east-1:123456789012:knowledge-base/KnowledgeBaseId"
]
}
]
}
```
------
Nella policy precedente, per l’azione `bedrock:Retrieve` l’ambito delle autorizzazioni è limitato alle knowledge base da cui si desidera consentire al ruolo di recuperare informazioni. Per consentire l'accesso a tutte le knowledge base, puoi usare un wildcard (*\$1*) nel `Resource` campo.
**Per il ruolo di servizio**
Il [ruolo di servizio di Knowledge Base per Amazon Bedrock](kb-permissions.md) utilizzato dall’utente richiede le autorizzazioni per utilizzare le azioni `bedrock:Rerank` e `bedrock:InvokeModel`. È possibile utilizzare la console Amazon Bedrock per configurare automaticamente le autorizzazioni per il ruolo di servizio quando si sceglie un modello di riclassificazione durante la [configurazione del recupero dalla knowledge base](kb-test-retrieve.md). In caso contrario, per consentire al ruolo di servizio di riclassificare le origini durante il recupero, è possibile collegare la seguente policy:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RerankSid",
"Effect": "Allow",
"Action": [
"bedrock:Rerank"
],
"Resource": "*"
},
{
"Sid": "InvokeModelSid",
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel"
],
"Resource": "arn:aws:bedrock:us-east-1::foundation-model/RerankModelId"
}
]
}
```
------
Nella policy precedente, per l’azione `bedrock:InvokeModel` l’ambito delle autorizzazioni è limitato ai modelli che si vuole consentire al ruolo di utilizzare per la classificazione. Per consentire l’accesso a tutti i modelli, è possibile utilizzare un carattere jolly (\$1) nel campo `Resource`.
## Politica di autorizzazione per l'utilizzo di un modello di riclasking in un flusso di lavoro RetrieveAndGenerate
Per utilizzare un modello di riclassificazione durante il recupero di dati da una knowledge base e poi generare risposte basate sui risultati recuperati, il ruolo utente richiede le autorizzazioni per utilizzare le azioni `bedrock:RetrieveAndGenerate`, `bedrock:Rerank` e `bedrock:InvokeModel`. Per consentire la riclassificazione delle origini durante il recupero e la generazione di risposte basate sui risultati, è possibile collegare la seguente policy al ruolo utente:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RerankRetrieveAndGenerateSid",
"Effect": "Allow",
"Action": [
"bedrock:Rerank",
"bedrock:RetrieveAndGenerate"
],
"Resource": "*"
},
{
"Sid": "InvokeModelSid",
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel"
],
"Resource": [
"arn:aws:bedrock:us-east-1::foundation-model/RerankModelId}",
"arn:aws:bedrock:us-east-1::foundation-model/GenerationModelId}"
]
}
]
}
```
------
Nella policy precedente, per l’operazione `bedrock:InvokeModel` l’ambito delle autorizzazioni è limitato ai modelli che si vuole consentire al ruolo di utilizzare per la riclassificazione e ai modelli che si vuole consentire al ruolo di utilizzare per la generazione di risposte. Per consentire l'accesso a tutti i modelli, puoi utilizzare un wildcard () *\$1* nel campo. `Resource`
Per limitare ulteriormente le autorizzazioni, puoi omettere azioni o specificare risorse e chiavi di condizione con cui filtrare le autorizzazioni. Per ulteriori informazioni su azioni, risorse e chiavi di condizione, consultare i seguenti argomenti nella *documentazione di riferimento per l’autorizzazione al servizio*:
+ [Azioni definite da Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-actions-as-permissions): scopri le azioni, i tipi di risorsa a cui è possibile limitarle nel campo `Resource` e le chiavi di condizione in base alle quali puoi filtrare le autorizzazioni nel campo `Condition`.
+ [Tipi di risorsa definiti da Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-resources-for-iam-policies): scopri i tipi di risorsa in Amazon Bedrock.
+ [Chiavi di condizione per Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys): scopri le chiavi di condizione in Amazon Bedrock.
# Utilizzo di un modello di riclassificazione in Amazon Bedrock
È 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.
------