rescore#

KendraRanking.Client.rescore(**kwargs)#

Rescores or re-ranks search results from a search service such as OpenSearch (self managed). You use the semantic search capabilities of Amazon Kendra Intelligent Ranking to improve the search service’s results.

Request Syntax

response = client.rescore(
    RescoreExecutionPlanId='string',
    SearchQuery='string',
    Documents=[
        {
            'Id': 'string',
            'GroupId': 'string',
            'Title': 'string',
            'Body': 'string',
            'TokenizedTitle': [
                'string',
            ],
            'TokenizedBody': [
                'string',
            ],
            'OriginalScore': ...
        },
    ]
)

Parameters:

RescoreExecutionPlanId (string) –
[REQUIRED]

The identifier of the rescore execution plan. A rescore execution plan is an Amazon Kendra Intelligent Ranking resource used for provisioning the Rescore API.
SearchQuery (string) –
[REQUIRED]

The input query from the search service.
Documents (list) –
[REQUIRED]

The list of documents for Amazon Kendra Intelligent Ranking to rescore or rank on.
- (dict) –
  
  Information about a document from a search service such as OpenSearch (self managed). Amazon Kendra Intelligent Ranking uses this information to rank and score on.
  - Id (string) – [REQUIRED]
    
    The identifier of the document from the search service.
  - GroupId (string) –
    
    The optional group identifier of the document from the search service. Documents with the same group identifier are grouped together and processed as one document within the service.
  - Title (string) –
    
    The title of the search service’s document.
  - Body (string) –
    
    The body text of the search service’s document.
  - TokenizedTitle (list) –
    
    The title of the search service’s document represented as a list of tokens or words. You must choose to provide Title or TokenizedTitle. You cannot provide both.
    - (string) –
  - TokenizedBody (list) –
    
    The body text of the search service’s document represented as a list of tokens or words. You must choose to provide Body or TokenizedBody. You cannot provide both.
    - (string) –
  - OriginalScore (float) – [REQUIRED]
    
    The original document score or rank from the search service. Amazon Kendra Intelligent Ranking gives the document a new score or rank based on its intelligent search algorithms.

Return type:

dict

Returns:

Response Syntax

{
    'RescoreId': 'string',
    'ResultItems': [
        {
            'DocumentId': 'string',
            'Score': ...
        },
    ]
}

Response Structure

(dict) –
- RescoreId (string) –
  
  The identifier associated with the scores that Amazon Kendra Intelligent Ranking gives to the results. Amazon Kendra Intelligent Ranking rescores or re-ranks the results for the search service.
- ResultItems (list) –
  
  A list of result items for documents with new relevancy scores. The results are in descending order.
  - (dict) –
    
    A result item for a document with a new relevancy score.
    - DocumentId (string) –
      
      The identifier of the document from the search service.
    - Score (float) –
      
      The relevancy score or rank that Amazon Kendra Intelligent Ranking gives to the result.

Exceptions

KendraRanking.Client.exceptions.ValidationException
KendraRanking.Client.exceptions.ConflictException
KendraRanking.Client.exceptions.AccessDeniedException
KendraRanking.Client.exceptions.ResourceNotFoundException
KendraRanking.Client.exceptions.ThrottlingException
KendraRanking.Client.exceptions.InternalServerException