AWS API Changes

2024/04/10 - Amazon Q Connect - 1 new 2 updated api methods

Changes This release adds a new QiC public API updateSession and updates an existing QiC public API createSession

UpdateSession (new)

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

client.update_session(
    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'
        }
    }
)

type assistantId

string

param assistantId

[REQUIRED]

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

type description

string

param description

The description.

type sessionId

string

param sessionId

[REQUIRED]

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

type tagFilter

dict

param tagFilter

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.

rtype

dict

returns

Response Syntax

{
    'session': {
        '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.
  - 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) --

CreateSession (updated)

Link ¶
Changes (request, response)
Request

{'tagFilter': {'andConditions': [{'key': 'string', 'value': 'string'}],
               'orConditions': [{'andConditions': [{'key': 'string',
                                                    'value': 'string'}],
                                 'tagCondition': {'key': 'string',
                                                  'value': 'string'}}],
               'tagCondition': {'key': 'string', 'value': 'string'}}}

Response

{'session': {'tagFilter': {'andConditions': [{'key': 'string',
                                              'value': 'string'}],
                           'orConditions': [{'andConditions': [{'key': 'string',
                                                                'value': 'string'}],
                                             'tagCondition': {'key': 'string',
                                                              'value': 'string'}}],
                           'tagCondition': {'key': 'string',
                                            'value': 'string'}}}}

Creates a session. A session is a contextual container used for generating recommendations. Amazon Connect creates a new Amazon Q in Connect session for each contact on which Amazon Q in Connect is enabled.

See also: AWS API Documentation

Request Syntax

client.create_session(
    assistantId='string',
    clientToken='string',
    description='string',
    name='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'
    }
)

type assistantId

string

param assistantId

[REQUIRED]

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

type clientToken

string

param clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

This field is autopopulated if not provided.

type description

string

param description

The description.

type name

string

param name

[REQUIRED]

The name of the session.

type tagFilter

dict

param tagFilter

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.

type tags

dict

param tags

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

(string) --
- (string) --

rtype

dict

returns

Response Syntax

{
    'session': {
        '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) --
  
  The session.
  - 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) --

GetSession (updated)

Link ¶
Changes (response)

{'session': {'tagFilter': {'andConditions': [{'key': 'string',
                                              'value': 'string'}],
                           'orConditions': [{'andConditions': [{'key': 'string',
                                                                'value': 'string'}],
                                             'tagCondition': {'key': 'string',
                                                              'value': 'string'}}],
                           'tagCondition': {'key': 'string',
                                            'value': 'string'}}}}

Retrieves information for a specified session.

See also: AWS API Documentation

Request Syntax

client.get_session(
    assistantId='string',
    sessionId='string'
)

type assistantId

string

param assistantId

[REQUIRED]

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

type sessionId

string

param sessionId

[REQUIRED]

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

rtype

dict

returns

Response Syntax

{
    'session': {
        '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) --
  
  The session.
  - 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) --