ConnectWisdomService / Client / create_assistant
create_assistant#
- ConnectWisdomService.Client.create_assistant(**kwargs)#
Creates an Amazon Connect Wisdom assistant.
See also: AWS API Documentation
Request Syntax
response = client.create_assistant( clientToken='string', description='string', name='string', serverSideEncryptionConfiguration={ 'kmsKeyId': 'string' }, tags={ 'string': 'string' }, type='AGENT' )
- Parameters:
clientToken (string) –
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.
description (string) – The description of the assistant.
name (string) –
[REQUIRED]
The name of the assistant.
serverSideEncryptionConfiguration (dict) –
The configuration information for the customer managed key used for encryption.
The customer managed key must have a policy that allows
kms:CreateGrant
,kms:DescribeKey
, andkms:Decrypt/kms:GenerateDataKey
permissions to the IAM identity using the key to invoke Wisdom. To use Wisdom with chat, the key policy must also allowkms:Decrypt
,kms:GenerateDataKey*
, andkms:DescribeKey
permissions to theconnect.amazonaws.com
service principal.For more information about setting up a customer managed key for Wisdom, see Enable Amazon Connect Wisdom for your instance.
kmsKeyId (string) –
The customer managed key used for encryption. For more information about setting up a customer managed key for Wisdom, see Enable Amazon Connect Wisdom for your instance. For information about valid ID values, see Key identifiers (KeyId).
tags (dict) –
The tags used to organize, track, or control access for this resource.
(string) –
(string) –
type (string) –
[REQUIRED]
The type of assistant.
- Return type:
dict
- Returns:
Response Syntax
{ 'assistant': { 'assistantArn': 'string', 'assistantId': 'string', 'description': 'string', 'integrationConfiguration': { 'topicIntegrationArn': 'string' }, 'name': 'string', 'serverSideEncryptionConfiguration': { 'kmsKeyId': 'string' }, 'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETED', 'tags': { 'string': 'string' }, 'type': 'AGENT' } }
Response Structure
(dict) –
assistant (dict) –
Information about the assistant.
assistantArn (string) –
The Amazon Resource Name (ARN) of the Wisdom assistant.
assistantId (string) –
The identifier of the Wisdom assistant.
description (string) –
The description.
integrationConfiguration (dict) –
The configuration information for the Wisdom assistant integration.
topicIntegrationArn (string) –
The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
name (string) –
The name.
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
, andkms:Decrypt/kms:GenerateDataKey
permissions to the IAM identity using the key to invoke Wisdom. To use Wisdom with chat, the key policy must also allowkms:Decrypt
,kms:GenerateDataKey*
, andkms:DescribeKey
permissions to theconnect.amazonaws.com
service principal.For more information about setting up a customer managed key for Wisdom, see Enable Amazon Connect Wisdom for your instance.
kmsKeyId (string) –
The customer managed key used for encryption. For more information about setting up a customer managed key for Wisdom, see Enable Amazon Connect Wisdom for your instance. For information about valid ID values, see Key identifiers (KeyId).
status (string) –
The status of the assistant.
tags (dict) –
The tags used to organize, track, or control access for this resource.
(string) –
(string) –
type (string) –
The type of assistant.
Exceptions
ConnectWisdomService.Client.exceptions.ConflictException
ConnectWisdomService.Client.exceptions.ValidationException
ConnectWisdomService.Client.exceptions.ServiceQuotaExceededException
ConnectWisdomService.Client.exceptions.AccessDeniedException