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.

# Utiliser l' Amazon Kendra API pour envoyer des commentaires
<a name="feedback-api"></a>

Pour utiliser l' Amazon Kendra API pour envoyer des commentaires sur les requêtes, utilisez l'[SubmitFeedback](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html)API. Pour identifier la requête, vous devez fournir l'ID d'index de l'index auquel la requête s'applique et l'ID de requête renvoyé dans la réponse de l'API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html).

L'exemple suivant montre comment envoyer des commentaires sur les clics et la pertinence à l'aide de l' Amazon Kendra API. Vous pouvez envoyer plusieurs ensembles de commentaires via les `RelevanceFeedbackItems` tableaux `ClickFeedbackItems` et. Cet exemple envoie un seul clic et un seul commentaire de pertinence. La soumission de commentaires utilise l'heure actuelle.

**Pour envoyer des commentaires concernant une recherche (AWS SDK)**

1. Vous pouvez utiliser l'exemple de code suivant avec les valeurs requises :

   1. `index id`: l'ID de l'index auquel s'applique la requête.

   1. `query id`: la requête sur laquelle vous souhaitez fournir des commentaires.

   1. `result id`: l'ID du résultat de la requête sur lequel vous souhaitez fournir des commentaires. La réponse à la requête contient l'ID du résultat.

   1. `relevance value`—Soit `RELEVANT` (le résultat de la requête est pertinent) soit `NOT_RELEVANT` (le résultat de la requête n'est pas pertinent).

------
#### [ Python ]

   ```
   import boto3
   import time
   
   kendra = boto3.client("kendra")
   
   # Provide the index ID
   index_id = "index-id"
   # Provide the query ID
   query_id = "query-id"
   # Provide the search result ID
   result_id = "result-id"
   
   # Configure the feedback item
   feedback_item = {"ClickTime": int(time.time()),
       "ResultId":result_id}
   
   # Configure the relevance value
   relevance_value = "RELEVANT"
   relevance_item = {"RelevanceValue": relevance_value,
       "ResultId": result_id
       }
   
   response = kendra.submit_feedback(
       QueryId = query_id,
       IndexId = index_id,
       ClickFeedbackItems = [feedback_item],
       RelevanceFeedbackItems = [relevance_item]
   )
   
   
   print("Submitted feedback for query: " + query_id)
   ```

------
#### [ Java ]

   ```
   package com.amazonaws.kendra;
   
   import java.time.Instant;
   import software.amazon.awssdk.services.kendra.KendraClient;
   import software.amazon.awssdk.services.kendra.model.ClickFeedback;
   import software.amazon.awssdk.services.kendra.model.RelevanceFeedback;
   import software.amazon.awssdk.services.kendra.model.RelevanceType;
   import software.amazon.awssdk.services.kendra.model.SubmitFeedbackRequest;
   import software.amazon.awssdk.services.kendra.model.SubmitFeedbackResponse;
   
   public class SubmitFeedbackExample {
       public static void main(String[] args) {
           KendraClient kendra = KendraClient.builder().build();
   
           SubmitFeedbackRequest submitFeedbackRequest = SubmitFeedbackRequest
               .builder()
               .indexId("IndexId")
               .queryId("QueryId")
               .clickFeedbackItems(
                   ClickFeedback
                   .builder()
                   .clickTime(Instant.now())
                   .resultId("ResultId")
                   .build())
               .relevanceFeedbackItems(
                   RelevanceFeedback
                   .builder()
                   .relevanceValue(RelevanceType.RELEVANT)
                   .resultId("ResultId")
                   .build())
               .build();
   
           SubmitFeedbackResponse response = kendra.submitFeedback(submitFeedbackRequest);
   
           System.out.println("Feedback is submitted");
       }
   }
   ```

------

1. Exécutez le code. Une fois le commentaire envoyé, le code affiche un message.