添加 CXG AI 连接器

创建 Integration User

注意：该步骤包含在 CXG Quick Setup 自动配置流程（CXG Quick Setup 快速配置）中，如已配置则跳过。如果下述 Integration User 已经通过 Connected Experiences Gateway 中别的集成应用添加，那么可以跳过创建，直接使用同一个 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 （需要具备 Knowledge User License）

   7. User License 选择 Salesforce Integration

   8. Profile 选择 Minimum Access - API Only Integrations

2. 保存新创建的 User。

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

4. 保存，完成。

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

注意：该步骤包含在 CXG Quick Setup 自动配置流程（CXG Quick Setup 快速配置）中，如已配置则跳过。如果您已经在其他功能中创建过 CXG Canvas App Assignment 这个权限集，则可跳过新建步骤，直接将这个权限集赋予给 Integration User （CXG Automated）。

操作步骤

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

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

   2. b. License 选择 None

2. 保存，跳转 Permission Set 详情页。

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

4. 点击 Manage Assignment > Add Assignment，勾选所有需要访问 Connected App 的用户，包含但不仅限于：

   1. Integration User (CXG Automated)

5. 保存，完成。

注意：该步骤需要手动配置。如果您已经在其他功能中配置过 CXG Canvas 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。

   说明

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

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

5. 保存，完成。

1. 开通百炼服务

• 进入阿里云百炼平台官网，进入 “控制台”，点击 “立即开通”，确认服务协议并完成开通

2. 创建 Workspace 并获取 Workspace ID

• 进入工作区管理页面，在控制台导航栏右上角，点击“设置”，选择 “业务空间管理”

• 使用默认业务空间或点击 “新增业务空间”创建业务空间

• 在业务空间管理列表，复制对应的 Workspace ID

3. 获取 API Key

• 在控制台导航栏右上角，点击“设置”，选择 “ API Key”，进入 API Key 管理页面

• 点击 “创建 API Key”，选择对应的业务空间，在 API Key 生成后复制 API Key

  1. 只有管理员或具有 API-key 权限的账号才能访问 API Key 页面。

  2. 创建新的 API Key 时，选择归属账号，选择归属业务空间。推荐选择主账号空间，无需授权模型。如果选择子空间，则需要归属账号对子空间有 API-key 权限。

  3. API Key 需要分配给任意业务空间下的任意账号。

4. 授权子空间模型：

使用子空间 API Key 需由主账号管理员为对应子空间开通模型授权。

前往 业务空间管理 页面，点击子空间的模型权限流控设置，授权 Qwen-max/plus/flash/turbo以及deepseek v3.2/Qwen3-max模型。

• 确保 Connected Experiences Gateway Package 已经成功安装和更新到您的 Salesforce 组织中。

  • 为了让您便捷接入，阿里云团队会帮助您预先安装好 Package。管理员可以使用Salesforce账号登录您的目标组织，前往Salesforce Platform，点击Setup > Installed Package，检查Package是否已经安装完成。

  • 如需更新安装包，请查看安装或升级CXG产品的托管软件包（Managed Package）

• 建立 CXG 与 阿里云百炼 的连接。

  • 前往 CXG 设置 - Connector 模块，创建 阿里云百炼 连接器。

  • 进入 CXG Setup 界面，找到 Connectors 管理页面

  • 点击 Connect - LLM Service ，选择 Connect to Alibaba Cloud Model Studio

  • 输入 Name，百炼平台的 Workspace ID 和 API Key

  • 

• 针对Sandbox使用的检查：

  • 如果您的sandbox创建时间早于CXG AI 试用开通时间，请检查许可证是否已同步