AWS API Changes

2026/01/23 - Amazon Q Connect - 2 updated api methods

Changes Fixes incorrect types in the UpdateAssistantAIAgent API request, adds MESSAGE to TargetType enum, and other minor changes.

PutFeedback (updated)

Link ¶
Changes (both)

{'targetType': {'MESSAGE'}}

Provides feedback against the specified assistant for the specified target. This API only supports generative targets.

See also: AWS API Documentation

Request Syntax

client.put_feedback(
    assistantId='string',
    targetId='string',
    targetType='RECOMMENDATION'|'RESULT'|'MESSAGE',
    contentFeedback={
        'generativeContentFeedbackData': {
            'relevance': 'HELPFUL'|'NOT_HELPFUL'
        }
    }
)

type assistantId:

string

param assistantId:

[REQUIRED]

The identifier of the Amazon Q in Connect assistant.

type targetId:

string

param targetId:

[REQUIRED]

The identifier of the feedback target.

type targetType:

string

param targetType:

[REQUIRED]

The type of the feedback target.

type contentFeedback:

dict

param contentFeedback:

[REQUIRED]

Information about the feedback provided.

generativeContentFeedbackData (dict) --

Information about the feedback for a generative target type.
- relevance (string) -- [REQUIRED]
  
  The relevance of the feedback.

rtype:

dict

returns:

Response Syntax

{
    'assistantId': 'string',
    'assistantArn': 'string',
    'targetId': 'string',
    'targetType': 'RECOMMENDATION'|'RESULT'|'MESSAGE',
    'contentFeedback': {
        'generativeContentFeedbackData': {
            'relevance': 'HELPFUL'|'NOT_HELPFUL'
        }
    }
}

Response Structure

(dict) --
- assistantId (string) --
  
  The identifier of the Amazon Q in Connect assistant.
- assistantArn (string) --
  
  The Amazon Resource Name (ARN) of the Amazon Q in Connect assistant.
- targetId (string) --
  
  The identifier of the feedback target.
- targetType (string) --
  
  The type of the feedback target.
- contentFeedback (dict) --
  
  Information about the feedback provided.
  Note
  
  This is a Tagged Union structure. Only one of the following top level keys will be set: generativeContentFeedbackData. 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'}
```
  - generativeContentFeedbackData (dict) --
    
    Information about the feedback for a generative target type.
    - relevance (string) --
      
      The relevance of the feedback.

UpdateAssistantAIAgent (updated)

Link ¶
Changes (request)

{'orchestratorUseCase': 'string'}

Updates the AI Agent that is set for use by default on an Amazon Q in Connect Assistant.

See also: AWS API Documentation

Request Syntax

client.update_assistant_ai_agent(
    assistantId='string',
    aiAgentType='MANUAL_SEARCH'|'ANSWER_RECOMMENDATION'|'SELF_SERVICE'|'EMAIL_RESPONSE'|'EMAIL_OVERVIEW'|'EMAIL_GENERATIVE_ANSWER'|'ORCHESTRATION'|'NOTE_TAKING'|'CASE_SUMMARIZATION',
    configuration={
        'aiAgentId': 'string'
    },
    orchestratorUseCase='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 aiAgentType:

string

param aiAgentType:

[REQUIRED]

The type of the AI Agent being updated for use by default on the Amazon Q in Connect Assistant.

type configuration:

dict

param configuration:

[REQUIRED]

The configuration of the AI Agent being updated for use by default on the Amazon Q in Connect Assistant.

aiAgentId (string) -- [REQUIRED]

The ID of the AI Agent to be configured.

type orchestratorUseCase:

string

param orchestratorUseCase:

The orchestrator use case for the AI Agent being added.

rtype:

dict

returns:

Response Syntax

{
    'assistant': {
        'assistantId': 'string',
        'assistantArn': 'string',
        'name': 'string',
        'type': 'AGENT',
        'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETED',
        'description': 'string',
        'tags': {
            'string': 'string'
        },
        'serverSideEncryptionConfiguration': {
            'kmsKeyId': 'string'
        },
        'integrationConfiguration': {
            'topicIntegrationArn': 'string'
        },
        'capabilityConfiguration': {
            'type': 'V1'|'V2'
        },
        'aiAgentConfiguration': {
            'string': {
                'aiAgentId': 'string'
            }
        },
        'orchestratorConfigurationList': [
            {
                'aiAgentId': 'string',
                'orchestratorUseCase': 'string'
            },
        ]
    }
}

Response Structure

(dict) --
- assistant (dict) --
  
  The assistant data.
  - assistantId (string) --
    
    The identifier of the Amazon Q in Connect assistant.
  - assistantArn (string) --
    
    The Amazon Resource Name (ARN) of the Amazon Q in Connect assistant.
  - name (string) --
    
    The name.
  - type (string) --
    
    The type of assistant.
  - status (string) --
    
    The status of the assistant.
  - description (string) --
    
    The description.
  - tags (dict) --
    
    The tags used to organize, track, or control access for this resource.
    - (string) --
      - (string) --
  - serverSideEncryptionConfiguration (dict) --
    
    The configuration information for the customer managed key used for encryption.
    
    This KMS key must have a policy that allows kms:CreateGrant, kms:DescribeKey, kms:Decrypt, and kms:GenerateDataKey* permissions to the IAM identity using the key to invoke Amazon Q in Connect. To use Amazon Q in Connect with chat, the key policy must also allow kms:Decrypt, kms:GenerateDataKey*, and kms:DescribeKey permissions to the connect.amazonaws.com service principal.
    
    For more information about setting up a customer managed key for Amazon Q in Connect, see Enable Amazon Q in Connect for your instance.
    - kmsKeyId (string) --
      
      The customer managed key used for encryption. For more information about setting up a customer managed key for Amazon Q in Connect, see Enable Amazon Q in Connect for your instance. For information about valid ID values, see Key identifiers (KeyId).
  - integrationConfiguration (dict) --
    
    The configuration information for the Amazon Q in Connect assistant integration.
    - topicIntegrationArn (string) --
      
      The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
  - capabilityConfiguration (dict) --
    
    The configuration information for the Amazon Q in Connect assistant capability.
    - type (string) --
      
      The type of Amazon Q in Connect assistant capability.
  - aiAgentConfiguration (dict) --
    
    The configuration of the AI Agents (mapped by AI Agent Type to AI Agent version) that is set on the Amazon Q in Connect Assistant.
    - (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.
  - orchestratorConfigurationList (list) --
    
    The list of orchestrator configurations for the assistant.
    - (dict) --
      
      An entry in the orchestrator configuration list.
      - aiAgentId (string) --
        
        The identifier of the AI Agent in the orchestrator configuration.
      - orchestratorUseCase (string) --
        
        The use case for the orchestrator configuration. (for example Connect.SelfService, Connect.AgentAssistance)