AuraEnabled 控制器方法创建 Actions使用 Agentforce Vibes Extension 为带有 AuraEnabled 注解的 Apex 控制器方法生成 OpenAPI v3 规范文档。与 Apex REST Actions 相同的工作流生成 OAS → 验证 → 部署类 元数据到 API 目录 → 在 Builder 中创建 Agent Action。AuraEnabled Apex 类限制API 目录限制适用达到限制时先停用或删除不需要的操作在此之前先从 Agent Action 中移除引用参考View Apex APIs in API Catalog、Apex AuraEnabled Annotation 参考、Lightning Aura Components 和 LWC 开发者指南Named Query API Actions在 Setup 中创建自定义 SOQL 查询并将其暴露为 Agent Actions。这是将数据查询暴露为动作的最简单方式无需编写 Apex 代码。所需权限操作 Named Query API创建/读取/更新/删除 Named Query API 记录使用带 Named Query 的 AgentView Developer Name 或 View Setup and Configuration设置和使用流程Setup → User Interface → 启用Salesforce Platform REST API, Named Query for Agent Actions创建 Named Query APIsSOQL 查询—— 它们会出现在 Setup → API Catalog 中需手动激活Setup → Agentforce Assets → Actions →New Agent ActionReference Action Type:API→ Reference Action Category:Salesforce Named Query API从 Reference Action 中选择动作注意执行命名查询的用户必须对所查询的数据具有读取权限。Apex Invocable Method Actions使用 InvocableMethod 注解直接从 Apex 代码创建自定义动作。这是最直接的 Apex 集成方式。关键注解InvocableMethod(label... description...)—— 标记方法可被 Agent 调用。label 和 description 帮助 Agent 决定何时调用InvocableVariable(requiredtrue label... description...)—— 定义输入/输出参数description 告诉 Agent 每个字段的含义代码结构示例public with sharing class HelloWorld { InvocableMethod(labelHello World descriptionTakes a name and returns a greeting) public static ListOutputParameters sayHello(ListInputParameters inputs) { // 处理输入返回输出 } public class InputParameters { InvocableVariable(requiredtrue labelName description...) public String name; } public class OutputParameters { InvocableVariable(labelGreeting description...) public String greeting; } }重要模式方法必须为static接受和返回ListT即使是单次调用输入和输出类在每个字段上使用 InvocableVariablelabel 和 description 决定了 Agent 理解和正确使用动作的能力使用 Lightning Types 自定义 UI使用自定义 Lightning Web Components 增强 Agent Action 的聊天体验。替换默认 UI创建品牌化、交互式的自定义输入表单和输出显示。仅适用于使用 Apex 类作为输入/输出的 Agent Actions。入门路径Setup UI直接在 Setup 中创建架构理解学习核心概念、文件结构、Schema 投影方法选择Apex 类驱动 或 手动 JSON Schema构建结构化 LightningTypeBundle 元数据AI 辅助使用 Agentforce Vibes 中的 Lightning Types skill用自然语言生成部署使用 Metadata API 或 Salesforce CLI标准 Lightning Types 工作原理映射Apex 输入/输出类型映射到标准 Lightning 类型date→lightning__dateType、string→lightning__stringTypeSchema 验证每个标准类型有 Schema 定义验证规则自动 UI 生成Salesforce 根据映射类型自动生成 UI 组件多行文本→多行文本框、日期→日期选择器、列表→表格数据渲染Renderer 组件在动作执行时显示结构化数据开箱即用标准类型提供即用组件配置最少集成自定义 Lightning Type打开 Agent Action → 编辑 Input Rendering 或 Output Rendering 参数 → 选择自定义 Lightning 类型 → 保存。航班预订示例自定义 Lightning Types以下是一个完整的航班搜索 Agent Action 示例展示如何使用自定义 Lightning Types 改善输入和输出 UI。Apex 类创建两个类FlightSearchActionInvocableMethod 处理航班搜索逻辑和输入/输出参数类型。输出包含航班选项列表、价格、折扣信息等。创建 Agent Action 和默认 UI 问题创建 Agent Action 后默认 UI 可能杂乱无章 —— 标签不清晰、无操作按钮、折扣信息不突出。通过自定义 Lightning Types 可以彻底改善输出 UI创建 flightResponse CLT — 清晰标签、吸引人的布局、高亮折扣、突出的 Book Now 按钮输入 UI创建 flightFilter CLT — 自定义输入表单更直观的用户交互改造前后对比默认 UI杂乱、无标签、无操作按钮→ 自定义 UI清晰标签、吸引人的布局、高亮折扣、突出的操作按钮显著提升用户体验。从简单的 Named Query 到完整的 InvocableMethod 集成从默认 UI 到自定义 Lightning Type 体验 —— Agentforce Actions 提供了从声明式到程序化的完整灵活度。发布来源https://www.salesforcecrm.cn/article/agentforce/agentforce-create-actions-guide.html
Agentforce Actions 创建与 UI 自定义指南
AuraEnabled 控制器方法创建 Actions使用 Agentforce Vibes Extension 为带有 AuraEnabled 注解的 Apex 控制器方法生成 OpenAPI v3 规范文档。与 Apex REST Actions 相同的工作流生成 OAS → 验证 → 部署类 元数据到 API 目录 → 在 Builder 中创建 Agent Action。AuraEnabled Apex 类限制API 目录限制适用达到限制时先停用或删除不需要的操作在此之前先从 Agent Action 中移除引用参考View Apex APIs in API Catalog、Apex AuraEnabled Annotation 参考、Lightning Aura Components 和 LWC 开发者指南Named Query API Actions在 Setup 中创建自定义 SOQL 查询并将其暴露为 Agent Actions。这是将数据查询暴露为动作的最简单方式无需编写 Apex 代码。所需权限操作 Named Query API创建/读取/更新/删除 Named Query API 记录使用带 Named Query 的 AgentView Developer Name 或 View Setup and Configuration设置和使用流程Setup → User Interface → 启用Salesforce Platform REST API, Named Query for Agent Actions创建 Named Query APIsSOQL 查询—— 它们会出现在 Setup → API Catalog 中需手动激活Setup → Agentforce Assets → Actions →New Agent ActionReference Action Type:API→ Reference Action Category:Salesforce Named Query API从 Reference Action 中选择动作注意执行命名查询的用户必须对所查询的数据具有读取权限。Apex Invocable Method Actions使用 InvocableMethod 注解直接从 Apex 代码创建自定义动作。这是最直接的 Apex 集成方式。关键注解InvocableMethod(label... description...)—— 标记方法可被 Agent 调用。label 和 description 帮助 Agent 决定何时调用InvocableVariable(requiredtrue label... description...)—— 定义输入/输出参数description 告诉 Agent 每个字段的含义代码结构示例public with sharing class HelloWorld { InvocableMethod(labelHello World descriptionTakes a name and returns a greeting) public static ListOutputParameters sayHello(ListInputParameters inputs) { // 处理输入返回输出 } public class InputParameters { InvocableVariable(requiredtrue labelName description...) public String name; } public class OutputParameters { InvocableVariable(labelGreeting description...) public String greeting; } }重要模式方法必须为static接受和返回ListT即使是单次调用输入和输出类在每个字段上使用 InvocableVariablelabel 和 description 决定了 Agent 理解和正确使用动作的能力使用 Lightning Types 自定义 UI使用自定义 Lightning Web Components 增强 Agent Action 的聊天体验。替换默认 UI创建品牌化、交互式的自定义输入表单和输出显示。仅适用于使用 Apex 类作为输入/输出的 Agent Actions。入门路径Setup UI直接在 Setup 中创建架构理解学习核心概念、文件结构、Schema 投影方法选择Apex 类驱动 或 手动 JSON Schema构建结构化 LightningTypeBundle 元数据AI 辅助使用 Agentforce Vibes 中的 Lightning Types skill用自然语言生成部署使用 Metadata API 或 Salesforce CLI标准 Lightning Types 工作原理映射Apex 输入/输出类型映射到标准 Lightning 类型date→lightning__dateType、string→lightning__stringTypeSchema 验证每个标准类型有 Schema 定义验证规则自动 UI 生成Salesforce 根据映射类型自动生成 UI 组件多行文本→多行文本框、日期→日期选择器、列表→表格数据渲染Renderer 组件在动作执行时显示结构化数据开箱即用标准类型提供即用组件配置最少集成自定义 Lightning Type打开 Agent Action → 编辑 Input Rendering 或 Output Rendering 参数 → 选择自定义 Lightning 类型 → 保存。航班预订示例自定义 Lightning Types以下是一个完整的航班搜索 Agent Action 示例展示如何使用自定义 Lightning Types 改善输入和输出 UI。Apex 类创建两个类FlightSearchActionInvocableMethod 处理航班搜索逻辑和输入/输出参数类型。输出包含航班选项列表、价格、折扣信息等。创建 Agent Action 和默认 UI 问题创建 Agent Action 后默认 UI 可能杂乱无章 —— 标签不清晰、无操作按钮、折扣信息不突出。通过自定义 Lightning Types 可以彻底改善输出 UI创建 flightResponse CLT — 清晰标签、吸引人的布局、高亮折扣、突出的 Book Now 按钮输入 UI创建 flightFilter CLT — 自定义输入表单更直观的用户交互改造前后对比默认 UI杂乱、无标签、无操作按钮→ 自定义 UI清晰标签、吸引人的布局、高亮折扣、突出的操作按钮显著提升用户体验。从简单的 Named Query 到完整的 InvocableMethod 集成从默认 UI 到自定义 Lightning Type 体验 —— Agentforce Actions 提供了从声明式到程序化的完整灵活度。发布来源https://www.salesforcecrm.cn/article/agentforce/agentforce-create-actions-guide.html
