ConnectWisdomService / Client / update_knowledge_base_template_uri

update_knowledge_base_template_uri

ConnectWisdomService.Client.update_knowledge_base_template_uri(**kwargs)

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.

See also: AWS API Documentation

Request Syntax

response = client.update_knowledge_base_template_uri(
    knowledgeBaseId='string',
    templateUri='string'
)

Parameters:

• knowledgeBaseId (string) –

  [REQUIRED]

  The identifier of the knowledge base. Can be either the ID or the ARN. URLs cannot contain the ARN.

• templateUri (string) –

  [REQUIRED]

  The template URI to update.

Return type:

dict

Returns:

Response Syntax

{
    'knowledgeBase': {
        'description': 'string',
        'knowledgeBaseArn': 'string',
        'knowledgeBaseId': 'string',
        'knowledgeBaseType': 'EXTERNAL'|'CUSTOM',
        'lastContentModificationTime': datetime(2015, 1, 1),
        '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': 'string'
        }
    }
}

Response Structure

• (dict) –

  • knowledgeBase (dict) –

    The knowledge base to update.

    • description (string) –

      The description.

    • knowledgeBaseArn (string) –

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

    • knowledgeBaseId (string) –

      The identifier of the knowledge base.

    • knowledgeBaseType (string) –

      The type of knowledge base.

    • lastContentModificationTime (datetime) –

      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 (string) –

      The name of the knowledge base.

    • renderingConfiguration (dict) –

      Information about how to render the content.

      • templateUri (string) –

        A URI template containing exactly one variable in ${variableName} ``format. This can only be set for ``EXTERNAL knowledge bases. For Salesforce, ServiceNow, and Zendesk, the variable must be one of the following:

        • Salesforce: Id, ArticleNumber, VersionNumber, Title, PublishStatus, or IsDeleted

        • ServiceNow: number, short_description, sys_mod_count, workflow_state, or active

        • Zendesk: id, title, updated_at, or draft

        The variable is replaced with the actual value for a piece of content when calling GetContent.

    • serverSideEncryptionConfiguration (dict) –

      The KMS key used for encryption.

      • kmsKeyId (string) –

        The KMS key. For information about valid ID values, see Key identifiers (KeyId).

    • sourceConfiguration (dict) –

      Source configuration information about the knowledge base.

      Note

      This is a Tagged Union structure. Only one of the following top level keys will be set: appIntegrations. 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'}
      

      • appIntegrations (dict) –

        Configuration information for Amazon AppIntegrations to automatically ingest content.

        • appIntegrationArn (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, and IsDeleted 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, and active as source fields.

          • For Zendesk, your AppIntegrations DataIntegration must have an ObjectConfiguration if objectFields is not provided, including at least id, title, updated_at, and draft as source fields.

          • For SharePoint, your AppIntegrations DataIntegration must have a FileConfiguration, including only file extensions that are among docx, pdf, html, htm, and txt.

        • objectFields (list) –

          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, and IsDeleted.

          • For ServiceNow, you must include at least number, short_description, sys_mod_count, workflow_state, and active.

          • For Zendesk, you must include at least id, title, updated_at, and draft.

          Make sure to include additional fields. These fields are indexed and used to source recommendations.

          • (string) –

    • status (string) –

      The status of the knowledge base.

    • tags (dict) –

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

      • (string) –

        • (string) –

Exceptions

• ConnectWisdomService.Client.exceptions.ValidationException

• ConnectWisdomService.Client.exceptions.AccessDeniedException

• ConnectWisdomService.Client.exceptions.ResourceNotFoundException