QConnect / Client / update_session

update_session#

QConnect.Client.update_session(**kwargs)#

Updates a session. A session is a contextual container used for generating recommendations. Amazon Connect updates the existing Amazon Q in Connect session for each contact on which Amazon Q in Connect is enabled.

See also: AWS API Documentation

Request Syntax

response = client.update_session(
    aiAgentConfiguration={
        'string': {
            'aiAgentId': 'string'
        }
    },
    assistantId='string',
    description='string',
    sessionId='string',
    tagFilter={
        'andConditions': [
            {
                'key': 'string',
                'value': 'string'
            },
        ],
        'orConditions': [
            {
                'andConditions': [
                    {
                        'key': 'string',
                        'value': 'string'
                    },
                ],
                'tagCondition': {
                    'key': 'string',
                    'value': 'string'
                }
            },
        ],
        'tagCondition': {
            'key': 'string',
            'value': 'string'
        }
    }
)
Parameters:

  • aiAgentConfiguration (dict) –

    The configuration of the AI Agents (mapped by AI Agent Type to AI Agent version) that should be used by Amazon Q in Connect for this Session.

    • (string) –

      • (dict) –

        A type that specifies the AI Agent ID configuration data when mapping an AI Agents to be used for an AI Agent type on a session or assistant.

        • aiAgentId (string) – [REQUIRED]

          The ID of the AI Agent to be configured.

  • assistantId (string) –

    [REQUIRED]

    The identifier of the Amazon Q in Connect assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.

  • description (string) – The description.

  • sessionId (string) –

    [REQUIRED]

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

  • tagFilter (dict) –

    An object that can be used to specify Tag conditions.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: andConditions, orConditions, tagCondition.

    • andConditions (list) –

      A list of conditions which would be applied together with an AND condition.

      • (dict) –

        A leaf node condition which can be used to specify a tag condition.

        • key (string) – [REQUIRED]

          The tag key in the tag condition.

        • value (string) –

          The tag value in the tag condition.

    • orConditions (list) –

      A list of conditions which would be applied together with an OR condition.

      • (dict) –

        A list of conditions which would be applied together with an OR condition.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: andConditions, tagCondition.

        • andConditions (list) –

          A list of conditions which would be applied together with an AND condition.

          • (dict) –

            A leaf node condition which can be used to specify a tag condition.

            • key (string) – [REQUIRED]

              The tag key in the tag condition.

            • value (string) –

              The tag value in the tag condition.

        • tagCondition (dict) –

          A leaf node condition which can be used to specify a tag condition.

          • key (string) – [REQUIRED]

            The tag key in the tag condition.

          • value (string) –

            The tag value in the tag condition.

    • tagCondition (dict) –

      A leaf node condition which can be used to specify a tag condition.

      • key (string) – [REQUIRED]

        The tag key in the tag condition.

      • value (string) –

        The tag value in the tag condition.

Return type:

dict

Returns:

Response Syntax

{
    'session': {
        'aiAgentConfiguration': {
            'string': {
                'aiAgentId': 'string'
            }
        },
        'description': 'string',
        'integrationConfiguration': {
            'topicIntegrationArn': 'string'
        },
        'name': 'string',
        'sessionArn': 'string',
        'sessionId': 'string',
        'tagFilter': {
            'andConditions': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'orConditions': [
                {
                    'andConditions': [
                        {
                            'key': 'string',
                            'value': 'string'
                        },
                    ],
                    'tagCondition': {
                        'key': 'string',
                        'value': 'string'
                    }
                },
            ],
            'tagCondition': {
                'key': 'string',
                'value': 'string'
            }
        },
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • session (dict) –

      Information about the session.

      • aiAgentConfiguration (dict) –

        The configuration of the AI Agents (mapped by AI Agent Type to AI Agent version) that should be used by Amazon Q in Connect for this Session.

        • (string) –

          • (dict) –

            A type that specifies the AI Agent ID configuration data when mapping an AI Agents to be used for an AI Agent type on a session or assistant.

            • aiAgentId (string) –

              The ID of the AI Agent to be configured.

      • description (string) –

        The description of the session.

      • integrationConfiguration (dict) –

        The configuration information for the session integration.

        • topicIntegrationArn (string) –

          The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.

      • name (string) –

        The name of the session.

      • sessionArn (string) –

        The Amazon Resource Name (ARN) of the session.

      • sessionId (string) –

        The identifier of the session.

      • tagFilter (dict) –

        An object that can be used to specify Tag conditions.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: andConditions, orConditions, tagCondition. 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'}

        • andConditions (list) –

          A list of conditions which would be applied together with an AND condition.

          • (dict) –

            A leaf node condition which can be used to specify a tag condition.

            • key (string) –

              The tag key in the tag condition.

            • value (string) –

              The tag value in the tag condition.

        • orConditions (list) –

          A list of conditions which would be applied together with an OR condition.

          • (dict) –

            A list of conditions which would be applied together with an OR condition.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: andConditions, tagCondition. 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'}

            • andConditions (list) –

              A list of conditions which would be applied together with an AND condition.

              • (dict) –

                A leaf node condition which can be used to specify a tag condition.

                • key (string) –

                  The tag key in the tag condition.

                • value (string) –

                  The tag value in the tag condition.

            • tagCondition (dict) –

              A leaf node condition which can be used to specify a tag condition.

              • key (string) –

                The tag key in the tag condition.

              • value (string) –

                The tag value in the tag condition.

        • tagCondition (dict) –

          A leaf node condition which can be used to specify a tag condition.

          • key (string) –

            The tag key in the tag condition.

          • value (string) –

            The tag value in the tag condition.

      • tags (dict) –

        The tags used to organize, track, or control access for this resource.

        • (string) –

          • (string) –

Exceptions