get_recommendations

get_recommendations(**kwargs)

Retrieves recommendations for the specified session. To avoid retrieving the same recommendations in subsequent calls, use NotifyRecommendationsReceived. This API supports long-polling behavior with the waitTimeSeconds parameter. Short poll is the default behavior and only returns recommendations already available. To perform a manual query against an assistant, use QueryAssistant.

See also: AWS API Documentation

Request Syntax

response = client.get_recommendations(
    assistantId='string',
    maxResults=123,
    sessionId='string',
    waitTimeSeconds=123
)
Parameters
  • assistantId (string) --

    [REQUIRED]

    The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.

  • maxResults (integer) -- The maximum number of results to return per page.
  • sessionId (string) --

    [REQUIRED]

    The identifier of the session. Can be either the ID or the ARN. URLs cannot contain the ARN.

  • waitTimeSeconds (integer) -- The duration (in seconds) for which the call waits for a recommendation to be made available before returning. If a recommendation is available, the call returns sooner than WaitTimeSeconds . If no messages are available and the wait time expires, the call returns successfully with an empty list.
Return type

dict

Returns

Response Syntax

{
    'recommendations': [
        {
            'document': {
                'contentReference': {
                    'contentArn': 'string',
                    'contentId': 'string',
                    'knowledgeBaseArn': 'string',
                    'knowledgeBaseId': 'string'
                },
                'excerpt': {
                    'highlights': [
                        {
                            'beginOffsetInclusive': 123,
                            'endOffsetExclusive': 123
                        },
                    ],
                    'text': 'string'
                },
                'title': {
                    'highlights': [
                        {
                            'beginOffsetInclusive': 123,
                            'endOffsetExclusive': 123
                        },
                    ],
                    'text': 'string'
                }
            },
            'recommendationId': 'string',
            'relevanceLevel': 'HIGH'|'MEDIUM'|'LOW',
            'relevanceScore': 123.0,
            'type': 'KNOWLEDGE_CONTENT'
        },
    ],
    'triggers': [
        {
            'data': {
                'query': {
                    'text': 'string'
                }
            },
            'id': 'string',
            'recommendationIds': [
                'string',
            ],
            'source': 'ISSUE_DETECTION'|'RULE_EVALUATION'|'OTHER',
            'type': 'QUERY'
        },
    ]
}

Response Structure

  • (dict) --

    • recommendations (list) --

      The recommendations.

      • (dict) --

        Information about the recommendation.

        • document (dict) --

          The recommended document.

          • contentReference (dict) --

            A reference to the content resource.

            • contentArn (string) --

              The Amazon Resource Name (ARN) of the content.

            • contentId (string) --

              The identifier of the content.

            • knowledgeBaseArn (string) --

              The Amazon Resource Name (ARN) of the knowledge base.

            • knowledgeBaseId (string) --

              The identifier of the knowledge base.

          • excerpt (dict) --

            The excerpt from the document.

            • highlights (list) --

              Highlights in the document text.

              • (dict) --

                Offset specification to describe highlighting of document excerpts for rendering search results and recommendations.

                • beginOffsetInclusive (integer) --

                  The offset for the start of the highlight.

                • endOffsetExclusive (integer) --

                  The offset for the end of the highlight.

            • text (string) --

              Text in the document.

          • title (dict) --

            The title of the document.

            • highlights (list) --

              Highlights in the document text.

              • (dict) --

                Offset specification to describe highlighting of document excerpts for rendering search results and recommendations.

                • beginOffsetInclusive (integer) --

                  The offset for the start of the highlight.

                • endOffsetExclusive (integer) --

                  The offset for the end of the highlight.

            • text (string) --

              Text in the document.

        • recommendationId (string) --

          The identifier of the recommendation.

        • relevanceLevel (string) --

          The relevance level of the recommendation.

        • relevanceScore (float) --

          The relevance score of the recommendation.

        • type (string) --

          The type of recommendation.

    • triggers (list) --

      The triggers corresponding to recommendations.

      • (dict) --

        A recommendation trigger provides context on the event that produced the referenced recommendations. Recommendations are only referenced in recommendationIds by a single RecommendationTrigger.

        • data (dict) --

          A union type containing information related to the trigger.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: query. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          
          • query (dict) --

            Data associated with the QUERY RecommendationTriggerType.

            • text (string) --

              The text associated with the recommendation trigger.

        • id (string) --

          The identifier of the recommendation trigger.

        • recommendationIds (list) --

          The identifiers of the recommendations.

          • (string) --
        • source (string) --

          The source of the recommendation trigger.

          • ISSUE_DETECTION: The corresponding recommendations were triggered by a Contact Lens issue.
          • RULE_EVALUATION: The corresponding recommendations were triggered by a Contact Lens rule.
        • type (string) --

          The type of recommendation trigger.

Exceptions

  • ConnectWisdomService.Client.exceptions.ValidationException
  • ConnectWisdomService.Client.exceptions.AccessDeniedException
  • ConnectWisdomService.Client.exceptions.ResourceNotFoundException