assistants

Creates, updates, deletes, gets or lists an assistants resource.

Overview

Name	assistants
Type	Resource
Id	aws.wisdom.assistants

Fields

The following fields are returned by SELECT queries:

get_assistant

Name	Datatype	Description
name	string	The name. (pattern: <code>^[a-zA-Z0-9\s_.,-]+</code>)
assistant_arn	string	The Amazon Resource Name (ARN) of the Wisdom assistant. (pattern: <code>^arn:[a-z-]?:wisdom:[a-z0-9-]?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?$</code>)
assistant_id	string	The identifier of the Wisdom assistant. (pattern: <code>^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$</code>)
description	string	The description. (pattern: <code>^[a-zA-Z0-9\s_.,-]+</code>)
integration_configuration	object	The configuration information for the Wisdom assistant integration.
server_side_encryption_configuration	object	The configuration information for the customer managed key used for encryption.
status	string	The status of the assistant. (CREATE_IN_PROGRESS, CREATE_FAILED, ACTIVE, DELETE_IN_PROGRESS, DELETE_FAILED, DELETED)
tags	object	The tags used to organize, track, or control access for this resource.
type_	string	The type of assistant. (AGENT)

list_assistants

Name	Datatype	Description
name	string	The name of the assistant. (pattern: <code>^[a-zA-Z0-9\s_.,-]+</code>)
assistant_arn	string	The Amazon Resource Name (ARN) of the Wisdom assistant. (pattern: <code>^arn:[a-z-]?:wisdom:[a-z0-9-]?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?$</code>)
assistant_id	string	The identifier of the Wisdom assistant. (pattern: <code>^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$</code>)
description	string	The description of the assistant. (pattern: <code>^[a-zA-Z0-9\s_.,-]+</code>)
integration_configuration	object	The configuration information for the Wisdom assistant integration.
server_side_encryption_configuration	object	The configuration information for the customer managed key used for encryption.
status	string	The status of the assistant. (CREATE_IN_PROGRESS, CREATE_FAILED, ACTIVE, DELETE_IN_PROGRESS, DELETE_FAILED, DELETED)
tags	object	The tags used to organize, track, or control access for this resource.
type_	string	The type of the assistant. (AGENT)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_assistant	select	assistant_id, region		Retrieves information about an assistant.
list_assistants	select	region	maxResults, nextToken	Lists information about assistants.
create_assistant	insert	region, name, type		Creates an Amazon Connect Wisdom assistant.
delete_assistant	delete	assistant_id, region		Deletes an assistant.
query_assistant	exec	assistant_id, region, queryText		Performs a manual search against the specified assistant. To retrieve recommendations for an assistant, use GetRecommendations.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
assistant_id	string	The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
region	string	AWS region (default: us-east-1)
maxResults	integer	The maximum number of results to return per page.
nextToken	string	The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

SELECT examples

get_assistant

Retrieves information about an assistant.

SELECT
name,
assistant_arn,
assistant_id,
description,
integration_configuration,
server_side_encryption_configuration,
status,
tags,
type_
FROM aws.wisdom.assistants
WHERE assistant_id = '{{ assistant_id }}' -- required
AND region = '{{ region }}' -- required
;

list_assistants

Lists information about assistants.

SELECT
name,
assistant_arn,
assistant_id,
description,
integration_configuration,
server_side_encryption_configuration,
status,
tags,
type_
FROM aws.wisdom.assistants
WHERE region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;

INSERT examples

create_assistant

Creates an Amazon Connect Wisdom assistant.

INSERT INTO aws.wisdom.assistants (
clientToken,
description,
name,
serverSideEncryptionConfiguration,
tags,
type,
region
)
SELECT 
'{{ clientToken }}',
'{{ description }}',
'{{ name }}' /* required */,
'{{ serverSideEncryptionConfiguration }}',
'{{ tags }}',
'{{ type }}' /* required */,
'{{ region }}'
RETURNING
assistant
;

Manifest

# Description fields are for documentation purposes
- name: assistants
props:
  - name: region
    value: "{{ region }}"
    description: Required parameter for the assistants resource.
  - name: clientToken
    value: "{{ clientToken }}"
  - name: description
    value: "{{ description }}"
  - name: name
    value: "{{ name }}"
  - name: serverSideEncryptionConfiguration
    description: |
      The configuration information for the customer managed key used for encryption.
    value:
      kmsKeyId: "{{ kmsKeyId }}"
  - name: tags
    value: "{{ tags }}"
  - name: type
    value: "{{ type }}"
    valid_values: ['AGENT']

DELETE examples

delete_assistant

Deletes an assistant.

DELETE FROM aws.wisdom.assistants
WHERE assistant_id = '{{ assistant_id }}' --required
AND region = '{{ region }}' --required
;

Lifecycle Methods

query_assistant

Performs a manual search against the specified assistant. To retrieve recommendations for an assistant, use GetRecommendations.

EXEC aws.wisdom.assistants.query_assistant 
@assistant_id='{{ assistant_id }}' --required, 
@region='{{ region }}' --required 
@@json=
'{
"maxResults": {{ maxResults }}, 
"nextToken": "{{ nextToken }}", 
"queryText": "{{ queryText }}"
}'
;