# sf-ai-agentforce：标准 Agentforce 平台开发 Agentforce 专家开发人员，专门研究 **Setup UI / Agentforce Builder** 代理开发方法。涵盖主题和操作配置、GenAiFunction/GenAiPlugin 元数据、PromptTemplate 创作、Einstein 模型 API 和自定义 Lightning 类型。 > **代码优先替代方案**：对于使用 Agent Script DSL（`.agent` 文件）进行编程代理开发，请改用 **sf-ai-agentscript**。此技能涵盖声明式、UI 驱动的方法。 ** ** ## 概述 Salesforce **Agentforce** 使组织能够构建自主 AI 代理，以处理客户交互、自动化任务和表面洞察。该技能重点关注**标准平台方法**： * **Agentforce Builder**（设置 UI）用于可视化代理配置 * **GenAiFunction** 和 **GenAiPlugin** 用于注册操作的元数据 * **PromptTemplate** 可重复使用的 AI 提示元数据 * **Einstein Models API** (`aiplatform.ModelsAPI`) 用于 Apex 中的本机 LLM 访问 * **自定义闪电类型**（`LightningTypeBundle`）用于丰富的代理操作 UI ### Agentforce 的两种方法方法|技能|何时使用 ---|---|--- **设置 UI / Agentforce Builder** | `sf-ai-agentforce`（此技能）|声明式代理配置，点击主题/操作 **代理脚本 DSL** | `sf-ai-agentscript` |代码优先 `.agent` 文件、FSM 架构、版本控制代理两种方法都会生成在同一 Agentforce 运行时上运行的代理。根据团队偏好和复杂性要求进行选择。 ** ** ## 核心概念 ### 主题主题是代理功能的主要组织单位。每个主题围绕特定域对相关的**操作**和**说明**进行分组。 * **描述**：告诉LLM规划师何时转向该主题（必须具体且明确） * **范围** ：定义主题可以做什么和不能做什么（帮助规划者做出路由决策） * **说明**：当主题处于活动状态时，代理遵循的分步指导 * **操作**：代理可以在此主题中调用的操作（流程、Apex、提示模板）在 Agentforce Builder 中，主题通过 **设置 → Agentforce → 代理 → [Agent] → 主题** 配置。 ### 行动操作是代理可以执行的可执行操作。每个操作都包装一个底层调用目标：目标类型|描述 |注册方式 ---|---|--- **流量** |调用自动启动的流程 | GenAiFunction 与 `invoiceTargetType: flow` **顶点** |调用`@InvocableMethod` | GenAiFunction 与 `involutionTargetType: apex` **提示模板** |调用提示模板 | GenAiFunction 与 `involutionTargetType:prompt` **标准动作** |内置平台操作（发送电子邮件、创建记录）|由 Salesforce 预注册 ### 说明指令指导代理在主题内的行为。它们是自然语言指令，告诉法学硕士： * 应遵循什么步骤 * 何时调用特定操作 * 如何处理边缘情况和错误 * 何时升级至人工代理 ** ** ## 代理生成器工作流程 ### 分步：通过设置 UI 创建代理 **1\.导航到 Agentforce Builder** 设置 → Agentforce → 代理 → 新代理 **2\.选择代理类型** * **服务代理** — 面向客户的支持和服务 * **员工代理** — 内部生产力和自动化 **3\.添加主题** 对于每个功能领域： * 提供清晰的**名称**和**描述** * 编写指导代理人推理的**说明** * 添加 **范围** 声明（范围内/范围外的内容） **4\.配置每个主题的操作** 将操作分配给每个主题。行动可以针对： * 自动启动的流程（最常见） * Apex InvocableMethods（通过 GenAiFunction） * 提示模板（适用于 LLM 生成的内容） * 标准平台动作 **5\.设置操作输入和输出** 对于每个操作： * 定义代理从用户收集的**输入**（槽位填充） * 定义代理在其响应中使用的**输出** * 标记哪些输出对用户**可显示** **6\.配置代理级别设置** * **系统说明**：全局角色和行为指南 * **默认代理用户** ：代理的运行用户上下文 * **欢迎信息** : 初始问候语 * **错误消息**：出现问题时的回退 **7\.预览和测试** # 在 Agentforce Builder 中预览（使用标准组织身份验证） sf 代理预览 --api-name MyAgent --target-org MyOrg **8\.发布** sf 代理发布创作包 --api-name MyAgent --target-org MyOrg # 发布（跳过 CI/CD 管道的元数据检索，v2.122.6+） sf 代理发布创作包 --api-name MyAgent --skip-retrieve --target-org MyOrg ### CLI 代理生命周期通过 CLI 管理代理状态（需要首先发布代理）：命令 |目的 ---|--- `sf 代理激活 --api-name X --target-org Y` |激活已发布的代理_（无`--json`支持）_ `sf 代理停用 --api-name X --target-org Y` |停用活动代理_（无`--json`支持）_ > **注意**： `sf agent create --spec ` 存在，但不推荐 - 以这种方式创建的代理不使用代理脚本并且灵活性较差。请改用创作包工作流程。完整生命周期：验证→部署→发布→激活→（停用→重新发布→重新激活）交叉引用：[sf-deploy]() 用于部署编排， [sf-ai-agentscript]() 用于代理脚本开发。 ### 代理规范生成使用“sf agent generated agent-spec”生成代理规范 YAML。关键标志： * `--type customer|internal` — 代理类型 * `--role`, `--company-name`, `--company-description` — 核心身份 * `--toneformal|casual|neutral`——会话风格 * `--full-interview` — 所有属性的交互式提示 * `--spec ` — 现有规范的迭代细化 > **完整标志参考** ：请参阅 [references/cli-commands.md]()，了解包含所有 15 个以上标志的完整“生成代理规范”工作流程。 ** ** ## GenAiFunction 和 GenAiPlugin 元数据 ### GenAi函数 “GenAiFunction”注册 Agentforce 代理可以调用的单个操作。它包装了底层流程、Apex 方法或提示模板。 **元数据 XML 结构：** 查询订单状态 <开发者名称>Lookup_Order_Status 检索客户订单的当前状态 Get_Order_Status_Flow <调用目标类型>流程 <能力> 查询客户订单的当前状态询问有关运输、交付或订单跟踪的信息。 <开发者名称>订单编号客户的订单号 <数据类型>文本 true <开发者名称>订单状态订单当前状态 <数据类型>文本 true **文件位置：** 强制应用程序/主/默认/genAiFunctions/Lookup_Order_Status.genAiFunction-meta.xml ### 调用目标类型 `调用目标类型` |目标值|注释 ---|---|--- `流动` |流程 API 名称 |流必须处于活动状态 `顶点` | Apex 类名称 |类必须有`@InvocableMethod` `提示` |提示模板 API 名称 |模板必须处于活动状态 ### GenAi插件 “GenAiPlugin”将多个“GenAiFunction”条目分组为一个逻辑单元。这对于组织相关操作很有用。订单管理插件 <开发者名称>Order_Management_Plugin 管理客户订单的操作 <函数名称>Lookup_Order_Status <函数名称>取消订单 <函数名称>Return_Order **文件位置：** 强制应用程序/主/默认/genAiPlugins/Order_Management_Plugin.genAiPlugin-meta.xml ### 部署顺序 1.先部署底层**Flow**/**Apex**/**PromptTemplate** 2. 部署 **GenAiFunction** 元数据（引用目标） 3. 部署**GenAiPlugin**元数据（引用函数） 4. 发布**Agent**（通过主题引用插件/功能） # 第 1 步：部署目标 sf 项目部署启动 -m "Flow:Get_Order_Status_Flow" --target-org MyOrg # 第2步：部署GenAiFunction sf 项目部署启动 -m "GenAiFunction:Lookup_Order_Status" --target-org MyOrg # 步骤3：部署GenAiPlugin（可选分组） sf 项目部署启动 -m "GenAiPlugin:Order_Management_Plugin" --target-org MyOrg # 第四步：发布代理 sf 代理发布创作包 --api-name MyAgent --target-org MyOrg ** ** ## 提示模板配置 “PromptTemplate”是用于创建可重用 AI 提示的元数据类型。模板可由 Agentforce 代理（通过 GenAiFunction）、Einstein Prompt Builder、Apex 代码和 Flows 调用。 **模板类型：** `flexPrompt` | `销售一代` | `字段完成` | `记录摘要` **变量类型：** `freeText`（运行时输入）| `recordField`（SObject 字段绑定）| `相关列表`（子记录）| `资源`（静态资源） **关键集成点：** * **代理操作** ：使用 `invokingTargetType:prompt` 注册 GenAiFunction * **Apex** : `ConnectApi.EinsteinLlm.generateMessagesForPromptTemplate()` * **流程** ：使用“提示模板”操作元素 > **完整参考**：请参阅 [references/prompt-templates.md]() 了解完整的元数据结构、变量类型、示例、数据云基础和最佳实践。 ** ** ## 模型 API **Einstein Models API** (`aiplatform.ModelsAPI`) 允许从 Apex 进行本机 LLM 访问，无需外部 HTTP 调用。将其用于 Agentforce 主题/操作之外的自定义 AI 逻辑。 **可用型号：** * `sfdc_ai__DefaultOpenAIGPT4OmniMini` — 具有成本效益的一般任务 * `sfdc_ai__DefaultOpenAIGPT4Omni` — 复杂推理 * `sfdc_ai__DefaultAnthropic` — 细致入微的理解 * `sfdc_ai__DefaultGoogleGemini` — 多模式任务 **关键模式：** * **可排队**用于单记录异步 AI 处理 * **批量** 用于批量处理（范围大小 10–20） * **平台事件**，用于向 LWC/Flow 通知完成情况 **先决条件：** Einstein 生成式 AI 已启用，API v61.0+，已分配 Einstein 生成式 AI 用户权限集。 > **完整参考** ：请参阅 [references/models-api.md]() 以获取完整的 Apex 示例、可排队/批处理模式、Chatter 集成和调控器限制指南。 ** ** ## 自定义闪电类型 **自定义闪电类型**（`LightningTypeBundle`）使用用于代理操作输入和输出的自定义 UI 组件定义结构化数据类型。当代理操作需要丰富的输入表单或格式化的输出显示时，请使用以下命令创建自定义类型： * **schema.json** — JSON Schema 数据结构定义 * **editor.json** — 自定义输入集合 UI（闪电组件） * **renderer.json** — 自定义输出显示 UI（闪电组件） **要求：** API v64.0+（25 年秋季），在 Service Cloud 中启用增强型聊天 V2。 **文件结构：** 强制应用程序/主/默认/lightningTypeBundles/OrderDetails/ ├── schema.json ├── 编辑器.json ├── 渲染器.json └── OrderDetails.lightningTypeBundle-meta.xml > **完整参考** ：请参阅 [references/custom-lightning-types.md]() 了解完整的架构示例、编辑器/渲染器配置以及与 GenAiFunction 的集成。 ** ** ## 编排顺序 **必备技能必须按此顺序运行：** sf-元数据 → sf-apex → sf-flow → sf-ai-agentforce → sf-deploy **为什么这个订单：** 1. **sf-metadata** — 自定义对象/字段在 Apex/Flows 引用它们之前必须存在 2. **sf-apex** — InvocableMethod 类必须在 Flows 或 GenAiFunctions 引用它们之前部署 3. **sf-flow** — 流必须处于活动状态，GenAiFunctions 才能定位它们 4. **sf-ai-agentforce**（此技能）——GenAiFunction/GenAiPlugin 元数据和代理配置 5. **sf-deploy** — 最终部署和代理发布 **强制代表团：** 要求 |委托给 |为什么 ---|---|--- 流程创建|使用 **sf-flow** 技能 | 110 点验证，正确的 XML 巅峰创作 |使用 **sf-apex** 技能 | InvocableMethod生成，150分评分部署|使用 **sf-deploy** 技能 |集中部署编排 ** ** ## 跨技能整合技能|目的|何时使用 ---|---|--- **sf-ai-agentscript** |代理脚本 DSL（代码优先）|使用 FSM 架构编写 .agent 文件 **sf-ai-agentforce-测试** |代理测试|测试执行、覆盖率分析、代理修复循环 **sf-流** |流程动作|为代理操作创建自动启动的流程 **sf-顶点** |顶点行动 |为代理操作编写 InvocableMethod 类 **sf-部署** |部署|发布代理、部署元数据 **sf-元数据** |对象/字段设置 |创建操作引用的 SObject 和字段 **sf-集成** |外部 API |指定凭证、代理标注的外部服务 ### 集成模式方向 |图案|注释 ---|---|--- 代理→流量| GenAiFunction 的目标是 Flow |最常见的动作模式代理 → Apex | GenAiFunction 的目标是 InvocableMethod |对于复杂的业务逻辑代理→提示| GenAiFunction 目标 PromptTemplate |对于人工智能生成的内容代理→定制类型| GenAiFunction 使用 LightningTypeBundle |丰富的输入/输出 UI 代理 → 外部 API | Flow/Apex 包含命名凭证标注 |通过sf-整合技能 ** ** ## 关键见解洞察 |问题 |修复 ---|---|--- **GenAiFunction 需要活动目标** |在 Flow/Apex 目标之前部署 GenAiFunction |首先部署目标，然后部署 GenAiFunction **PromptTemplate 字段绑定** | `{!variableName}` 必须与变量 `developerName` 完全匹配 |检查拼写和区分大小写 **自定义闪电类型需要 v64.0+** | Bundle 不会部署在较旧的 API 版本上 |在 package.xml 中设置 `64.0` 或更高版本 **GenAiPlugin 组功能** |各个 GenAiFunction 必须在插件之前存在 |在 GenAiPlugin 之前部署 GenAiFunctions **功能文本至关重要** |模糊的能力描述导致糟糕的路由|编写具体的、基于场景的功能文本 **针对自定义类型的增强型聊天 V2** |自定义类型 UI 没有它就不会渲染 |在设置 → 聊天设置中启用增强聊天 V2 **模型 API 需要异步上下文** |触发器中的同步调用会超时 |将 Queueable 与“Database.AllowsCallouts”一起使用 **输入/输出名称必须匹配** | GenAiFunction 输入名称必须与 Flow 变量 API 名称匹配 |验证名称完全匹配（区分大小写） **发布前验证** |跳过验证会导致后期失败 |始终首先运行“sf agent validate Authoring-bundle” **数据类型映射** | GenAiFunction `dataType` 必须与目标参数类型一致 |适当使用“文本”、“数字”、“布尔值”、“日期” ** ** ## 评分系统（100 分） ### 类别类别 |积分|关键标准 ---|---|--- **代理配置** | 20 |系统说明、欢迎/错误消息、座席用户设置 **主题与动作设计** | 25 | 25清晰的描述、适当的范围、逻辑路由、功能文本 **元数据质量** | 20 |有效的 GenAiFunction/GenAiPlugin XML、正确的目标类型、输入/输出定义 **集成模式** | 15 | 15正确的编排顺序、依赖管理、跨技能委派 **提示模板用法** | 10 | 10变量绑定正确，模板类型适当，提示结构良好 **部署准备** | 10 | 10验证通过，首先部署依赖项，package.xml 正确 ### 阈值分数 |评级 |行动 ---|---|--- 90–100 |优秀|充满信心地部署 80–89 |非常好 |建议进行小幅改进 70–79 | 70–79好 |部署前检查 60–69 | 60–69需要工作|部署前解决问题 < 60 |关键| **区块部署** ### 验证报告格式评分：87/100 ⭐⭐⭐⭐ 非常好 ├─ 代理配置：18/20 (90%) ├─ 主题与动作设计：22/25 (88%) ├─ 元数据质量：17/20 (85%) ├─ 整合模式：13/15 (87%) ├─ 提示模板使用率：9/10 (90%) └─ 部署准备度：8/10 (80%) 问题： ⚠️ [元数据] GenAiFunction“Cancel_Order”缺少输出定义 ⚠️ [集成] 流程“Get_Order_Status”尚未部署到组织 ✓ 所有 PromptTemplate 变量绑定均有效 ✓ GenAiPlugin 引用正确解析 ** ** ## 文档图 **第 2 层：详细参考资料** 文件|描述 |阅读时间 ---|---|--- [references/cli-commands.md]() |代理生命周期、生成和发布的 CLI 命令参考 |使用“sf代理”命令 [references/prompt-templates.md]() |完整的PromptTemplate元数据、变量类型、数据云基础|创作可重复使用的 AI 提示 [references/models-api.md]() | `aiplatform.ModelsAPI` Apex 模式，可排队/批量集成 |在 Apex 中构建自定义 AI 逻辑 [references/custom-lightning-types.md]() | LightningTypeBundle 架构/编辑器/渲染器配置 |创建丰富的操作输入/输出 UI **跨技能参考** 需要|技能 ---|--- Agent Script DSL 开发 | `sf-ai-agentscript` 代理测试和覆盖范围 | `sf-ai-agentforce-测试` 操作流程创建 | `sf 流` Apex InvocableMethod 类 | `sf-顶点` 元数据部署| `sf-部署` ** ** ## 版本历史版本 |日期 |变化 ---|---|--- **2.0.0** | 2026-02-07 |完全重写。技能重新集中于标准 Agentforce 平台（设置 UI、GenAiFunction/GenAiPlugin、PromptTemplate、模型 API、自定义 Lightning 类型）。代理脚本 DSL 内容已移至“sf-ai-agentscript”。 ** ** ## 来源和致谢来源 |贡献 ---|--- [Salesforce Agentforce 文档]() |官方平台参考 [Salesforce 日记]() |模型 API 模式、自定义 Lightning 类型指南 [trailheadapps/agent-script-recipes]() |官方 Salesforce 示例贾格·瓦莱亚帕蒂 | Jag Valaiyapathy技能创作、评分系统、编排设计 ** ** ## 许可证麻省理工学院许可证。请参阅 sf-ai-agentforce 文件夹中的许可证文件。版权所有 (c) 2024–2026 Jag Valaiyapathy

圣艾特工队

包含技能