Amazon Connect Wisdom Service 2020-10-19
- Client: Aws\ConnectWisdomService\ConnectWisdomServiceClient
- Service ID: wisdom
- Version: 2020-10-19
This page describes the parameters and results for the operations of the Amazon Connect Wisdom Service (2020-10-19), and shows how to use the Aws\ConnectWisdomService\ConnectWisdomServiceClient object to call the described operations. This documentation is specific to the 2020-10-19 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- CreateAssistant ( array $params = [] )
- Creates an Amazon Connect Wisdom assistant.
- CreateAssistantAssociation ( array $params = [] )
- Creates an association between an Amazon Connect Wisdom assistant and another resource.
- CreateContent ( array $params = [] )
- Creates Wisdom content.
- CreateKnowledgeBase ( array $params = [] )
- Creates a knowledge base.
- CreateQuickResponse ( array $params = [] )
- Creates a Wisdom quick response.
- CreateSession ( array $params = [] )
- Creates a session.
- DeleteAssistant ( array $params = [] )
- Deletes an assistant.
- DeleteAssistantAssociation ( array $params = [] )
- Deletes an assistant association.
- DeleteContent ( array $params = [] )
- Deletes the content.
- DeleteImportJob ( array $params = [] )
- Deletes the quick response import job.
- DeleteKnowledgeBase ( array $params = [] )
- Deletes the knowledge base.
- DeleteQuickResponse ( array $params = [] )
- Deletes a quick response.
- GetAssistant ( array $params = [] )
- Retrieves information about an assistant.
- GetAssistantAssociation ( array $params = [] )
- Retrieves information about an assistant association.
- GetContent ( array $params = [] )
- Retrieves content, including a pre-signed URL to download the content.
- GetContentSummary ( array $params = [] )
- Retrieves summary information about the content.
- GetImportJob ( array $params = [] )
- Retrieves the started import job.
- GetKnowledgeBase ( array $params = [] )
- Retrieves information about the knowledge base.
- GetQuickResponse ( array $params = [] )
- Retrieves the quick response.
- GetRecommendations ( array $params = [] )
- Retrieves recommendations for the specified session.
- GetSession ( array $params = [] )
- Retrieves information for a specified session.
- ListAssistantAssociations ( array $params = [] )
- Lists information about assistant associations.
- ListAssistants ( array $params = [] )
- Lists information about assistants.
- ListContents ( array $params = [] )
- Lists the content.
- ListImportJobs ( array $params = [] )
- Lists information about import jobs.
- ListKnowledgeBases ( array $params = [] )
- Lists the knowledge bases.
- ListQuickResponses ( array $params = [] )
- Lists information about quick response.
- ListTagsForResource ( array $params = [] )
- Lists the tags for the specified resource.
- NotifyRecommendationsReceived ( array $params = [] )
- Removes the specified recommendations from the specified assistant's queue of newly available recommendations.
- QueryAssistant ( array $params = [] )
- Performs a manual search against the specified assistant.
- RemoveKnowledgeBaseTemplateUri ( array $params = [] )
- Removes a URI template from a knowledge base.
- SearchContent ( array $params = [] )
- Searches for content in a specified knowledge base.
- SearchQuickResponses ( array $params = [] )
- Searches existing Wisdom quick responses in a Wisdom knowledge base.
- SearchSessions ( array $params = [] )
- Searches for sessions.
- StartContentUpload ( array $params = [] )
- Get a URL to upload content to a knowledge base.
- StartImportJob ( array $params = [] )
- Start an asynchronous job to import Wisdom resources from an uploaded source file.
- TagResource ( array $params = [] )
- Adds the specified tags to the specified resource.
- UntagResource ( array $params = [] )
- Removes the specified tags from the specified resource.
- UpdateContent ( array $params = [] )
- Updates information about the content.
- UpdateKnowledgeBaseTemplateUri ( array $params = [] )
- Updates the template URI of a knowledge base.
- UpdateQuickResponse ( array $params = [] )
- Updates an existing Wisdom quick response.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
- ListAssistantAssociations
- ListAssistants
- ListContents
- ListImportJobs
- ListKnowledgeBases
- ListQuickResponses
- QueryAssistant
- SearchContent
- SearchQuickResponses
- SearchSessions
Operations
CreateAssistant
$result = $client->createAssistant
([/* ... */]); $promise = $client->createAssistantAsync
([/* ... */]);
Creates an Amazon Connect Wisdom assistant.
Parameter Syntax
$result = $client->createAssistant([ 'clientToken' => '<string>', 'description' => '<string>', 'name' => '<string>', // REQUIRED 'serverSideEncryptionConfiguration' => [ 'kmsKeyId' => '<string>', ], 'tags' => ['<string>', ...], 'type' => 'AGENT', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: 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.
- description
-
- Type: string
The description of the assistant.
- name
-
- Required: Yes
- Type: string
The name of the assistant.
- serverSideEncryptionConfiguration
-
- Type: ServerSideEncryptionConfiguration structure
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.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
- type
-
- Required: Yes
- Type: string
The type of assistant.
Result 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>', ...], 'type' => 'AGENT', ], ]
Result Details
Members
- assistant
-
- Type: AssistantData structure
Information about the assistant.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- ServiceQuotaExceededException:
You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.
- AccessDeniedException:
You do not have sufficient access to perform this action.
CreateAssistantAssociation
$result = $client->createAssistantAssociation
([/* ... */]); $promise = $client->createAssistantAssociationAsync
([/* ... */]);
Creates an association between an Amazon Connect Wisdom assistant and another resource. Currently, the only supported association is with a knowledge base. An assistant can have only a single association.
Parameter Syntax
$result = $client->createAssistantAssociation([ 'assistantId' => '<string>', // REQUIRED 'association' => [ // REQUIRED 'knowledgeBaseId' => '<string>', ], 'associationType' => 'KNOWLEDGE_BASE', // REQUIRED 'clientToken' => '<string>', 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- association
-
- Required: Yes
- Type: AssistantAssociationInputData structure
The identifier of the associated resource.
- associationType
-
- Required: Yes
- Type: string
The type of association.
- clientToken
-
- Type: 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.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
Result Syntax
[ 'assistantAssociation' => [ 'assistantArn' => '<string>', 'assistantAssociationArn' => '<string>', 'assistantAssociationId' => '<string>', 'assistantId' => '<string>', 'associationData' => [ 'knowledgeBaseAssociation' => [ 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', ], ], 'associationType' => 'KNOWLEDGE_BASE', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- assistantAssociation
-
- Type: AssistantAssociationData structure
The assistant association.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- ServiceQuotaExceededException:
You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
CreateContent
$result = $client->createContent
([/* ... */]); $promise = $client->createContentAsync
([/* ... */]);
Creates Wisdom content. Before to calling this API, use StartContentUpload to upload an asset.
Parameter Syntax
$result = $client->createContent([ 'clientToken' => '<string>', 'knowledgeBaseId' => '<string>', // REQUIRED 'metadata' => ['<string>', ...], 'name' => '<string>', // REQUIRED 'overrideLinkOutUri' => '<string>', 'tags' => ['<string>', ...], 'title' => '<string>', 'uploadId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: 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.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- metadata
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
A key/value map to store attributes without affecting tagging or recommendations. For example, when synchronizing data between an external system and Wisdom, you can store an external version identifier as metadata to utilize for determining drift.
- name
-
- Required: Yes
- Type: string
The name of the content. Each piece of content in a knowledge base must have a unique name. You can retrieve a piece of content using only its knowledge base and its name with the SearchContent API.
- overrideLinkOutUri
-
- Type: string
The URI you want to use for the article. If the knowledge base has a templateUri, setting this argument overrides it for this piece of content.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
- title
-
- Type: string
The title of the content. If not set, the title is equal to the name.
- uploadId
-
- Required: Yes
- Type: string
A pointer to the uploaded asset. This value is returned by StartContentUpload.
Result Syntax
[ 'content' => [ 'contentArn' => '<string>', 'contentId' => '<string>', 'contentType' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'linkOutUri' => '<string>', 'metadata' => ['<string>', ...], 'name' => '<string>', 'revisionId' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_FAILED', 'tags' => ['<string>', ...], 'title' => '<string>', 'url' => '<string>', 'urlExpiry' => <DateTime>, ], ]
Result Details
Members
- content
-
- Type: ContentData structure
The content.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- ServiceQuotaExceededException:
You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
CreateKnowledgeBase
$result = $client->createKnowledgeBase
([/* ... */]); $promise = $client->createKnowledgeBaseAsync
([/* ... */]);
Creates a knowledge base.
When using this API, you cannot reuse Amazon AppIntegrations DataIntegrations with external knowledge bases such as Salesforce and ServiceNow. If you do, you'll get an InvalidRequestException
error.
For example, you're programmatically managing your external knowledge base, and you want to add or remove one of the fields that is being ingested from Salesforce. Do the following:
-
Call DeleteKnowledgeBase.
-
Call DeleteDataIntegration.
-
Call CreateDataIntegration to recreate the DataIntegration or a create different one.
-
Call CreateKnowledgeBase.
Parameter Syntax
$result = $client->createKnowledgeBase([ 'clientToken' => '<string>', 'description' => '<string>', 'knowledgeBaseType' => 'EXTERNAL|CUSTOM|QUICK_RESPONSES', // REQUIRED 'name' => '<string>', // REQUIRED 'renderingConfiguration' => [ 'templateUri' => '<string>', ], 'serverSideEncryptionConfiguration' => [ 'kmsKeyId' => '<string>', ], 'sourceConfiguration' => [ 'appIntegrations' => [ 'appIntegrationArn' => '<string>', // REQUIRED 'objectFields' => ['<string>', ...], ], ], 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- clientToken
-
- Type: 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.
- description
-
- Type: string
The description.
- knowledgeBaseType
-
- Required: Yes
- Type: string
The type of knowledge base. Only CUSTOM knowledge bases allow you to upload your own content. EXTERNAL knowledge bases support integrations with third-party systems whose content is synchronized automatically.
- name
-
- Required: Yes
- Type: string
The name of the knowledge base.
- renderingConfiguration
-
- Type: RenderingConfiguration structure
Information about how to render the content.
- serverSideEncryptionConfiguration
-
- Type: ServerSideEncryptionConfiguration structure
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.For more information about setting up a customer managed key for Wisdom, see Enable Amazon Connect Wisdom for your instance.
- sourceConfiguration
-
- Type: SourceConfiguration structure
The source of the knowledge base content. Only set this argument for EXTERNAL knowledge bases.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
Result Syntax
[ 'knowledgeBase' => [ 'description' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'knowledgeBaseType' => 'EXTERNAL|CUSTOM|QUICK_RESPONSES', 'lastContentModificationTime' => <DateTime>, 'name' => '<string>', 'renderingConfiguration' => [ 'templateUri' => '<string>', ], 'serverSideEncryptionConfiguration' => [ 'kmsKeyId' => '<string>', ], 'sourceConfiguration' => [ 'appIntegrations' => [ 'appIntegrationArn' => '<string>', 'objectFields' => ['<string>', ...], ], ], 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- knowledgeBase
-
- Type: KnowledgeBaseData structure
The knowledge base.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- ServiceQuotaExceededException:
You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.
- AccessDeniedException:
You do not have sufficient access to perform this action.
CreateQuickResponse
$result = $client->createQuickResponse
([/* ... */]); $promise = $client->createQuickResponseAsync
([/* ... */]);
Creates a Wisdom quick response.
Parameter Syntax
$result = $client->createQuickResponse([ 'channels' => ['<string>', ...], 'clientToken' => '<string>', 'content' => [ // REQUIRED 'content' => '<string>', ], 'contentType' => '<string>', 'description' => '<string>', 'groupingConfiguration' => [ 'criteria' => '<string>', 'values' => ['<string>', ...], ], 'isActive' => true || false, 'knowledgeBaseId' => '<string>', // REQUIRED 'language' => '<string>', 'name' => '<string>', // REQUIRED 'shortcutKey' => '<string>', 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- channels
-
- Type: Array of strings
The Amazon Connect channels this quick response applies to.
- clientToken
-
- Type: 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.
- content
-
- Required: Yes
- Type: QuickResponseDataProvider structure
The content of the quick response.
- contentType
-
- Type: string
The media type of the quick response content.
-
Use
application/x.quickresponse;format=plain
for a quick response written in plain text. -
Use
application/x.quickresponse;format=markdown
for a quick response written in richtext.
- description
-
- Type: string
The description of the quick response.
- groupingConfiguration
-
- Type: GroupingConfiguration structure
The configuration information of the user groups that the quick response is accessible to.
- isActive
-
- Type: boolean
Whether the quick response is active.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- language
-
- Type: string
The language code value for the language in which the quick response is written. The supported language codes include
de_DE
,en_US
,es_ES
,fr_FR
,id_ID
,it_IT
,ja_JP
,ko_KR
,pt_BR
,zh_CN
,zh_TW
- name
-
- Required: Yes
- Type: string
The name of the quick response.
- shortcutKey
-
- Type: string
The shortcut key of the quick response. The value should be unique across the knowledge base.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
Result Syntax
[ 'quickResponse' => [ 'channels' => ['<string>', ...], 'contentType' => '<string>', 'contents' => [ 'markdown' => [ 'content' => '<string>', ], 'plainText' => [ 'content' => '<string>', ], ], 'createdTime' => <DateTime>, 'description' => '<string>', 'groupingConfiguration' => [ 'criteria' => '<string>', 'values' => ['<string>', ...], ], 'isActive' => true || false, 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'language' => '<string>', 'lastModifiedBy' => '<string>', 'lastModifiedTime' => <DateTime>, 'name' => '<string>', 'quickResponseArn' => '<string>', 'quickResponseId' => '<string>', 'shortcutKey' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|CREATED|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_IN_PROGRESS|UPDATE_FAILED', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- quickResponse
-
- Type: QuickResponseData structure
The quick response.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- ServiceQuotaExceededException:
You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
CreateSession
$result = $client->createSession
([/* ... */]); $promise = $client->createSessionAsync
([/* ... */]);
Creates a session. A session is a contextual container used for generating recommendations. Amazon Connect creates a new Wisdom session for each contact on which Wisdom is enabled.
Parameter Syntax
$result = $client->createSession([ 'assistantId' => '<string>', // REQUIRED 'clientToken' => '<string>', 'description' => '<string>', 'name' => '<string>', // REQUIRED 'tags' => ['<string>', ...], ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- clientToken
-
- Type: 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.
- description
-
- Type: string
The description.
- name
-
- Required: Yes
- Type: string
The name of the session.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
Result Syntax
[ 'session' => [ 'description' => '<string>', 'integrationConfiguration' => [ 'topicIntegrationArn' => '<string>', ], 'name' => '<string>', 'sessionArn' => '<string>', 'sessionId' => '<string>', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- session
-
- Type: SessionData structure
The session.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- ResourceNotFoundException:
The specified resource does not exist.
DeleteAssistant
$result = $client->deleteAssistant
([/* ... */]); $promise = $client->deleteAssistantAsync
([/* ... */]);
Deletes an assistant.
Parameter Syntax
$result = $client->deleteAssistant([ 'assistantId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[]
Result Details
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
DeleteAssistantAssociation
$result = $client->deleteAssistantAssociation
([/* ... */]); $promise = $client->deleteAssistantAssociationAsync
([/* ... */]);
Deletes an assistant association.
Parameter Syntax
$result = $client->deleteAssistantAssociation([ 'assistantAssociationId' => '<string>', // REQUIRED 'assistantId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assistantAssociationId
-
- Required: Yes
- Type: string
The identifier of the assistant association. Can be either the ID or the ARN. URLs cannot contain the ARN.
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[]
Result Details
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
DeleteContent
$result = $client->deleteContent
([/* ... */]); $promise = $client->deleteContentAsync
([/* ... */]);
Deletes the content.
Parameter Syntax
$result = $client->deleteContent([ 'contentId' => '<string>', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- contentId
-
- Required: Yes
- Type: string
The identifier of the content. Can be either the ID or the ARN. URLs cannot contain the ARN.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[]
Result Details
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
DeleteImportJob
$result = $client->deleteImportJob
([/* ... */]); $promise = $client->deleteImportJobAsync
([/* ... */]);
Deletes the quick response import job.
Parameter Syntax
$result = $client->deleteImportJob([ 'importJobId' => '<string>', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- importJobId
-
- Required: Yes
- Type: string
The identifier of the import job to be deleted.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
Result Syntax
[]
Result Details
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
DeleteKnowledgeBase
$result = $client->deleteKnowledgeBase
([/* ... */]); $promise = $client->deleteKnowledgeBaseAsync
([/* ... */]);
Deletes the knowledge base.
When you use this API to delete an external knowledge base such as Salesforce or ServiceNow, you must also delete the Amazon AppIntegrations DataIntegration. This is because you can't reuse the DataIntegration after it's been associated with an external knowledge base. However, you can delete and recreate it. See DeleteDataIntegration and CreateDataIntegration in the Amazon AppIntegrations API Reference.
Parameter Syntax
$result = $client->deleteKnowledgeBase([ 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The knowledge base to delete content from. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[]
Result Details
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
DeleteQuickResponse
$result = $client->deleteQuickResponse
([/* ... */]); $promise = $client->deleteQuickResponseAsync
([/* ... */]);
Deletes a quick response.
Parameter Syntax
$result = $client->deleteQuickResponse([ 'knowledgeBaseId' => '<string>', // REQUIRED 'quickResponseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The knowledge base from which the quick response is deleted. The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- quickResponseId
-
- Required: Yes
- Type: string
The identifier of the quick response to delete.
Result Syntax
[]
Result Details
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetAssistant
$result = $client->getAssistant
([/* ... */]); $promise = $client->getAssistantAsync
([/* ... */]);
Retrieves information about an assistant.
Parameter Syntax
$result = $client->getAssistant([ 'assistantId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result 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>', ...], 'type' => 'AGENT', ], ]
Result Details
Members
- assistant
-
- Type: AssistantData structure
Information about the assistant.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetAssistantAssociation
$result = $client->getAssistantAssociation
([/* ... */]); $promise = $client->getAssistantAssociationAsync
([/* ... */]);
Retrieves information about an assistant association.
Parameter Syntax
$result = $client->getAssistantAssociation([ 'assistantAssociationId' => '<string>', // REQUIRED 'assistantId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assistantAssociationId
-
- Required: Yes
- Type: string
The identifier of the assistant association. Can be either the ID or the ARN. URLs cannot contain the ARN.
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[ 'assistantAssociation' => [ 'assistantArn' => '<string>', 'assistantAssociationArn' => '<string>', 'assistantAssociationId' => '<string>', 'assistantId' => '<string>', 'associationData' => [ 'knowledgeBaseAssociation' => [ 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', ], ], 'associationType' => 'KNOWLEDGE_BASE', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- assistantAssociation
-
- Type: AssistantAssociationData structure
The assistant association.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetContent
$result = $client->getContent
([/* ... */]); $promise = $client->getContentAsync
([/* ... */]);
Retrieves content, including a pre-signed URL to download the content.
Parameter Syntax
$result = $client->getContent([ 'contentId' => '<string>', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- contentId
-
- Required: Yes
- Type: string
The identifier of the content. Can be either the ID or the ARN. URLs cannot contain the ARN.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[ 'content' => [ 'contentArn' => '<string>', 'contentId' => '<string>', 'contentType' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'linkOutUri' => '<string>', 'metadata' => ['<string>', ...], 'name' => '<string>', 'revisionId' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_FAILED', 'tags' => ['<string>', ...], 'title' => '<string>', 'url' => '<string>', 'urlExpiry' => <DateTime>, ], ]
Result Details
Members
- content
-
- Type: ContentData structure
The content.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetContentSummary
$result = $client->getContentSummary
([/* ... */]); $promise = $client->getContentSummaryAsync
([/* ... */]);
Retrieves summary information about the content.
Parameter Syntax
$result = $client->getContentSummary([ 'contentId' => '<string>', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- contentId
-
- Required: Yes
- Type: string
The identifier of the content. Can be either the ID or the ARN. URLs cannot contain the ARN.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[ 'contentSummary' => [ 'contentArn' => '<string>', 'contentId' => '<string>', 'contentType' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'metadata' => ['<string>', ...], 'name' => '<string>', 'revisionId' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_FAILED', 'tags' => ['<string>', ...], 'title' => '<string>', ], ]
Result Details
Members
- contentSummary
-
- Type: ContentSummary structure
The content summary.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetImportJob
$result = $client->getImportJob
([/* ... */]); $promise = $client->getImportJobAsync
([/* ... */]);
Retrieves the started import job.
Parameter Syntax
$result = $client->getImportJob([ 'importJobId' => '<string>', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- importJobId
-
- Required: Yes
- Type: string
The identifier of the import job to retrieve.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base that the import job belongs to.
Result Syntax
[ 'importJob' => [ 'createdTime' => <DateTime>, 'externalSourceConfiguration' => [ 'configuration' => [ 'connectConfiguration' => [ 'instanceId' => '<string>', ], ], 'source' => 'AMAZON_CONNECT', ], 'failedRecordReport' => '<string>', 'importJobId' => '<string>', 'importJobType' => 'QUICK_RESPONSES', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'lastModifiedTime' => <DateTime>, 'metadata' => ['<string>', ...], 'status' => 'START_IN_PROGRESS|FAILED|COMPLETE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED', 'uploadId' => '<string>', 'url' => '<string>', 'urlExpiry' => <DateTime>, ], ]
Result Details
Members
- importJob
-
- Type: ImportJobData structure
The import job.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetKnowledgeBase
$result = $client->getKnowledgeBase
([/* ... */]); $promise = $client->getKnowledgeBaseAsync
([/* ... */]);
Retrieves information about the knowledge base.
Parameter Syntax
$result = $client->getKnowledgeBase([ 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[ 'knowledgeBase' => [ 'description' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'knowledgeBaseType' => 'EXTERNAL|CUSTOM|QUICK_RESPONSES', 'lastContentModificationTime' => <DateTime>, 'name' => '<string>', 'renderingConfiguration' => [ 'templateUri' => '<string>', ], 'serverSideEncryptionConfiguration' => [ 'kmsKeyId' => '<string>', ], 'sourceConfiguration' => [ 'appIntegrations' => [ 'appIntegrationArn' => '<string>', 'objectFields' => ['<string>', ...], ], ], 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- knowledgeBase
-
- Type: KnowledgeBaseData structure
The knowledge base.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetQuickResponse
$result = $client->getQuickResponse
([/* ... */]); $promise = $client->getQuickResponseAsync
([/* ... */]);
Retrieves the quick response.
Parameter Syntax
$result = $client->getQuickResponse([ 'knowledgeBaseId' => '<string>', // REQUIRED 'quickResponseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should be a QUICK_RESPONSES type knowledge base.
- quickResponseId
-
- Required: Yes
- Type: string
The identifier of the quick response.
Result Syntax
[ 'quickResponse' => [ 'channels' => ['<string>', ...], 'contentType' => '<string>', 'contents' => [ 'markdown' => [ 'content' => '<string>', ], 'plainText' => [ 'content' => '<string>', ], ], 'createdTime' => <DateTime>, 'description' => '<string>', 'groupingConfiguration' => [ 'criteria' => '<string>', 'values' => ['<string>', ...], ], 'isActive' => true || false, 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'language' => '<string>', 'lastModifiedBy' => '<string>', 'lastModifiedTime' => <DateTime>, 'name' => '<string>', 'quickResponseArn' => '<string>', 'quickResponseId' => '<string>', 'shortcutKey' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|CREATED|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_IN_PROGRESS|UPDATE_FAILED', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- quickResponse
-
- Type: QuickResponseData structure
The quick response.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetRecommendations
$result = $client->getRecommendations
([/* ... */]); $promise = $client->getRecommendationsAsync
([/* ... */]);
Retrieves recommendations for the specified session. To avoid retrieving the same recommendations in subsequent calls, use NotifyRecommendationsReceived. This API supports long-polling behavior with the waitTimeSeconds
parameter. Short poll is the default behavior and only returns recommendations already available. To perform a manual query against an assistant, use QueryAssistant.
Parameter Syntax
$result = $client->getRecommendations([ 'assistantId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'sessionId' => '<string>', // REQUIRED 'waitTimeSeconds' => <integer>, ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- sessionId
-
- Required: Yes
- Type: string
The identifier of the session. Can be either the ID or the ARN. URLs cannot contain the ARN.
- waitTimeSeconds
-
- Type: int
The duration (in seconds) for which the call waits for a recommendation to be made available before returning. If a recommendation is available, the call returns sooner than
WaitTimeSeconds
. If no messages are available and the wait time expires, the call returns successfully with an empty list.
Result Syntax
[ 'recommendations' => [ [ 'document' => [ 'contentReference' => [ 'contentArn' => '<string>', 'contentId' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', ], 'excerpt' => [ 'highlights' => [ [ 'beginOffsetInclusive' => <integer>, 'endOffsetExclusive' => <integer>, ], // ... ], 'text' => '<string>', ], 'title' => [ 'highlights' => [ [ 'beginOffsetInclusive' => <integer>, 'endOffsetExclusive' => <integer>, ], // ... ], 'text' => '<string>', ], ], 'recommendationId' => '<string>', 'relevanceLevel' => 'HIGH|MEDIUM|LOW', 'relevanceScore' => <float>, 'type' => 'KNOWLEDGE_CONTENT', ], // ... ], 'triggers' => [ [ 'data' => [ 'query' => [ 'text' => '<string>', ], ], 'id' => '<string>', 'recommendationIds' => ['<string>', ...], 'source' => 'ISSUE_DETECTION|RULE_EVALUATION|OTHER', 'type' => 'QUERY', ], // ... ], ]
Result Details
Members
- recommendations
-
- Required: Yes
- Type: Array of RecommendationData structures
The recommendations.
- triggers
-
- Type: Array of RecommendationTrigger structures
The triggers corresponding to recommendations.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
GetSession
$result = $client->getSession
([/* ... */]); $promise = $client->getSessionAsync
([/* ... */]);
Retrieves information for a specified session.
Parameter Syntax
$result = $client->getSession([ 'assistantId' => '<string>', // REQUIRED 'sessionId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- sessionId
-
- Required: Yes
- Type: string
The identifier of the session. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[ 'session' => [ 'description' => '<string>', 'integrationConfiguration' => [ 'topicIntegrationArn' => '<string>', ], 'name' => '<string>', 'sessionArn' => '<string>', 'sessionId' => '<string>', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- session
-
- Type: SessionData structure
The session.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
ListAssistantAssociations
$result = $client->listAssistantAssociations
([/* ... */]); $promise = $client->listAssistantAssociationsAsync
([/* ... */]);
Lists information about assistant associations.
Parameter Syntax
$result = $client->listAssistantAssociations([ 'assistantId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
Result Syntax
[ 'assistantAssociationSummaries' => [ [ 'assistantArn' => '<string>', 'assistantAssociationArn' => '<string>', 'assistantAssociationId' => '<string>', 'assistantId' => '<string>', 'associationData' => [ 'knowledgeBaseAssociation' => [ 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', ], ], 'associationType' => 'KNOWLEDGE_BASE', 'tags' => ['<string>', ...], ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- assistantAssociationSummaries
-
- Required: Yes
- Type: Array of AssistantAssociationSummary structures
Summary information about assistant associations.
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
ListAssistants
$result = $client->listAssistants
([/* ... */]); $promise = $client->listAssistantsAsync
([/* ... */]);
Lists information about assistants.
Parameter Syntax
$result = $client->listAssistants([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
Result Syntax
[ 'assistantSummaries' => [ [ '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>', ...], 'type' => 'AGENT', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- assistantSummaries
-
- Required: Yes
- Type: Array of AssistantSummary structures
Information about the assistants.
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
ListContents
$result = $client->listContents
([/* ... */]); $promise = $client->listContentsAsync
([/* ... */]);
Lists the content.
Parameter Syntax
$result = $client->listContents([ 'knowledgeBaseId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
Result Syntax
[ 'contentSummaries' => [ [ 'contentArn' => '<string>', 'contentId' => '<string>', 'contentType' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'metadata' => ['<string>', ...], 'name' => '<string>', 'revisionId' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_FAILED', 'tags' => ['<string>', ...], 'title' => '<string>', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- contentSummaries
-
- Required: Yes
- Type: Array of ContentSummary structures
Information about the content.
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
ListImportJobs
$result = $client->listImportJobs
([/* ... */]); $promise = $client->listImportJobsAsync
([/* ... */]);
Lists information about import jobs.
Parameter Syntax
$result = $client->listImportJobs([ 'knowledgeBaseId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
Result Syntax
[ 'importJobSummaries' => [ [ 'createdTime' => <DateTime>, 'externalSourceConfiguration' => [ 'configuration' => [ 'connectConfiguration' => [ 'instanceId' => '<string>', ], ], 'source' => 'AMAZON_CONNECT', ], 'importJobId' => '<string>', 'importJobType' => 'QUICK_RESPONSES', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'lastModifiedTime' => <DateTime>, 'metadata' => ['<string>', ...], 'status' => 'START_IN_PROGRESS|FAILED|COMPLETE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED', 'uploadId' => '<string>', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- importJobSummaries
-
- Required: Yes
- Type: Array of ImportJobSummary structures
Summary information about the import jobs.
- nextToken
-
- Type: 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.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
ListKnowledgeBases
$result = $client->listKnowledgeBases
([/* ... */]); $promise = $client->listKnowledgeBasesAsync
([/* ... */]);
Lists the knowledge bases.
Parameter Syntax
$result = $client->listKnowledgeBases([ 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
Result Syntax
[ 'knowledgeBaseSummaries' => [ [ 'description' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'knowledgeBaseType' => 'EXTERNAL|CUSTOM|QUICK_RESPONSES', 'name' => '<string>', 'renderingConfiguration' => [ 'templateUri' => '<string>', ], 'serverSideEncryptionConfiguration' => [ 'kmsKeyId' => '<string>', ], 'sourceConfiguration' => [ 'appIntegrations' => [ 'appIntegrationArn' => '<string>', 'objectFields' => ['<string>', ...], ], ], 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED', 'tags' => ['<string>', ...], ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- knowledgeBaseSummaries
-
- Required: Yes
- Type: Array of KnowledgeBaseSummary structures
Information about the knowledge bases.
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
ListQuickResponses
$result = $client->listQuickResponses
([/* ... */]); $promise = $client->listQuickResponsesAsync
([/* ... */]);
Lists information about quick response.
Parameter Syntax
$result = $client->listQuickResponses([ 'knowledgeBaseId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
Result Syntax
[ 'nextToken' => '<string>', 'quickResponseSummaries' => [ [ 'channels' => ['<string>', ...], 'contentType' => '<string>', 'createdTime' => <DateTime>, 'description' => '<string>', 'isActive' => true || false, 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'lastModifiedBy' => '<string>', 'lastModifiedTime' => <DateTime>, 'name' => '<string>', 'quickResponseArn' => '<string>', 'quickResponseId' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|CREATED|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_IN_PROGRESS|UPDATE_FAILED', 'tags' => ['<string>', ...], ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: 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.
- quickResponseSummaries
-
- Required: Yes
- Type: Array of QuickResponseSummary structures
Summary information about the quick responses.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
Lists the tags for the specified resource.
Parameter Syntax
$result = $client->listTagsForResource([ 'resourceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource.
Result Syntax
[ 'tags' => ['<string>', ...], ]
Result Details
Members
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
Errors
- ResourceNotFoundException:
The specified resource does not exist.
NotifyRecommendationsReceived
$result = $client->notifyRecommendationsReceived
([/* ... */]); $promise = $client->notifyRecommendationsReceivedAsync
([/* ... */]);
Removes the specified recommendations from the specified assistant's queue of newly available recommendations. You can use this API in conjunction with GetRecommendations and a waitTimeSeconds
input for long-polling behavior and avoiding duplicate recommendations.
Parameter Syntax
$result = $client->notifyRecommendationsReceived([ 'assistantId' => '<string>', // REQUIRED 'recommendationIds' => ['<string>', ...], // REQUIRED 'sessionId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- recommendationIds
-
- Required: Yes
- Type: Array of strings
The identifiers of the recommendations.
- sessionId
-
- Required: Yes
- Type: string
The identifier of the session. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[ 'errors' => [ [ 'message' => '<string>', 'recommendationId' => '<string>', ], // ... ], 'recommendationIds' => ['<string>', ...], ]
Result Details
Members
- errors
-
- Type: Array of NotifyRecommendationsReceivedError structures
The identifiers of recommendations that are causing errors.
- recommendationIds
-
- Type: Array of strings
The identifiers of the recommendations.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
QueryAssistant
$result = $client->queryAssistant
([/* ... */]); $promise = $client->queryAssistantAsync
([/* ... */]);
Performs a manual search against the specified assistant. To retrieve recommendations for an assistant, use GetRecommendations.
Parameter Syntax
$result = $client->queryAssistant([ 'assistantId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'queryText' => '<string>', // REQUIRED ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
- queryText
-
- Required: Yes
- Type: string
The text to search for.
Result Syntax
[ 'nextToken' => '<string>', 'results' => [ [ 'document' => [ 'contentReference' => [ 'contentArn' => '<string>', 'contentId' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', ], 'excerpt' => [ 'highlights' => [ [ 'beginOffsetInclusive' => <integer>, 'endOffsetExclusive' => <integer>, ], // ... ], 'text' => '<string>', ], 'title' => [ 'highlights' => [ [ 'beginOffsetInclusive' => <integer>, 'endOffsetExclusive' => <integer>, ], // ... ], 'text' => '<string>', ], ], 'relevanceScore' => <float>, 'resultId' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- results
-
- Required: Yes
- Type: Array of ResultData structures
The results of the query.
Errors
- RequestTimeoutException:
The request reached the service more than 15 minutes after the date stamp on the request or more than 15 minutes after the request expiration date (such as for pre-signed URLs), or the date stamp on the request is more than 15 minutes in the future.
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
RemoveKnowledgeBaseTemplateUri
$result = $client->removeKnowledgeBaseTemplateUri
([/* ... */]); $promise = $client->removeKnowledgeBaseTemplateUriAsync
([/* ... */]);
Removes a URI template from a knowledge base.
Parameter Syntax
$result = $client->removeKnowledgeBaseTemplateUri([ 'knowledgeBaseId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
Result Syntax
[]
Result Details
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
SearchContent
$result = $client->searchContent
([/* ... */]); $promise = $client->searchContentAsync
([/* ... */]);
Searches for content in a specified knowledge base. Can be used to get a specific content resource by its name.
Parameter Syntax
$result = $client->searchContent([ 'knowledgeBaseId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'searchExpression' => [ // REQUIRED 'filters' => [ // REQUIRED [ 'field' => 'NAME', // REQUIRED 'operator' => 'EQUALS', // REQUIRED 'value' => '<string>', // REQUIRED ], // ... ], ], ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
- searchExpression
-
- Required: Yes
- Type: SearchExpression structure
The search expression to filter results.
Result Syntax
[ 'contentSummaries' => [ [ 'contentArn' => '<string>', 'contentId' => '<string>', 'contentType' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'metadata' => ['<string>', ...], 'name' => '<string>', 'revisionId' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_FAILED', 'tags' => ['<string>', ...], 'title' => '<string>', ], // ... ], 'nextToken' => '<string>', ]
Result Details
Members
- contentSummaries
-
- Required: Yes
- Type: Array of ContentSummary structures
Summary information about the content.
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
SearchQuickResponses
$result = $client->searchQuickResponses
([/* ... */]); $promise = $client->searchQuickResponsesAsync
([/* ... */]);
Searches existing Wisdom quick responses in a Wisdom knowledge base.
Parameter Syntax
$result = $client->searchQuickResponses([ 'attributes' => ['<string>', ...], 'knowledgeBaseId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'searchExpression' => [ // REQUIRED 'filters' => [ [ 'includeNoExistence' => true || false, 'name' => '<string>', // REQUIRED 'operator' => 'EQUALS|PREFIX', // REQUIRED 'values' => ['<string>', ...], ], // ... ], 'orderOnField' => [ 'name' => '<string>', // REQUIRED 'order' => 'ASC|DESC', ], 'queries' => [ [ 'allowFuzziness' => true || false, 'name' => '<string>', // REQUIRED 'operator' => 'CONTAINS|CONTAINS_AND_PREFIX', // REQUIRED 'priority' => 'HIGH|MEDIUM|LOW', 'values' => ['<string>', ...], // REQUIRED ], // ... ], ], ]);
Parameter Details
Members
- attributes
-
- Type: Associative array of custom strings keys (ContactAttributeKey) to strings
The user-defined Amazon Connect contact attributes to be resolved when search results are returned.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should be a QUICK_RESPONSES type knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
- searchExpression
-
- Required: Yes
- Type: QuickResponseSearchExpression structure
The search expression for querying the quick response.
Result Syntax
[ 'nextToken' => '<string>', 'results' => [ [ 'attributesInterpolated' => ['<string>', ...], 'attributesNotInterpolated' => ['<string>', ...], 'channels' => ['<string>', ...], 'contentType' => '<string>', 'contents' => [ 'markdown' => [ 'content' => '<string>', ], 'plainText' => [ 'content' => '<string>', ], ], 'createdTime' => <DateTime>, 'description' => '<string>', 'groupingConfiguration' => [ 'criteria' => '<string>', 'values' => ['<string>', ...], ], 'isActive' => true || false, 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'language' => '<string>', 'lastModifiedBy' => '<string>', 'lastModifiedTime' => <DateTime>, 'name' => '<string>', 'quickResponseArn' => '<string>', 'quickResponseId' => '<string>', 'shortcutKey' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|CREATED|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_IN_PROGRESS|UPDATE_FAILED', 'tags' => ['<string>', ...], ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: 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.
- results
-
- Required: Yes
- Type: Array of QuickResponseSearchResultData structures
The results of the quick response search.
Errors
- RequestTimeoutException:
The request reached the service more than 15 minutes after the date stamp on the request or more than 15 minutes after the request expiration date (such as for pre-signed URLs), or the date stamp on the request is more than 15 minutes in the future.
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
SearchSessions
$result = $client->searchSessions
([/* ... */]); $promise = $client->searchSessionsAsync
([/* ... */]);
Searches for sessions.
Parameter Syntax
$result = $client->searchSessions([ 'assistantId' => '<string>', // REQUIRED 'maxResults' => <integer>, 'nextToken' => '<string>', 'searchExpression' => [ // REQUIRED 'filters' => [ // REQUIRED [ 'field' => 'NAME', // REQUIRED 'operator' => 'EQUALS', // REQUIRED 'value' => '<string>', // REQUIRED ], // ... ], ], ]);
Parameter Details
Members
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.
- maxResults
-
- Type: int
The maximum number of results to return per page.
- nextToken
-
- Type: 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.
- searchExpression
-
- Required: Yes
- Type: SearchExpression structure
The search expression to filter results.
Result Syntax
[ 'nextToken' => '<string>', 'sessionSummaries' => [ [ 'assistantArn' => '<string>', 'assistantId' => '<string>', 'sessionArn' => '<string>', 'sessionId' => '<string>', ], // ... ], ]
Result Details
Members
- nextToken
-
- Type: string
If there are additional results, this is the token for the next set of results.
- sessionSummaries
-
- Required: Yes
- Type: Array of SessionSummary structures
Summary information about the sessions.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
StartContentUpload
$result = $client->startContentUpload
([/* ... */]); $promise = $client->startContentUploadAsync
([/* ... */]);
Get a URL to upload content to a knowledge base. To upload content, first make a PUT request to the returned URL with your file, making sure to include the required headers. Then use CreateContent to finalize the content creation process or UpdateContent to modify an existing resource. You can only upload content to a knowledge base of type CUSTOM.
Parameter Syntax
$result = $client->startContentUpload([ 'contentType' => '<string>', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED 'presignedUrlTimeToLive' => <integer>, ]);
Parameter Details
Members
- contentType
-
- Required: Yes
- Type: string
The type of content to upload.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- presignedUrlTimeToLive
-
- Type: int
The expected expiration time of the generated presigned URL, specified in minutes.
Result Syntax
[ 'headersToInclude' => ['<string>', ...], 'uploadId' => '<string>', 'url' => '<string>', 'urlExpiry' => <DateTime>, ]
Result Details
Members
- headersToInclude
-
- Required: Yes
- Type: Associative array of custom strings keys (NonEmptyString) to strings
The headers to include in the upload.
- uploadId
-
- Required: Yes
- Type: string
The identifier of the upload.
- url
-
- Required: Yes
- Type: string
The URL of the upload.
- urlExpiry
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The expiration time of the URL as an epoch timestamp.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
StartImportJob
$result = $client->startImportJob
([/* ... */]); $promise = $client->startImportJobAsync
([/* ... */]);
Start an asynchronous job to import Wisdom resources from an uploaded source file. Before calling this API, use StartContentUpload to upload an asset that contains the resource data.
-
For importing Wisdom quick responses, you need to upload a csv file including the quick responses. For information about how to format the csv file for importing quick responses, see Import quick responses.
Parameter Syntax
$result = $client->startImportJob([ 'clientToken' => '<string>', 'externalSourceConfiguration' => [ 'configuration' => [ // REQUIRED 'connectConfiguration' => [ 'instanceId' => '<string>', ], ], 'source' => 'AMAZON_CONNECT', // REQUIRED ], 'importJobType' => 'QUICK_RESPONSES', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED 'metadata' => ['<string>', ...], 'uploadId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- clientToken
-
- Type: string
The tags used to organize, track, or control access for this resource.
- externalSourceConfiguration
-
- Type: ExternalSourceConfiguration structure
The configuration information of the external source that the resource data are imported from.
- importJobType
-
- Required: Yes
- Type: string
The type of the import job.
-
For importing quick response resource, set the value to
QUICK_RESPONSES
.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
-
For importing Wisdom quick responses, this should be a
QUICK_RESPONSES
type knowledge base.
- metadata
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
The metadata fields of the imported Wisdom resources.
- uploadId
-
- Required: Yes
- Type: string
A pointer to the uploaded asset. This value is returned by StartContentUpload.
Result Syntax
[ 'importJob' => [ 'createdTime' => <DateTime>, 'externalSourceConfiguration' => [ 'configuration' => [ 'connectConfiguration' => [ 'instanceId' => '<string>', ], ], 'source' => 'AMAZON_CONNECT', ], 'failedRecordReport' => '<string>', 'importJobId' => '<string>', 'importJobType' => 'QUICK_RESPONSES', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'lastModifiedTime' => <DateTime>, 'metadata' => ['<string>', ...], 'status' => 'START_IN_PROGRESS|FAILED|COMPLETE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED', 'uploadId' => '<string>', 'url' => '<string>', 'urlExpiry' => <DateTime>, ], ]
Result Details
Members
- importJob
-
- Type: ImportJobData structure
The import job.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- ServiceQuotaExceededException:
You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
Adds the specified tags to the specified resource.
Parameter Syntax
$result = $client->tagResource([ 'resourceArn' => '<string>', // REQUIRED 'tags' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource.
- tags
-
- Required: Yes
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
Result Syntax
[]
Result Details
Errors
- TooManyTagsException:
Amazon Connect Wisdom throws this exception if you have too many tags in your tag set.
- ResourceNotFoundException:
The specified resource does not exist.
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
Removes the specified tags from the specified resource.
Parameter Syntax
$result = $client->untagResource([ 'resourceArn' => '<string>', // REQUIRED 'tagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- resourceArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the resource.
- tagKeys
-
- Required: Yes
- Type: Array of strings
The tag keys.
Result Syntax
[]
Result Details
Errors
- ResourceNotFoundException:
The specified resource does not exist.
UpdateContent
$result = $client->updateContent
([/* ... */]); $promise = $client->updateContentAsync
([/* ... */]);
Updates information about the content.
Parameter Syntax
$result = $client->updateContent([ 'contentId' => '<string>', // REQUIRED 'knowledgeBaseId' => '<string>', // REQUIRED 'metadata' => ['<string>', ...], 'overrideLinkOutUri' => '<string>', 'removeOverrideLinkOutUri' => true || false, 'revisionId' => '<string>', 'title' => '<string>', 'uploadId' => '<string>', ]);
Parameter Details
Members
- contentId
-
- Required: Yes
- Type: string
The identifier of the content. Can be either the ID or the ARN. URLs cannot contain the ARN.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN
- metadata
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
A key/value map to store attributes without affecting tagging or recommendations. For example, when synchronizing data between an external system and Wisdom, you can store an external version identifier as metadata to utilize for determining drift.
- overrideLinkOutUri
-
- Type: string
The URI for the article. If the knowledge base has a templateUri, setting this argument overrides it for this piece of content. To remove an existing
overrideLinkOurUri
, exclude this argument and setremoveOverrideLinkOutUri
to true. - removeOverrideLinkOutUri
-
- Type: boolean
Unset the existing
overrideLinkOutUri
if it exists. - revisionId
-
- Type: string
The
revisionId
of the content resource to update, taken from an earlier call toGetContent
,GetContentSummary
,SearchContent
, orListContents
. If included, this argument acts as an optimistic lock to ensure content was not modified since it was last read. If it has been modified, this API throws aPreconditionFailedException
. - title
-
- Type: string
The title of the content.
- uploadId
-
- Type: string
A pointer to the uploaded asset. This value is returned by StartContentUpload.
Result Syntax
[ 'content' => [ 'contentArn' => '<string>', 'contentId' => '<string>', 'contentType' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'linkOutUri' => '<string>', 'metadata' => ['<string>', ...], 'name' => '<string>', 'revisionId' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_FAILED', 'tags' => ['<string>', ...], 'title' => '<string>', 'url' => '<string>', 'urlExpiry' => <DateTime>, ], ]
Result Details
Members
- content
-
- Type: ContentData structure
The content.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- PreconditionFailedException:
The provided
revisionId
does not match, indicating the content has been modified since it was last read.- ResourceNotFoundException:
The specified resource does not exist.
UpdateKnowledgeBaseTemplateUri
$result = $client->updateKnowledgeBaseTemplateUri
([/* ... */]); $promise = $client->updateKnowledgeBaseTemplateUriAsync
([/* ... */]);
Updates the template URI of a knowledge base. This is only supported for knowledge bases of type EXTERNAL. Include a single variable in ${variable}
format; this interpolated by Wisdom using ingested content. For example, if you ingest a Salesforce article, it has an Id
value, and you can set the template URI to https://myInstanceName.lightning.force.com/lightning/r/Knowledge__kav/*${Id}*/view
.
Parameter Syntax
$result = $client->updateKnowledgeBaseTemplateUri([ 'knowledgeBaseId' => '<string>', // REQUIRED 'templateUri' => '<string>', // REQUIRED ]);
Parameter Details
Members
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- templateUri
-
- Required: Yes
- Type: string
The template URI to update.
Result Syntax
[ 'knowledgeBase' => [ 'description' => '<string>', 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'knowledgeBaseType' => 'EXTERNAL|CUSTOM|QUICK_RESPONSES', 'lastContentModificationTime' => <DateTime>, 'name' => '<string>', 'renderingConfiguration' => [ 'templateUri' => '<string>', ], 'serverSideEncryptionConfiguration' => [ 'kmsKeyId' => '<string>', ], 'sourceConfiguration' => [ 'appIntegrations' => [ 'appIntegrationArn' => '<string>', 'objectFields' => ['<string>', ...], ], ], 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- knowledgeBase
-
- Type: KnowledgeBaseData structure
The knowledge base to update.
Errors
- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- ResourceNotFoundException:
The specified resource does not exist.
UpdateQuickResponse
$result = $client->updateQuickResponse
([/* ... */]); $promise = $client->updateQuickResponseAsync
([/* ... */]);
Updates an existing Wisdom quick response.
Parameter Syntax
$result = $client->updateQuickResponse([ 'channels' => ['<string>', ...], 'content' => [ 'content' => '<string>', ], 'contentType' => '<string>', 'description' => '<string>', 'groupingConfiguration' => [ 'criteria' => '<string>', 'values' => ['<string>', ...], ], 'isActive' => true || false, 'knowledgeBaseId' => '<string>', // REQUIRED 'language' => '<string>', 'name' => '<string>', 'quickResponseId' => '<string>', // REQUIRED 'removeDescription' => true || false, 'removeGroupingConfiguration' => true || false, 'removeShortcutKey' => true || false, 'shortcutKey' => '<string>', ]);
Parameter Details
Members
- channels
-
- Type: Array of strings
The Amazon Connect contact channels this quick response applies to. The supported contact channel types include
Chat
. - content
-
- Type: QuickResponseDataProvider structure
The updated content of the quick response.
- contentType
-
- Type: string
The media type of the quick response content.
-
Use
application/x.quickresponse;format=plain
for quick response written in plain text. -
Use
application/x.quickresponse;format=markdown
for quick response written in richtext.
- description
-
- Type: string
The updated description of the quick response.
- groupingConfiguration
-
- Type: GroupingConfiguration structure
The updated grouping configuration of the quick response.
- isActive
-
- Type: boolean
Whether the quick response is active.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- language
-
- Type: string
The language code value for the language in which the quick response is written. The supported language codes include
de_DE
,en_US
,es_ES
,fr_FR
,id_ID
,it_IT
,ja_JP
,ko_KR
,pt_BR
,zh_CN
,zh_TW
- name
-
- Type: string
The name of the quick response.
- quickResponseId
-
- Required: Yes
- Type: string
The identifier of the quick response.
- removeDescription
-
- Type: boolean
Whether to remove the description from the quick response.
- removeGroupingConfiguration
-
- Type: boolean
Whether to remove the grouping configuration of the quick response.
- removeShortcutKey
-
- Type: boolean
Whether to remove the shortcut key of the quick response.
- shortcutKey
-
- Type: string
The shortcut key of the quick response. The value should be unique across the knowledge base.
Result Syntax
[ 'quickResponse' => [ 'channels' => ['<string>', ...], 'contentType' => '<string>', 'contents' => [ 'markdown' => [ 'content' => '<string>', ], 'plainText' => [ 'content' => '<string>', ], ], 'createdTime' => <DateTime>, 'description' => '<string>', 'groupingConfiguration' => [ 'criteria' => '<string>', 'values' => ['<string>', ...], ], 'isActive' => true || false, 'knowledgeBaseArn' => '<string>', 'knowledgeBaseId' => '<string>', 'language' => '<string>', 'lastModifiedBy' => '<string>', 'lastModifiedTime' => <DateTime>, 'name' => '<string>', 'quickResponseArn' => '<string>', 'quickResponseId' => '<string>', 'shortcutKey' => '<string>', 'status' => 'CREATE_IN_PROGRESS|CREATE_FAILED|CREATED|DELETE_IN_PROGRESS|DELETE_FAILED|DELETED|UPDATE_IN_PROGRESS|UPDATE_FAILED', 'tags' => ['<string>', ...], ], ]
Result Details
Members
- quickResponse
-
- Type: QuickResponseData structure
The quick response.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a
Create
API (such asCreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.- ValidationException:
The input fails to satisfy the constraints specified by a service.
- AccessDeniedException:
You do not have sufficient access to perform this action.
- PreconditionFailedException:
The provided
revisionId
does not match, indicating the content has been modified since it was last read.- ResourceNotFoundException:
The specified resource does not exist.
Shapes
AccessDeniedException
Description
You do not have sufficient access to perform this action.
Members
- message
-
- Type: string
AppIntegrationsConfiguration
Description
Configuration information for Amazon AppIntegrations to automatically ingest content.
Members
- appIntegrationArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the AppIntegrations DataIntegration to use for ingesting content.
-
For Salesforce, your AppIntegrations DataIntegration must have an ObjectConfiguration if objectFields is not provided, including at least
Id
,ArticleNumber
,VersionNumber
,Title
,PublishStatus
, andIsDeleted
as source fields. -
For ServiceNow, your AppIntegrations DataIntegration must have an ObjectConfiguration if objectFields is not provided, including at least
number
,short_description
,sys_mod_count
,workflow_state
, andactive
as source fields. -
For Zendesk, your AppIntegrations DataIntegration must have an ObjectConfiguration if
objectFields
is not provided, including at leastid
,title
,updated_at
, anddraft
as source fields. -
For SharePoint, your AppIntegrations DataIntegration must have a FileConfiguration, including only file extensions that are among
docx
,pdf
,html
,htm
, andtxt
. -
For Amazon S3, the ObjectConfiguration and FileConfiguration of your AppIntegrations DataIntegration must be null. The
SourceURI
of your DataIntegration must use the following format:s3://your_s3_bucket_name
.The bucket policy of the corresponding S3 bucket must allow the Amazon Web Services principal
app-integrations.amazonaws.com
to performs3:ListBucket
,s3:GetObject
, ands3:GetBucketLocation
against the bucket.
- objectFields
-
- Type: Array of strings
The fields from the source that are made available to your agents in Wisdom. Optional if ObjectConfiguration is included in the provided DataIntegration.
-
For Salesforce, you must include at least
Id
,ArticleNumber
,VersionNumber
,Title
,PublishStatus
, andIsDeleted
. -
For ServiceNow, you must include at least
number
,short_description
,sys_mod_count
,workflow_state
, andactive
. -
For Zendesk, you must include at least
id
,title
,updated_at
, anddraft
.
Make sure to include additional fields. These fields are indexed and used to source recommendations.
AssistantAssociationData
Description
Information about the assistant association.
Members
- assistantArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the Wisdom assistant.
- assistantAssociationArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the assistant association.
- assistantAssociationId
-
- Required: Yes
- Type: string
The identifier of the assistant association.
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant.
- associationData
-
- Required: Yes
- Type: AssistantAssociationOutputData structure
A union type that currently has a single argument, the knowledge base ID.
- associationType
-
- Required: Yes
- Type: string
The type of association.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
AssistantAssociationInputData
Description
The data that is input into Wisdom as a result of the assistant association.
Members
- knowledgeBaseId
-
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
AssistantAssociationOutputData
Description
The data that is output as a result of the assistant association.
Members
- knowledgeBaseAssociation
-
- Type: KnowledgeBaseAssociationData structure
The knowledge base where output data is sent.
AssistantAssociationSummary
Description
Summary information about the assistant association.
Members
- assistantArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the Wisdom assistant.
- assistantAssociationArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the assistant association.
- assistantAssociationId
-
- Required: Yes
- Type: string
The identifier of the assistant association.
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant.
- associationData
-
- Required: Yes
- Type: AssistantAssociationOutputData structure
The association data.
- associationType
-
- Required: Yes
- Type: string
The type of association.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
AssistantData
Description
The assistant data.
Members
- assistantArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the Wisdom assistant.
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant.
- description
-
- Type: string
The description.
- integrationConfiguration
-
- Type: AssistantIntegrationConfiguration structure
The configuration information for the Wisdom assistant integration.
- name
-
- Required: Yes
- Type: string
The name.
- serverSideEncryptionConfiguration
-
- Type: ServerSideEncryptionConfiguration structure
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.
- status
-
- Required: Yes
- Type: string
The status of the assistant.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
- type
-
- Required: Yes
- Type: string
The type of assistant.
AssistantIntegrationConfiguration
Description
The configuration information for the Wisdom assistant integration.
Members
- topicIntegrationArn
-
- Type: string
The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
AssistantSummary
Description
Summary information about the assistant.
Members
- assistantArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the Wisdom assistant.
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant.
- description
-
- Type: string
The description of the assistant.
- integrationConfiguration
-
- Type: AssistantIntegrationConfiguration structure
The configuration information for the Wisdom assistant integration.
- name
-
- Required: Yes
- Type: string
The name of the assistant.
- serverSideEncryptionConfiguration
-
- Type: ServerSideEncryptionConfiguration structure
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.
- status
-
- Required: Yes
- Type: string
The status of the assistant.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
- type
-
- Required: Yes
- Type: string
The type of the assistant.
Configuration
Description
The configuration information of the external data source.
Members
- connectConfiguration
-
- Type: ConnectConfiguration structure
The configuration information of the Amazon Connect data source.
ConflictException
Description
The request could not be processed because of conflict in the current state of the resource. For example, if you're using a Create
API (such as CreateAssistant
) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.
Members
- message
-
- Type: string
ConnectConfiguration
Description
The configuration information of the Amazon Connect data source.
Members
- instanceId
-
- Type: string
The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.
ContentData
Description
Information about the content.
Members
- contentArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the content.
- contentId
-
- Required: Yes
- Type: string
The identifier of the content.
- contentType
-
- Required: Yes
- Type: string
The media type of the content.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- linkOutUri
-
- Type: string
The URI of the content.
- metadata
-
- Required: Yes
- Type: Associative array of custom strings keys (NonEmptyString) to strings
A key/value map to store attributes without affecting tagging or recommendations. For example, when synchronizing data between an external system and Wisdom, you can store an external version identifier as metadata to utilize for determining drift.
- name
-
- Required: Yes
- Type: string
The name of the content.
- revisionId
-
- Required: Yes
- Type: string
The identifier of the content revision.
- status
-
- Required: Yes
- Type: string
The status of the content.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
- title
-
- Required: Yes
- Type: string
The title of the content.
- url
-
- Required: Yes
- Type: string
The URL of the content.
- urlExpiry
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The expiration time of the URL as an epoch timestamp.
ContentReference
Description
Reference information about the content.
Members
- contentArn
-
- Type: string
The Amazon Resource Name (ARN) of the content.
- contentId
-
- Type: string
The identifier of the content.
- knowledgeBaseArn
-
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
ContentSummary
Description
Summary information about the content.
Members
- contentArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the content.
- contentId
-
- Required: Yes
- Type: string
The identifier of the content.
- contentType
-
- Required: Yes
- Type: string
The media type of the content.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- metadata
-
- Required: Yes
- Type: Associative array of custom strings keys (NonEmptyString) to strings
A key/value map to store attributes without affecting tagging or recommendations. For example, when synchronizing data between an external system and Wisdom, you can store an external version identifier as metadata to utilize for determining drift.
- name
-
- Required: Yes
- Type: string
The name of the content.
- revisionId
-
- Required: Yes
- Type: string
The identifier of the revision of the content.
- status
-
- Required: Yes
- Type: string
The status of the content.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
- title
-
- Required: Yes
- Type: string
The title of the content.
Document
Description
The document.
Members
- contentReference
-
- Required: Yes
- Type: ContentReference structure
A reference to the content resource.
- excerpt
-
- Type: DocumentText structure
The excerpt from the document.
- title
-
- Type: DocumentText structure
The title of the document.
DocumentText
Description
The text of the document.
Members
- highlights
-
- Type: Array of Highlight structures
Highlights in the document text.
- text
-
- Type: string
Text in the document.
ExternalSourceConfiguration
Description
The configuration information of the external data source.
Members
- configuration
-
- Required: Yes
- Type: Configuration structure
The configuration information of the external data source.
- source
-
- Required: Yes
- Type: string
The type of the external data source.
Filter
Description
A search filter.
Members
- field
-
- Required: Yes
- Type: string
The field on which to filter.
- operator
-
- Required: Yes
- Type: string
The operator to use for comparing the field’s value with the provided value.
- value
-
- Required: Yes
- Type: string
The desired field value on which to filter.
GroupingConfiguration
Description
The configuration information of the grouping of Wisdom users.
Members
- criteria
-
- Type: string
The criteria used for grouping Wisdom users.
The following is the list of supported criteria values.
-
RoutingProfileArn
: Grouping the users by their Amazon Connect routing profile ARN. User should have SearchRoutingProfile and DescribeRoutingProfile permissions when setting criteria to this value.
- values
-
- Type: Array of strings
The list of values that define different groups of Wisdom users.
-
When setting
criteria
toRoutingProfileArn
, you need to provide a list of ARNs of Amazon Connect routing profiles as values of this parameter.
Highlight
Description
Offset specification to describe highlighting of document excerpts for rendering search results and recommendations.
Members
- beginOffsetInclusive
-
- Type: int
The offset for the start of the highlight.
- endOffsetExclusive
-
- Type: int
The offset for the end of the highlight.
ImportJobData
Description
Summary information about the import job.
Members
- createdTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the import job was created.
- externalSourceConfiguration
-
- Type: ExternalSourceConfiguration structure
The configuration information of the external data source.
- failedRecordReport
-
- Type: string
The link to donwload the information of resource data that failed to be imported.
- importJobId
-
- Required: Yes
- Type: string
The identifier of the import job.
- importJobType
-
- Required: Yes
- Type: string
The type of the import job.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- lastModifiedTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the import job data was last modified.
- metadata
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
The metadata fields of the imported Wisdom resources.
- status
-
- Required: Yes
- Type: string
The status of the import job.
- uploadId
-
- Required: Yes
- Type: string
A pointer to the uploaded asset. This value is returned by StartContentUpload.
- url
-
- Required: Yes
- Type: string
The download link to the resource file that is uploaded to the import job.
- urlExpiry
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The expiration time of the URL as an epoch timestamp.
ImportJobSummary
Description
Summary information about the import job.
Members
- createdTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the import job was created.
- externalSourceConfiguration
-
- Type: ExternalSourceConfiguration structure
The configuration information of the external source that the resource data are imported from.
- importJobId
-
- Required: Yes
- Type: string
The identifier of the import job.
- importJobType
-
- Required: Yes
- Type: string
The type of import job.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- lastModifiedTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the import job was last modified.
- metadata
-
- Type: Associative array of custom strings keys (NonEmptyString) to strings
The metadata fields of the imported Wisdom resources.
- status
-
- Required: Yes
- Type: string
The status of the import job.
- uploadId
-
- Required: Yes
- Type: string
A pointer to the uploaded asset. This value is returned by StartContentUpload.
KnowledgeBaseAssociationData
Description
Association information about the knowledge base.
Members
- knowledgeBaseArn
-
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
KnowledgeBaseData
Description
Information about the knowledge base.
Members
- description
-
- Type: string
The description.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- knowledgeBaseType
-
- Required: Yes
- Type: string
The type of knowledge base.
- lastContentModificationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
An epoch timestamp indicating the most recent content modification inside the knowledge base. If no content exists in a knowledge base, this value is unset.
- name
-
- Required: Yes
- Type: string
The name of the knowledge base.
- renderingConfiguration
-
- Type: RenderingConfiguration structure
Information about how to render the content.
- serverSideEncryptionConfiguration
-
- Type: ServerSideEncryptionConfiguration structure
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.For more information about setting up a customer managed key for Wisdom, see Enable Amazon Connect Wisdom for your instance.
- sourceConfiguration
-
- Type: SourceConfiguration structure
Source configuration information about the knowledge base.
- status
-
- Required: Yes
- Type: string
The status of the knowledge base.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
KnowledgeBaseSummary
Description
Summary information about the knowledge base.
Members
- description
-
- Type: string
The description of the knowledge base.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- knowledgeBaseType
-
- Required: Yes
- Type: string
The type of knowledge base.
- name
-
- Required: Yes
- Type: string
The name of the knowledge base.
- renderingConfiguration
-
- Type: RenderingConfiguration structure
Information about how to render the content.
- serverSideEncryptionConfiguration
-
- Type: ServerSideEncryptionConfiguration structure
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/kms:GenerateDataKey
permissions to the IAM identity using the key to invoke Wisdom.For more information about setting up a customer managed key for Wisdom, see Enable Amazon Connect Wisdom for your instance.
- sourceConfiguration
-
- Type: SourceConfiguration structure
Configuration information about the external data source.
- status
-
- Required: Yes
- Type: string
The status of the knowledge base summary.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
NotifyRecommendationsReceivedError
Description
An error occurred when creating a recommendation.
Members
- message
-
- Type: string
A recommendation is causing an error.
- recommendationId
-
- Type: string
The identifier of the recommendation that is in error.
PreconditionFailedException
Description
The provided revisionId
does not match, indicating the content has been modified since it was last read.
Members
- message
-
- Type: string
QueryRecommendationTriggerData
Description
Data associated with the QUERY RecommendationTriggerType.
Members
- text
-
- Type: string
The text associated with the recommendation trigger.
QuickResponseContentProvider
Description
The container quick response content.
Members
- content
-
- Type: string
The content of the quick response.
QuickResponseContents
Description
The content of the quick response stored in different media types.
Members
- markdown
-
- Type: QuickResponseContentProvider structure
The container quick response content.
- plainText
-
- Type: QuickResponseContentProvider structure
The container quick response content.
QuickResponseData
Description
Information about the quick response.
Members
- channels
-
- Type: Array of strings
The Amazon Connect contact channels this quick response applies to. The supported contact channel types include
Chat
. - contentType
-
- Required: Yes
- Type: string
The media type of the quick response content.
-
Use
application/x.quickresponse;format=plain
for quick response written in plain text. -
Use
application/x.quickresponse;format=markdown
for quick response written in richtext.
- contents
-
- Type: QuickResponseContents structure
The contents of the quick response.
- createdTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the quick response was created.
- description
-
- Type: string
The description of the quick response.
- groupingConfiguration
-
- Type: GroupingConfiguration structure
The configuration information of the user groups that the quick response is accessible to.
- isActive
-
- Type: boolean
Whether the quick response is active.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- language
-
- Type: string
The language code value for the language in which the quick response is written.
- lastModifiedBy
-
- Type: string
The Amazon Resource Name (ARN) of the user who last updated the quick response data.
- lastModifiedTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the quick response data was last modified.
- name
-
- Required: Yes
- Type: string
The name of the quick response.
- quickResponseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the quick response.
- quickResponseId
-
- Required: Yes
- Type: string
The identifier of the quick response.
- shortcutKey
-
- Type: string
The shortcut key of the quick response. The value should be unique across the knowledge base.
- status
-
- Required: Yes
- Type: string
The status of the quick response data.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
QuickResponseDataProvider
Description
The container of quick response data.
Members
- content
-
- Type: string
The content of the quick response.
QuickResponseFilterField
Description
The quick response fields to filter the quick response query results by.
The following is the list of supported field names.
-
name
-
description
-
shortcutKey
-
isActive
-
channels
-
language
-
contentType
-
createdTime
-
lastModifiedTime
-
lastModifiedBy
-
groupingConfiguration.criteria
-
groupingConfiguration.values
Members
- includeNoExistence
-
- Type: boolean
Whether to treat null value as a match for the attribute field.
- name
-
- Required: Yes
- Type: string
The name of the attribute field to filter the quick responses by.
- operator
-
- Required: Yes
- Type: string
The operator to use for filtering.
- values
-
- Type: Array of strings
The values of attribute field to filter the quick response by.
QuickResponseOrderField
Description
The quick response fields to order the quick response query results by.
The following is the list of supported field names.
-
name
-
description
-
shortcutKey
-
isActive
-
channels
-
language
-
contentType
-
createdTime
-
lastModifiedTime
-
lastModifiedBy
-
groupingConfiguration.criteria
-
groupingConfiguration.values
Members
- name
-
- Required: Yes
- Type: string
The name of the attribute to order the quick response query results by.
- order
-
- Type: string
The order at which the quick responses are sorted by.
QuickResponseQueryField
Description
The quick response fields to query quick responses by.
The following is the list of supported field names.
-
content
-
name
-
description
-
shortcutKey
Members
- allowFuzziness
-
- Type: boolean
Whether the query expects only exact matches on the attribute field values. The results of the query will only include exact matches if this parameter is set to false.
- name
-
- Required: Yes
- Type: string
The name of the attribute to query the quick responses by.
- operator
-
- Required: Yes
- Type: string
The operator to use for matching attribute field values in the query.
- priority
-
- Type: string
The importance of the attribute field when calculating query result relevancy scores. The value set for this parameter affects the ordering of search results.
- values
-
- Required: Yes
- Type: Array of strings
The values of the attribute to query the quick responses by.
QuickResponseSearchExpression
Description
Information about the import job.
Members
- filters
-
- Type: Array of QuickResponseFilterField structures
The configuration of filtering rules applied to quick response query results.
- orderOnField
-
- Type: QuickResponseOrderField structure
The quick response attribute fields on which the query results are ordered.
- queries
-
- Type: Array of QuickResponseQueryField structures
The quick response query expressions.
QuickResponseSearchResultData
Description
The result of quick response search.
Members
- attributesInterpolated
-
- Type: Array of strings
The user defined contact attributes that are resolved when the search result is returned.
- attributesNotInterpolated
-
- Type: Array of strings
The user defined contact attributes that are not resolved when the search result is returned.
- channels
-
- Type: Array of strings
The Amazon Connect contact channels this quick response applies to. The supported contact channel types include
Chat
. - contentType
-
- Required: Yes
- Type: string
The media type of the quick response content.
-
Use
application/x.quickresponse;format=plain
for quick response written in plain text. -
Use
application/x.quickresponse;format=markdown
for quick response written in richtext.
- contents
-
- Required: Yes
- Type: QuickResponseContents structure
The contents of the quick response.
- createdTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the quick response was created.
- description
-
- Type: string
The description of the quick response.
- groupingConfiguration
-
- Type: GroupingConfiguration structure
The configuration information of the user groups that the quick response is accessible to.
- isActive
-
- Required: Yes
- Type: boolean
Whether the quick response is active.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
- language
-
- Type: string
The language code value for the language in which the quick response is written.
- lastModifiedBy
-
- Type: string
The Amazon Resource Name (ARN) of the user who last updated the quick response search result data.
- lastModifiedTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the quick response search result data was last modified.
- name
-
- Required: Yes
- Type: string
The name of the quick response.
- quickResponseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the quick response.
- quickResponseId
-
- Required: Yes
- Type: string
The identifier of the quick response.
- shortcutKey
-
- Type: string
The shortcut key of the quick response. The value should be unique across the knowledge base.
- status
-
- Required: Yes
- Type: string
The resource status of the quick response.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
QuickResponseSummary
Description
The summary information about the quick response.
Members
- channels
-
- Type: Array of strings
The Amazon Connect contact channels this quick response applies to. The supported contact channel types include
Chat
. - contentType
-
- Required: Yes
- Type: string
The media type of the quick response content.
-
Use
application/x.quickresponse;format=plain
for quick response written in plain text. -
Use
application/x.quickresponse;format=markdown
for quick response written in richtext.
- createdTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the quick response was created.
- description
-
- Type: string
The description of the quick response.
- isActive
-
- Type: boolean
Whether the quick response is active.
- knowledgeBaseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the knowledge base.
- knowledgeBaseId
-
- Required: Yes
- Type: string
The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it.
- lastModifiedBy
-
- Type: string
The Amazon Resource Name (ARN) of the user who last updated the quick response data.
- lastModifiedTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp when the quick response summary was last modified.
- name
-
- Required: Yes
- Type: string
The name of the quick response.
- quickResponseArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the quick response.
- quickResponseId
-
- Required: Yes
- Type: string
The identifier of the quick response.
- status
-
- Required: Yes
- Type: string
The resource status of the quick response.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
RecommendationData
Description
Information about the recommendation.
Members
- document
-
- Required: Yes
- Type: Document structure
The recommended document.
- recommendationId
-
- Required: Yes
- Type: string
The identifier of the recommendation.
- relevanceLevel
-
- Type: string
The relevance level of the recommendation.
- relevanceScore
-
- Type: double
The relevance score of the recommendation.
- type
-
- Type: string
The type of recommendation.
RecommendationTrigger
Description
A recommendation trigger provides context on the event that produced the referenced recommendations. Recommendations are only referenced in recommendationIds
by a single RecommendationTrigger.
Members
- data
-
- Required: Yes
- Type: RecommendationTriggerData structure
A union type containing information related to the trigger.
- id
-
- Required: Yes
- Type: string
The identifier of the recommendation trigger.
- recommendationIds
-
- Required: Yes
- Type: Array of strings
The identifiers of the recommendations.
- source
-
- Required: Yes
- Type: string
The source of the recommendation trigger.
-
ISSUE_DETECTION: The corresponding recommendations were triggered by a Contact Lens issue.
-
RULE_EVALUATION: The corresponding recommendations were triggered by a Contact Lens rule.
- type
-
- Required: Yes
- Type: string
The type of recommendation trigger.
RecommendationTriggerData
Description
A union type containing information related to the trigger.
Members
- query
-
- Type: QueryRecommendationTriggerData structure
Data associated with the QUERY RecommendationTriggerType.
RenderingConfiguration
Description
Information about how to render the content.
Members
- templateUri
-
- Type: string
A URI template containing exactly one variable in
${variableName}
format. This can only be set forEXTERNAL
knowledge bases. For Salesforce, ServiceNow, and Zendesk, the variable must be one of the following:-
Salesforce:
Id
,ArticleNumber
,VersionNumber
,Title
,PublishStatus
, orIsDeleted
-
ServiceNow:
number
,short_description
,sys_mod_count
,workflow_state
, oractive
-
Zendesk:
id
,title
,updated_at
, ordraft
The variable is replaced with the actual value for a piece of content when calling GetContent.
RequestTimeoutException
Description
The request reached the service more than 15 minutes after the date stamp on the request or more than 15 minutes after the request expiration date (such as for pre-signed URLs), or the date stamp on the request is more than 15 minutes in the future.
Members
- message
-
- Type: string
ResourceNotFoundException
Description
The specified resource does not exist.
Members
- message
-
- Type: string
- resourceName
-
- Type: string
The specified resource name.
ResultData
Description
Information about the result.
Members
- document
-
- Required: Yes
- Type: Document structure
The document.
- relevanceScore
-
- Type: double
The relevance score of the results.
- resultId
-
- Required: Yes
- Type: string
The identifier of the result data.
SearchExpression
Description
The search expression.
Members
- filters
-
- Required: Yes
- Type: Array of Filter structures
The search expression filters.
ServerSideEncryptionConfiguration
Description
The configuration information for the customer managed key used for encryption.
Members
- kmsKeyId
-
- Type: 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).
ServiceQuotaExceededException
Description
You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.
Members
- message
-
- Type: string
SessionData
Description
Information about the session.
Members
- description
-
- Type: string
The description of the session.
- integrationConfiguration
-
- Type: SessionIntegrationConfiguration structure
The configuration information for the session integration.
- name
-
- Required: Yes
- Type: string
The name of the session.
- sessionArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the session.
- sessionId
-
- Required: Yes
- Type: string
The identifier of the session.
- tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The tags used to organize, track, or control access for this resource.
SessionIntegrationConfiguration
Description
The configuration information for the session integration.
Members
- topicIntegrationArn
-
- Type: string
The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
SessionSummary
Description
Summary information about the session.
Members
- assistantArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the Wisdom assistant.
- assistantId
-
- Required: Yes
- Type: string
The identifier of the Wisdom assistant.
- sessionArn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the session.
- sessionId
-
- Required: Yes
- Type: string
The identifier of the session.
SourceConfiguration
Description
Configuration information about the external data source.
Members
- appIntegrations
-
- Type: AppIntegrationsConfiguration structure
Configuration information for Amazon AppIntegrations to automatically ingest content.
TooManyTagsException
Description
Amazon Connect Wisdom throws this exception if you have too many tags in your tag set.
Members
- message
-
- Type: string
- resourceName
-
- Type: string
The specified resource name.
ValidationException
Description
The input fails to satisfy the constraints specified by a service.
Members
- message
-
- Type: string