QConnect / Client / create_content_association

create_content_association#

QConnect.Client.create_content_association(**kwargs)#

Creates an association between a content resource in a knowledge base and step-by-step guides. Step-by-step guides offer instructions to agents for resolving common customer issues. You create a content association to integrate Amazon Q in Connect and step-by-step guides.

After you integrate Amazon Q and step-by-step guides, when Amazon Q provides a recommendation to an agent based on the intent that it’s detected, it also provides them with the option to start the step-by-step guide that you have associated with the content.

Note the following limitations:

  • You can create only one content association for each content resource in a knowledge base.

  • You can associate a step-by-step guide with multiple content resources.

For more information, see Integrate Amazon Q in Connect with step-by-step guides in the Amazon Connect Administrator Guide.

See also: AWS API Documentation

Request Syntax

response = client.create_content_association(
    association={
        'amazonConnectGuideAssociation': {
            'flowId': 'string'
        }
    },
    associationType='AMAZON_CONNECT_GUIDE',
    clientToken='string',
    contentId='string',
    knowledgeBaseId='string',
    tags={
        'string': 'string'
    }
)
Parameters:

  • association (dict) –

    [REQUIRED]

    The identifier of the associated resource.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: amazonConnectGuideAssociation.

    • amazonConnectGuideAssociation (dict) –

      The data of the step-by-step guide association.

      • flowId (string) –

        The Amazon Resource Name (ARN) of an Amazon Connect flow. Step-by-step guides are a type of flow.

  • associationType (string) –

    [REQUIRED]

    The type of association.

  • clientToken (string) –

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

    This field is autopopulated if not provided.

  • contentId (string) –

    [REQUIRED]

    The identifier of the content.

  • knowledgeBaseId (string) –

    [REQUIRED]

    The identifier of the knowledge base.

  • tags (dict) –

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

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'contentAssociation': {
        'associationData': {
            'amazonConnectGuideAssociation': {
                'flowId': 'string'
            }
        },
        'associationType': 'AMAZON_CONNECT_GUIDE',
        'contentArn': 'string',
        'contentAssociationArn': 'string',
        'contentAssociationId': 'string',
        'contentId': 'string',
        'knowledgeBaseArn': 'string',
        'knowledgeBaseId': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • contentAssociation (dict) –

      The association between Amazon Q in Connect content and another resource.

      • associationData (dict) –

        The content association.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: amazonConnectGuideAssociation. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}

        • amazonConnectGuideAssociation (dict) –

          The data of the step-by-step guide association.

          • flowId (string) –

            The Amazon Resource Name (ARN) of an Amazon Connect flow. Step-by-step guides are a type of flow.

      • associationType (string) –

        The type of association.

      • contentArn (string) –

        The Amazon Resource Name (ARN) of the content.

      • contentAssociationArn (string) –

        The Amazon Resource Name (ARN) of the content association.

      • contentAssociationId (string) –

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

      • contentId (string) –

        The identifier of the content.

      • knowledgeBaseArn (string) –

        The Amazon Resource Name (ARN) of the knowledge base.

      • knowledgeBaseId (string) –

        The identifier of the knowledge base.

      • tags (dict) –

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

        • (string) –

          • (string) –

Exceptions

  • QConnect.Client.exceptions.ConflictException

  • QConnect.Client.exceptions.ValidationException

  • QConnect.Client.exceptions.ServiceQuotaExceededException

  • QConnect.Client.exceptions.AccessDeniedException

  • QConnect.Client.exceptions.ResourceNotFoundException

  • QConnect.Client.exceptions.ThrottlingException