View a markdown version of this page

Usando a Amazon Kendra API para enviar feedback - Amazon Kendra

Amazon Kendra não estará mais aberto a novos clientes a partir de 30 de julho de 2026. Se você quiser usar o serviço, inscreva-se antes de 30 de julho. Para recursos semelhantes a Amazon Kendra, explore as bases de conhecimento do Amazon Bedrock. Saiba mais.

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

Usando a Amazon Kendra API para enviar feedback

Para usar a Amazon Kendra API para enviar feedback de consulta, use a SubmitFeedbackAPI. Para identificar a consulta, você fornece o ID do índice ao qual a consulta se aplica e o ID de consulta retornado na resposta da API Query.

O exemplo a seguir mostra como enviar feedback de cliques e relevância usando a API Amazon Kendra . Envie vários conjuntos de comentários por meio das matrizes RelevanceFeedbackItems e ClickFeedbackItems. Este exemplo envia um único clique e um único item de comentários de relevância. O envio dos comentários usa a hora atual.

Para enviar feedback para uma pesquisa (AWS SDK)

  1. É possível usar o seguinte exemplo de código com os valores necessários:

    1. index id: o ID do índice ao qual a consulta se aplica.

    2. query id: a consulta sobre a qual você deseja dar feedback.

    3. result id: o ID do resultado da consulta sobre o qual você deseja dar feedback. A resposta da consulta contém o ID do resultado.

    4. relevance value: RELEVANT (o resultado da consulta é relevante) ou NOT_RELEVANT (o resultado da consulta não é relevante).

    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");
    }
}

  2. Execute o código. Depois que os comentários forem enviados, o código exibirá uma mensagem.