Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Utilisation d’un modèle de reclassement dans Amazon Bedrock Vous pouvez utiliser un modèle de reclassement directement ou lors de la récupération des résultats d’une requête dans la base de connaissances. Choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] Vous ne pouvez pas utiliser un modèle de reclassement directement dans le AWS Management Console, mais vous pouvez utiliser un modèle de reclassement lorsque vous interrogez votre base de connaissances en procédant comme suit : 1. Lorsque vous interrogez une base de connaissances, ouvrez le volet **Configurations** en cliquant sur l’icône ![Icon showing three horizontal sliders at different positions for adjusting settings.](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/configurations.png). 1. Développez la section **Reclassement.** 1. Choisissez **Sélectionner le modèle** pour sélectionner un modèle. 1. Si votre rôle de service Amazon Bedrock Knowledge Bases ne dispose pas des [autorisations nécessaires pour utiliser le modèle de reclassement](rerank-prereq.md), sélectionnez **Mettre à jour le rôle de service** pour modifier le rôle avec les autorisations appropriées. 1. (Facultatif) Dans la section **Options de reclassement supplémentaires**, modifiez les options de votre choix. 1. Saisissez une invite et cliquez sur **Exécuter**. La réponse est le résultat obtenu après application du modèle de reclassement. Pour obtenir des instructions plus détaillées sur l’exécution d’une requête dans une base de connaissances, consultez [Interrogation d’une base de connaissances et extraction des données](kb-test-retrieve.md) et [Interrogation d’une base de connaissances et génération de réponses basées sur les données récupérées](kb-test-retrieve-generate.md). ------ #### [ API ] Pour des instructions sur l’utilisation d’un modèle de reclassement lors d’une requête dans une base de connaissances, consultez [Interrogation d’une base de connaissances et extraction des données](kb-test-retrieve.md) et [Interrogation d’une base de connaissances et génération de réponses basées sur les données récupérées](kb-test-retrieve-generate.md). Pour utiliser un modèle de reclassement directement avec l’API Amazon Bedrock, envoyez une demande de [reclassement](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rerank.html) avec un [point de terminaison d’exécution des agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Les champs suivants sont obligatoires : **** | Champ | Description de base | | --- | --- | | queries | Tableau d'un [RerankQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankQuery.html)objet. Spécifiez TEXT comme type et incluez la requête dans le champ textQuery. | | sources | Un tableau d'[RerankSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankSource.html)objets à soumettre au modèle de reclassement. Pour chacunRerankSource, spécifiez INLINE en tant que type et incluez un [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objet dans le inlineDocumentSource champ. Voir ci-dessous pour plus de détails sur RerankDocument. | | rerankingConfiguration | Inclut l’Amazon Resource Name (ARN) du modèle de reclassement à utiliser, le nombre de résultats à renvoyer après le reclassement et, éventuellement, les configurations d’inférence pour le modèle. Vous spécifiez les configurations de modèle supplémentaires sous forme de paires clé-valeur. Pour plus d’informations, consultez [Rerank](https://docs.cohere.com/reference/rerank) sur le site web de la documentation Cohere. | Les champs suivants sont facultatifs : **** | Champ | Cas d’utilisation | | --- | --- | | nextToken | Jeton renvoyé dans une réponse précédente que vous pouvez inclure pour fournir le prochain lot de résultats. | Le format de l’objet `RerankSource` que vous incluez dépend du format du document. Pour voir le format des différents types `RerankSource`, cliquez sur l’onglet correspondant au format du document : ------ #### [ String ] Si le document est une chaîne, spécifiez la valeur du `type` champ de l'[RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objet sous forme de chaîne `TEXT` et incluez le document dans le `text` champ. Par exemple : ``` { "inlineDocumentSource": { "textDocument": { "text": "string" }, "type": "TEXT" }, "type": "INLINE" } ``` ------ #### [ JSON object ] Si le document est un objet JSON, spécifiez la valeur du `type` champ dans l'[RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objet sous la forme `JSON` et incluez le document dans le `jsonDocument` champ. Par exemple : ``` { "inlineDocumentSource": { "jsonDocument": JSON value, "type": "JSON" }, "type": "INLINE" } ``` ------ La réponse à votre `Rerank` demande renvoie une liste d'[RerankResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankResult.html)objets dans le `results` champ. Chaque objet contient les champs suivants : + `document` : inclut des informations sur le document que vous avez soumis. + `relevanceScore` : score de pertinence pour le document, attribué par le modèle de reclassement. + `index` : indique le classement du document par rapport aux autres documents de la liste. Plus le score est bas, plus le classement est élevé. S’il y a trop de résultats à afficher, la réponse renvoie une valeur dans le champ `nextToken`. Dans ce cas, pour voir le lot de résultats suivant, incluez ce jeton dans une demande ultérieure. **Exemples de code** Les exemples suivants montrent comment appeler l'API RDE à l'aide des AWS SDK. ------ #### [ Python ] ``` import boto3 client = boto3.client('bedrock-agent-runtime', region_name='us-east-1') response = client.rerank( queries=[{ 'type': 'TEXT', 'textQuery': {'text': 'What is Amazon Bedrock?'} }], sources=[ { 'type': 'INLINE', 'inlineDocumentSource': { 'type': 'TEXT', 'textDocument': {'text': 'Amazon Bedrock is a fully managed service for foundation models.'} } }, { 'type': 'INLINE', 'inlineDocumentSource': { 'type': 'TEXT', 'textDocument': {'text': 'Amazon S3 is an object storage service.'} } } ], rerankingConfiguration={ 'type': 'BEDROCK_RERANKING_MODEL', 'bedrockRerankingConfiguration': { 'modelConfiguration': { 'modelArn': 'arn:aws:bedrock:us-east-1::foundation-model/cohere.rerank-v3-5:0' }, 'numberOfResults': 2 } } ) for result in response['results']: print(f'Index: {result["index"]}, Score: {result["relevanceScore"]}') ``` ------ #### [ Node.js ] ``` import { BedrockAgentRuntimeClient, RerankCommand } from "@aws-sdk/client-bedrock-agent-runtime"; const client = new BedrockAgentRuntimeClient({ region: "us-east-1" }); const response = await client.send(new RerankCommand({ queries: [{ type: "TEXT", textQuery: { text: "What is Amazon Bedrock?" } }], sources: [ { type: "INLINE", inlineDocumentSource: { type: "TEXT", textDocument: { text: "Amazon Bedrock is a fully managed service for foundation models." } } }, { type: "INLINE", inlineDocumentSource: { type: "TEXT", textDocument: { text: "Amazon S3 is an object storage service." } } } ], rerankingConfiguration: { type: "BEDROCK_RERANKING_MODEL", bedrockRerankingConfiguration: { modelConfiguration: { modelArn: "arn:aws:bedrock:us-east-1::foundation-model/cohere.rerank-v3-5:0" }, numberOfResults: 2 } } })); for (const result of response.results) { console.log(`Index: ${result.index}, Score: ${result.relevanceScore}`); } ``` ------ ------