education-cloud-student-recruitment-agent-configure

配置 Education Cloud 招生 Agent

范围

• 范围内：完整的 SRA 设置流程——三个平台开关（Einstein、SRA、Omni-Channel；Agentforce 预配是步骤 1 中仅供验证的关卡，不是此技能要切换的开关）、EducationCloudAiAgentAccess 权限集 + OWD/共享基础、Learning Program 接地（Data Cloud 数据流 + 混合搜索索引 + 提示词模板）和 Knowledge/数据库接地、创建 Service（未身份验证）和 Employee（已身份验证）Agent、添加 4 个打包的 SRA 子 Agent、构建客户升级处理子 Agent、克隆并配置 6 个招生流程（Service 路径），以及部署到 Experience Cloud 渠道并验证用户。
• 范围外：Transfer Credit Agent（独立的 Agent，有自己的权限/帮助——绝不包含其步骤）；从零开始编写通用 Agentforce Agent（见下文“跨技能集成”）；SRA 接地路径之外的 Data Cloud 连接器配置；决定 Knowledge 文章内容。Claude 可以起草文章供客户审核，但文章内容由客户负责。
• EDU 基础是经过检查的依赖项，不是默认假设：SRA 依赖基本的 Education Cloud 启用、Person Accounts、R&A 域对象和 Data Cloud。此技能不会重新实现 education-cloud-domain-configure，而是会具体验证每项内容（步骤 2a），仅在检测到缺失时才引导用户前往该技能补齐缺项。

---

必需输入

开始前收集或推断以下信息：

• 目标组织：已预配 Agentforce 和 Education Cloud 且具有管理员访问权限的组织——参见工作流步骤 1 的关卡。
• Agent 路径：未身份验证（Service Agent——ASA，以 Einstein Agent User 服务帐户运行；没有访客用户）、已身份验证（Employee Agent），或两者兼有。
• 客户希望启用的子 Agent/主题（默认：全部 4 个打包的子 Agent + 自定义升级处理子 Agent）。
• 是否在升级处理子 Agent 中添加 Create Inquiry（在转接给真人客服时创建与案例相邻的记录）——如果未指定，请询问；有两种选项：仅转接，或转接并执行 Create Inquiry。

未指定时采用以下默认值：

• 如果组织同时具有 Service 和 Employee Agentforce 许可证，则配置两种 Agent 路径；否则仅配置未身份验证/Service 路径。
• 确认方式：对话式、一次一步——绝不自主执行。参见下文“与用户沟通”。

---

此技能的运行方式——请先阅读

**步骤 0 会解析组织当前的 API 版本；步骤 1 是严格的先决条件关卡——在处理任何其他事项前，必须通过这两项检查。**其余步骤（0–13）按顺序依次进行；每次执行不可逆或会影响组织配置的操作前都要确认，并在每个步骤结束时执行验证调用。（参见下文“与用户沟通”。）

每个会更改组织的步骤都会沿着三级阶梯执行，然后进行验证——层级取决于可用的运行环境： T1 无头 MCP（dispatch/dispatch_readonly，无 shell）· T2 sf CLI（需要 shell）· T3 Setup UI。先尝试 T1；遇到路由/允许列表错误时降至 T2；没有 shell 时使用 T3。每个步骤都标注了最佳层级；仅供验证的预检（步骤 1）则使用 STOP/REDIRECT 标签。references/execution-model.md 详细说明了阶梯流程、允许列表、路由信号、查询路由和 API 版本策略；不清楚层级或路由时请阅读。

有几个步骤必须使用 T3，完全没有 T1/T2 写入路径（将 Setup 路径交给用户，然后验证）——这些步骤会在相应位置内联标注（例如步骤 8、9a、12 中的 [T3 · ...]）；其他所有操作都有 T1 路径。

---

与用户沟通——面向客户的说明（不可省略）

**每次运行都必须遵守：在向客户发送第一条消息之前，完整阅读 references/customer-narration.md——这不是背景资料，而是你在整个会话每个步骤边界都必须遵循的准确措辞规则。**简而言之：步骤编号、层级标签（T1/T2/T3）以及“gate”“the spine”或“per the doc”之类的词语都是内部编写时的辅助内容——绝不要对客户说，因为客户不知道此技能文件的存在。每个步骤边界都要先说明通俗易懂的结果，而不是内部标签；在同一条消息中向客户交代清楚具体操作，完成手动（UI）交接；每次创建、更新或删除之前，无论操作多小，都要先用通俗易懂的语言说明操作内容及原因，然后等待客户明确同意——不得因客户未回复而继续，也不得将多个操作打包处理。references/customer-narration.md 中有准确措辞表和正反示例——现在就阅读。

---

工作流

所有步骤都必须按顺序执行。每个步骤都只包含一个操作、其最佳层级，以及指向包含准确调用、API 名称和注意事项的参考资料的指引——执行步骤前先阅读该参考资料。不可逆操作前要确认；每个步骤结束时都要执行验证调用。

0 — 确定组织当前的 API 版本

必须先执行此操作——在步骤 1 之前、在本次运行的任何其他调用之前。以下每个步骤和参考文件中使用的 vXX 都来自此次解析；绝不可替换为记忆中的版本或硬编码版本。 **重要：如果本次会话中有多个 Salesforce 连接可用，请将用于此次调用的连接固定为本次运行的组织连接——上下文压缩后也一样。**压缩后的摘要可能会丢失当前使用的是哪个连接的信息；不要因此在运行过程中切换到其他连接。

0. 确定当前 API 版本 [T1] — 在本次运行要固定使用的组织连接上调用 dispatch_readonly({"url": "/services/data/", "method": "GET"}) → 从返回数组中选取数值最高的 version，并在本次运行剩余时间内的每个 vXX 调用中，在同一连接上重复使用该原始值。过时或硬编码的版本可能导致真实实体或功能未出现在架构目录读取结果中，进而被误判为“组织不具备此功能”。完整原因说明和各类表面所适用的版本下限例外情况，请参阅 references/execution-model.md。

1 — 验证前提条件和关卡

**步骤 1 是必须通过的硬性关卡——在启用或构建任何内容之前先完成验证。**如果某项 STOP 检查（技能无法启用的外部授权）或 REDIRECT 检查（技能不负责的基础配置）未通过，不得开始切换设置或构建基础配置——停止并申请授权，或转交给 education-cloud-domain-configure，然后重新验证。**此外，在向客户说明任何内容之前，请立即确认：本次运行已完整阅读 references/customer-narration.md（见上文“与用户沟通”部分）——只有满足这一点，此关卡才算通过。**不要为无法存在的 Agent 构建权限、OWD 或 grounding。完整的预检关卡表及每项验证调用，请参阅 references/prerequisites.md。

1. **确认版本和 Einstein-for-EDU 许可证。**这两项都是 STOP 检查——任何一项缺失都必须停止。（Agentforce 配置状态在第 2 项中验证；Data Cloud 在第 2a 项中验证。）
2. 验证三项 SRA 关卡——Agentforce 配置、Education Cloud 启用状态，以及运行时 orgHasStudentRecruitmentAgentBetaAccess 检查（三项必须全部满足——其准确组成方式及各部分的验证方法请参阅 references/prerequisites.md）。如果缺少配置、许可证或 Gater，则停止。
   • 2a — 验证 EDU 基础配置（不要假定 education-cloud-domain-configure 已运行）：EDU 启用状态、Person Accounts、R&A 域架构和 Data Cloud。前三项转交给 education-cloud-domain-configure 处理，然后重新验证；Data Cloud 属于 Home-Org 授权（停止，不要转交）。

2 — 启用平台开关

3. 启用三个平台开关 [T1] — 每个开关都有自己的写入路径：Einstein Setup（EinsteinGPTPlatformEnabled）、RecruitmentAgentEnabled 和 Omni-Channel（OmniChannelSettings — 部署渠道所必需）。→ references/platform-enablement.md

3 — 权限与共享基础

→ references/permissions.md

4. 克隆并配置角色权限集，然后分配构建者角色 [T1] — OOTB EducationCloudAiAgentAccess 是一个空壳，因此请克隆它并自定义其对象/字段矩阵（分配克隆项，绝不要按主题分配）。克隆前，先将管理员/构建者角色分配给正在运行的用户 — 这样才能获得构建矩阵所需的 EDU 字段可见性。仅限 Auth/Employee 路径： 还要为社区角色克隆并配置 EducationCloudExprcCloudAccess（运行流程 + 对象设置）。Einstein 用户的分配取决于 Agent — Claude 会自行创建该用户，并在步骤 9中授予权限。社区用户的分配（以及启用 Agent 访问权限）同样取决于 Agent → 步骤 10。
5. 将 6 个招生对象的 OWD 设为 Public Read Only [T1 · 一个 UI 例外]。
6. 完成特定主题的准备工作 — 5 个部分 [T1 · 两个 UI 例外]：Campaign 中的 “Recruitment Event” 选项列表值 + “Campus Tours” 共享规则、Individual Application 记录类型及其 ApplicationRecordTypeConfig，以及记录类型→配置文件的可见性。

4 — 接地（两种独立机制）

→ references/grounding.md

7. 设置 Knowledge 接地 [T1 · 文章由人工撰写] — 先检查是否已有 Knowledge 文章，并始终在起草任何内容前询问客户（绝不自动创建 — 参见 references/grounding.md 7a），然后创建以 Knowledge 为来源的数据库。将其附加到 Agent 的操作在步骤 9中完成（作为顶层 AFScript 字段，与同一轮仅创建草稿的操作一起配置 — 无需等到 Agent 提交后）；创建数据本身不需要 Agent。配置完成后，新发布的文章会自动纳入 — 无需为每篇文章重新配置。
8. 配置 Data Cloud 接地 — 3 个接地对象、2 个搜索索引/检索器构建（Learning Program；Academic Term 与 PTAT 构建共用）[T1 数据骨干 · T3 索引/检索器/提示词构建]。

5 — Agent、子 Agent 和流程

9. 创建 Agent（仅无头模式，保持草稿） [T1] — 获取真实的基础模板（Service：“Agentforce Service Agent”，Employee：“Agentforce Employee Agent”），并在一次合并操作中：通过创建 ASA 的 Einstein Agent User 并授予其完整的权限和许可证对等配置来解析 NEW_AGENT_USER（仅 ASA）；移除 7 个默认主题，包括默认的 Escalation 主题（仅 ASA）；编写仅用于交接的 Escalation 子 Agent（两条路径均适用 — 暂不创建 Create Inquiry）；并连接第 7 步的知识库（两条路径均适用）。停在 compile 阶段 — 不要执行 publish；T3 提供 UI 备用方案。→ references/agent-and-subagents.md
   • 如果第 8 步的 Data Cloud 数据主干因数据流仍在配置而被推迟，请现在检查其状态。 如果仍在配置，请在之后的每一步（9a、10、11、12）结束时再次检查 — 第 13 步最终验证前必须完成，包括 T3 索引／检索器／提示词模板的构建。参见 references/grounding.md 机制 2 步骤 3。
   • 9a — 客户的一次 Builder 会话 [T3 · Asset Library + Builder UI] — 打开草稿 Agent 并执行以下操作：从 Asset Library 添加 4 个打包的 SRA 子 Agent（Admissions and Enrollments FAQ；Admissions Application；Campus Tours, Visits, and Events Registration；Request for Information），以设置正确的操作 source／target（无法手动编写；留意列表中的 TransferCreditEquivalency — 它属于 Transfer Credit Agent，而非 SRA）；删除 Create Admissions Application 操作（无法正常工作 — 请先与客户确认）；根据 Required Inputs 的选择，通过 Builder 的操作选择器将 Create Inquiry 添加到 Escalation 子 Agent，或者将其跳过，仅保留交接（第 9 步未添加 — 不适合盲目手动编写其输入映射）。然后先 Save，再 Commit Version — 仅执行一次；在此之前，无法查询第 9／9a 步的任何内容。→ references/agent-and-subagents.md
10. 仅适用于 AEA／Employee：启用社区访问权限 [T1 写入] — 如果只构建 ASA／Service，请完全跳过；ASA 路径在此没有剩余工作（主题清理、Escalation 编写、知识库和运行用户授权均在第 9 步完成）。在 SRA_Exprc_Cloud_Access 克隆版（第 4 步创建）上设置 Enable Agent Access → AEA Agent，然后查询现有社区用户，并在分配该克隆版及其同级 PS 之前征求同意。→ references/agent-and-subagents.md 和 references/permissions.md
11. 克隆并配置 6 个招生流程 — 仅适用于未认证／Service 路径 [T1]。分两轮进行：先克隆并激活第一轮流程 — 2 个可复用子流程加 1 个独立流程（GetPlnCampaigns，无依赖项）— 然后克隆 3 个使用者流程，并将其重新指向已激活的子流程克隆版。如果只构建 Employee Agent，则完全跳过。→ references/flows.md

6 — 部署到渠道并路由

→ references/routing.md

12. 将每个 Agent 部署到其渠道 + 建立全渠道路由 [T1 routing objects · T3 messaging deployment & site] — 先读取现有配置；对于尚无 Experience Cloud 站点的 Agent，优先创建站点（这是此配置栈中最耗时的部分），然后在站点配置期间构建路由配置 → 队列 → 入站流 → 渠道配置栈，最后回到站点添加组件并发布。每个渠道对应一个 Agent = 独立站点。**身份验证/员工路径：**还要在流程中启用用户验证（两个复选框，分别位于渠道和站点组件中；未验证/服务路径无需启用）。
13. 最终结构验证 [verify] — 运行可查询的汇总检查（Agent 已激活、所有子 Agent 均已就位、流已激活、渠道 + 站点均已就绪），然后总结每个步骤落在哪一层，并列出所有尚需手动完成的事项。**到此结束——不要等待任何手动操作。**对话冒烟测试（向 Agent 发送消息，确认子 Agent 有响应、答案基于知识、操作会生成记录）需要实时渠道会话，无法通过无头方式执行；将这份简短检查清单交给用户，让他们自行运行，不要轮询测试结果。

---

规则 / 约束

约束	原因
切勿承诺尚未确认的回滚	各开关的可逆性不同——参见 references/platform-enablement.md；切换前先行警告
知识文章必须已发布，且不得包含非公开数据	FAQ 操作为公开操作；草稿文章会导致 Agent 回答“没有信息”
任何创建/更新/删除操作前，始终先行确认；亲自执行并验证每个步骤——绝不可将此工作流的任何部分委派给单独的辅助进程	参见与用户沟通——确认模式依赖于一次连续对话；委派的辅助进程可能会自行提示客户。轮询不属于委派
不要部署或推送元数据包	此技能用于配置实时 org；包部署属于单独的生命周期技能

---

注意事项

问题	解决方案
组织无法运行 SRA（Agent 端点返回 501 / 无法查询 BotDefinition，或缺少/无法编辑 RecruitmentAgentEnabled 开关）	预检 STOP 检查——在步骤 1 发现问题，而不是等到步骤 9 才碰壁。原因是缺少以下三项授权之一：Agentforce 配置、Einstein-for-EDU 许可证，或 StudentRecruitmentAgent256 Gater。找出缺少哪项并申请；不要重试较低层级。参见 references/prerequisites.md
无界面创建了 Messaging channel，但运行时无法访问 Agent	channel 记录属于第 1 层级，但其背后的 ESD 级联操作只能通过 UI 完成——向客户提供 references/routing.md 中的 UI 部署路径
克隆的 consumer flows 在运行时失败	第 2 波 consumer 需要替换子流并设置 DefaultUserOwnerId，不能只克隆——参见 references/flows.md
子 Agent 操作目标 compile 成功，但无法 publish	compile 只检查语法，会原样返回任何目标；只有 validate/publish 会检查目标是否存在。切勿手动编写目标——从 Asset Library 添加子 Agent，以便注入正确的 source/target。参见 references/agent-and-subagents.md
只有 Create Admissions Application 验证失败	唯一使用 api:// 的操作；这是平台问题，处处都会失败，无法在此组织中修复。请在步骤 9a 删除它，而不是绕过问题——其他所有操作仍可发布。参见 references/agent-and-subagents.md
Agent 回答“没有信息”	有两个原因：(1) 知识文章仍为 Draft——请发布（可通过第 1 层级 API 完成）；或 (2) 未关联数据库——检查 AFScript 的 knowledge.rag_feature_config_id 是否为 ARFPC_<libraryId>，而不是空值。两项都要检查
EDU 对象（例如 Academic Interest）在 Object Manager 中显示 0 个字段 / 步骤 4 的字段矩阵构建找不到任何内容	顺序问题——管理员缺少用于构建器的 EDU 访问权限集。请先分配 Education Cloud Full Access + Einstein for Education Cloud Access，再克隆字段矩阵——在此之前，字段受许可证限制。参见 references/permissions.md
OWD 或 ApplicationRecordTypeConfig 验证静默返回 0 行	API 名称陷阱：OWD 的第 6 个对象是 ProgramTermApplnTimeline（名称已截断，并非 ...ApplicationTimeline）；权限集使用 PreliminaryApplicationRef。RecordTypeName 接受记录类型的标签，而非 DeveloperName/Id。参见 references/permissions.md
/headless/metadata 返回 400 UNSUPPORTED_OPERATION 或 500 METADATA_CRUD_ERROR	降至第 2/3 层级，不要重试——但首先排除操作界面错误或缺少权限，而非允许列表缺项。参见 references/execution-model.md；setup/org/preferences 的 ROUTE_NOT_FOUND 情况：references/platform-enablement.md
/query 返回 404，看起来像平台故障	先检查调用格式——通常是自身导致的问题：将 SOQL 追加为 ?q=...，而不是使用 queryParams: {"q": "<SOQL>"}。真正的故障是暂时性的，且会同时影响所有版本。参见 references/execution-model.md
较早的步骤确实需要 sf/UI，之后的步骤却也出于习惯继续使用	每个步骤都会重置层级梯级——无论上一步停在哪个层级，每执行一项新操作都要先重新尝试 T1。参见 references/execution-model.md

---

输出预期

此技能用于配置在线组织；不会涉及仓库文件。预期输出：

• 每个步骤完成后的确认消息（说明已完成的操作，以及使用的层级——无界面 / sf CLI / 手动 UI）。
• 每个步骤之后都提供验证查询结果，显示每个开关、权限集、流程、Agent、子 Agent 和 channel 均处于预期状态。
• 最终摘要列出每个步骤使用的层级，以及仅限 T3 的步骤中仍待处理的项目。

---

跨技能集成

需求	委派给
在 EDU 启用、Person Accounts 或 R&A 域架构（步骤 2a）中发现经核实的 EDU 基础缺口——不得盲目预先委派。缺少 Data Cloud 不应转交至此——这是 Home-Org 授权，不属于此技能的范围	education-cloud-domain-configure
通用 Agentforce Agent 编写或元数据生成	agentforce-generate

---

参考文件索引

文件	何时阅读
references/execution-model.md	任意步骤——层级梯度详情：允许列表、路由信号、查询路由、API 版本策略
references/prerequisites.md	步骤 1——版本／许可证检查、三个 SRA 门槛、EDU 基础验证
references/platform-enablement.md	步骤 3——各开关的写入路径
references/permissions.md	步骤 4–6、9 和 10——用户角色权限模型、OWD 列表、特定主题的准备工作、依赖 Agent 的授权
references/grounding.md	步骤 7–8——知识文章／库流程、Data Cloud 基础构建
references/agent-and-subagents.md	步骤 9、9a 和 10——Agent 创建、子 Agent 与升级流程接线、Builder 会话、AEA 社区授权
references/flows.md	步骤 11——Flow 清单、分两轮的克隆顺序
references/routing.md	步骤 12–13——渠道部署、Omni-Channel 路由、最终结构验证