将自定义知识文件上传到 Knowledge Hub

您可以通过 Knowledge HubAPI将文件添加到关闭 应用程序编程接口。 允许通过将您的 CXone Mpower 系统与其他软件连接来实现特定功能的自动化。中的知识库。 这允许您使用自定义知识源关闭 托管知识文章的知识管理系统。中的文件填充知识库。 这意味着即使您不使用 Knowledge Hub支持的知识源也可以使用。 然后，您可以将 Copilot for Agents 配置为使用自定义知识文件生成内容。

此方法是开发人员的工作成果。 它需要 REST API 知识以及使用 API 发送文件的编程能力。

请注意：

  • 单个文件的最大文件大小为 50 MB。

  • 您一次最多可以传输 100 个文件。

按照给定的顺序完成以下每一个任务。

配置知识库

按照以下步骤在 Knowledge Hub 中配置知识库以使用自定义数据源。 这将为知识库生成必要的 ID，您必须将其包含在传输文件的 API 调用中。

如果您还没有知识库，请联系 NiCE 专业服务。 只有 NiCE Professional Services 可以创建新的知识库。

  1. 在 CXone Mpower 中单击应用程序选择器 并选择Admin > GenAI Manager >Knowledge Hub。

  2. 单击要向其添加自定义数据源的知识库。

  3. 在 知识库源 下拉列表中，选择 自定义。

  4. 单击提交。

获取 Access Token

要使用 Knowledge Hub API，您必须在调用的标头中包含访问令牌。 要获取访问令牌，您必须交换 NiCE提供的某些凭证。 请按照开发人员门户上的入门说明 执行此作。 稍后，您应该在 API 调用中包含此访问令牌。 它让CXone Mpower知道该呼叫不是欺诈性的。

您可以在 CXone Mpower 中阅读有关 API 身份验证和授权的更多详细信息。

获取 ID

要使用 Knowledge Hub API传输文件，您必须包含两个 ID：

  • Data Source ID：唯一 ID自定义数据源的字符串。 这会告诉 API 从何处提取内容。

  • Knowledge Hub ID：唯一 ID您配置的知识库的字符串。 这会告诉 API 将内容推送到何处。

您可以通过调用 GET /knowledgehub API来获取这两个：

  1. 致电 https://api-na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub API。 您可能需要更换该URL中的na1;它应与 nice-incontact.com URL中 CXone Mpower 前面的内容匹配。 请务必包含您的访问令牌。

    
curl --location 'https://api.na1.niceincontact.com/eai-knowledge-hub-services/config/v1/knowledgehub' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [CXone token]'

  2. 在响应中，在 Knowledge Hub ID 数组的 id 属性中找到 knowledgeBases。

    其中，将突出显示 knowledgeBases 数组顶部的 id 属性。 它的值是一个长字母数字字符串。

  3. 在 data source ID 数组的 id 属性中找到 dataSources。

    突出显示 dataSources 数组顶部的 id 属性。 它的值是一个长字母数字字符串。

使用 Knowledge Hub API 推送文件

您一次最多可以将 100 个文件推送到 Knowledge Hub。 每个文件的最大大小为 50 MB。

创建一个使用 POST /documents API 将文件推送到 Knowledge Hub的脚本。 您可以使用您选择的语言编写此脚本，例如 Python、C# 或 Java。 您可以使用此示例 Python 脚本作为模板。 将脚本设置为按计划自动运行，以使用自定义知识源中的最新内容更新Knowledge Hub。

在 调用的请求正文中输入您在上一步中获取POST /documents API的 ID 作为字符串参数。

  1. 签到 DEVone 开发人员社区 使用您的 CXone Mpower 凭证。

  2. 导航到 POST /documents 页面。

  3. 单击 Try it out。

  4. 在 documents 数组中编辑这些值：

    1. 在 clientToken中，输入您在 authentication期间收到的访问令牌。

    2. 在 dataSourceId中，输入您的data source ID。

    3. 在 knowledgeHubId中，输入您的Knowledge Hub ID。

  5. 将配置的 JSON 复制到您的脚本中。

然后，您的自定义知识将发送到 Knowledge Hub。 Knowledge Hub 会提取并解析它以供 LLM关闭 大语言模型。 一种人工智能，可基于上下文处理、理解和生成人类语言。使用。 它将在您配置的知识库下显示为知识源。