添加 CXG RAG连接器

更新时间:
复制为 MD 格式

一、租户权限配置

权限集需求Permission Sets

  • CXG Admin User

  • CXG Use RAG Service

  • CXG Canvas App Assignment

  • CXG Integration User

  • CXG Manage RAG Integration and Data Library

  • Knowledge Manager Permission Set

  • Einstein for Service Innovations

  • Prompt Template User

  • Prompt Template Manager

  • User开启Knowledge User

创建 Integration User

操作步骤

  1. 登录 Salesforce Platform,点击 Setup > Users > New。

    1. Last Name 填写⽤户名字,建议填 CXG Automated

    2. Alias 填写名字简称,建议填 CXG

    3. Email 填写⽤户邮箱

    4. Username 填写⽤户名,不能重复

    5. Nickname 填写昵称,或者使⽤默认

    6. 选中Knowledge User

    7. User License 选择 Salesforce Integration

    8. Profile 选择 Salesforce API Only System Integrations

  2. 保存新创建的 User。

  3. User 详情⻚中,点击 Permission Set Assignment > Edit Assignment,选择 CXG Integration User 权限集。

  4. 保存,完成。

赋予 Integration User Connected App 权限

Permission Set 中允许设置 Assigned Connected App,但包含 1GP Connected App 的 Permission Set ⽆法通过 Package 打包。因此管理员必须⼿动创建⼀个 Permission Set,包含访问和使⽤ CXG Connected App 的权限,并且将该权限赋予给需要使⽤ CXG Connected App 功能的员⼯。

操作步骤

  1. 前往 Salesforce Platform,点击 Setup > Permission Sets > New。

    1. Label 填写 Permission Set 的名字,建议填 CXG Canvas App Assignment

    2. License 选择 None

  2. 保存,跳转 Permission Set 详情⻚。

  3. 点击 Assigned Connected App > Edit,选择 CXG_CANVAS > 保存。

  4. 点击 Manage Assignment > Add Assignment,勾选所有需要访问 Connected App 的⽤户,包含但不仅限于:Integration User (CXG Automated)

  5. 保存,完成。

配置 Connected App

Connected App 是⼀个技术框架,它能使外部应⽤程序和 Salesforce Platform 通过调⽤ API 和设定标准协议进⾏集成。更多了解请阅读What is Salesforce Connected Apps? 我们通过 Connected App 实现客服消息功能以及从 CXG 侧操作相关数据对象。在此之前,需要对 CXG Connected App 配置 OAuth 授权⽅式,API 调⽤ Integration ⽤户以及权限集。

前提条件

  1. Package 成功安装后,Connected App 就已经成功添加到 Salesforce Platform 中。

  2. 已经创建 Integration ⽤户。

  3. 已经完成所有权限相关的配置。

操作步骤

  1. 登录 Salesforce Platform,点击 Setup,快速查找 App Manager。

  2. 找到 CXG_CANVAS,操作栏点击 Manage。

  3. 点击 Edit Policies > OAuth Policies > Permitted Users,选择 Admin approved users are pre-authorized

  4. 点击 Client Credentials Flow > Run As,查找 CXG Automated 并选择。

  5. 保存,完成。

注意:OAuth Policies 选择 Admin approved users are pre-authorized 模式是 CXG Connected App 安全性的重要保障,更新为 Admin approved 模式后不建议再次改动。

配置 CXG Integration User Setup

说明

Permission Set 中的标准对象权限、应⽤权限、和查询配置等权限最终⽆法通过 Package 交付。因此这部分赋权需要管理员⼿动配置。Integration User 需要拥有以上权限,才能完成 CXG 预设的功能。因此管理员需要根据指引⼿动创建权限集,并将其分配给 Integration User。这⾥需要⼿动创建的权限集为 CXG Integration User Setup Access

操作步骤

  1. 登录 Salesforce Platform,点击 Setup > Permission Sets > New。

  • Label 填写 Permission Set 的名字,建议填 CXG Integration User Setup Access

  • API Name 使⽤默认

  • Description 填写描述

  • License 选择 Salesforce API Integration

  1. 保存,跳转 Permission Set 详情⻚。

  2. 点击 Object Settings > Knowledge > Edit > Object Permissions > 勾选 View All RecordsView All Fields > 保存。

  3. 点击 Manage Assignment > Add Assignment,勾选 Integration User (CXG Automated)。

  4. 保存,完成。

二、添加 CXG RAG 连接器

创建 RAG Service Connector

前提条件

  1. 确保已购买 RAG 服务相关资源

  2. 操作者具备 CXG Admin 权限集

操作步骤

  1. 前往 Salesforce, 打开 CXG - Setup。

  2. 打开 Connector ⻚⾯,点击连接按钮。选择 RAG Service, 点击确认。

  3. 系统⾃动检测该Salesforce Org ID下是否已存在RAG Workspace,存在则连接成功。