用途
Agentforce Generate 是一个用于开发 Agentforce 智能体的技能,主要使用 Agent Script——Salesforce 面向 AI 智能体的脚本语言。它覆盖 Agent Script 的完整生命周期:设计智能体、编写 Agent Script 代码、验证与调试、部署与发布以及测试。当用户创建、审查或更改 .agent 文件时触发。
主要能力
该技能可帮助用户创建、修改、审计、修复、优化、调试和部署智能体。它提供任务域路由,将用户意图映射到相应任务域和参考文件,包括:创建智能体、理解现有智能体、审计与修复现有智能体、修改现有智能体、诊断编译错误、诊断行为或生产问题、部署发布与激活、删除或重命名智能体、测试智能体、优化智能体以及管理 MCP 服务器。
Agent Script 智能体由 AiAuthoringBundle 元数据定义:一个 <ApiName>.agent 文件(智能体行为)加上一个同级的 <ApiName>.bundle-meta.xml 文件(包元数据)。目录和两个文件名必须使用大小写一致的相同 API 名称;字面量 bundle-meta.xml 文件名不可部署。动作可通过可调用 Apex、自动启动 Flow、Prompt 模板和其他受支持类型实现。
使用方式
涉及组织的操作需要 Agentforce 许可证、API v66.0 或更高版本以及 Einstein Agent User。静态编写和审查无需组织访问权限。该技能强调若干始终适用的规则:始终在每条 sf CLI 命令中包含 --json,不要通过 jq 或 2>/dev/null 管道处理 CLI 输出;在任何组织交互前运行 sf config get target-org --json 确认已设置目标组织;按变更规模进行诊断;使用成比例的规格门禁;不要停滞,步骤成功后宣布下一步并开始;采用草稿优先的生命周期,默认不发布或激活;从单个执行块和无可变状态开始;使用受支持的控制流,绝不生成嵌套 if;动作实现由用户决定;为每个可达分支提供一个下一结果;使用可移植的结构缩进(新 .agent 文件每级 4 个空格);不要让提示格式冒充控制流;选择每个决策的归属;先在本地廉价且可见地编译 AgentScript;保持编写包形状可部署。
本地编译命令为:node <skill-directory>/scripts/index-agent.mjs <agent-file>。如果 SDK 无法加载,需遵循 AgentScript Compiler Setup 重试,并使用其有界的 npm/源码回退方案。修复每个严重级别为 1 的诊断并重新运行直至干净。
适用场景
适用于使用 Agent Script 开发 Agentforce 智能体的各类任务,包括新建智能体、理解现有智能体包、健康检查与常见陷阱审查、基线对比候选修复循环、对现有响应/路由/动作/子智能体/状态流/接地源/模态的已批准更改、编译错误诊断、行为或生产问题诊断、部署发布与激活、删除或重命名智能体、测试智能体、优化智能体以及 MCP 服务器管理。
限制
涉及组织的操作需要 Agentforce 许可证、API v66.0 或更高版本以及 Einstein Agent User;静态编写和审查无需组织访问权限。Agent Script 不是 AppleScript、JavaScript、Python 或任何其他语言,不得将其语法或语义与其他语言混淆。模拟可建立路由和动作选择;仅在明确批准、已验证的非生产环境和安全测试数据下使用 --use-live-actions。不得从模拟或响应文本声称外部效果。发布和激活是明确的发布操作,需要用户确认已准备好将当前草稿提交到元数据并向最终用户公开。删除操作需要明确确认。