🚀 快速安装
复制以下命令并运行，立即安装此 Skill：
npx skills add https://skills.sh/jaganpro/sf-skills/sf-ai-agentscript💡 提示：需要 Node.js 和 NPM
SF-AI-AgentScript 技能
Agent Script 是确定性 Agentforce 智能体的代码优先路径。当用户编写 .agent 文件、构建有限状态主题流程，或需要对路由、变量、操作和发布行为进行可重复控制时，使用此技能。
首先从最简短的指南开始：references/activation-checklist.md
此技能适用的场景
当工作涉及以下内容时，使用 sf-ai-agentscript：
- 创建或编辑
.agent文件 - 确定性主题路由、守卫和转换
- Agent Script CLI 工作流（
sf agent generate、sf agent validate、sf agent publish） - 槽位填充、指令解析、操作后循环或有限状态机设计
当用户处于以下情况时，委托给其他技能：
- 维护传统的设置界面/智能体构建器智能体 → sf-ai-agentforce
- 设计角色/语气/声音 → sf-ai-agentforce-persona
- 构建正式测试计划或覆盖循环 → sf-ai-agentforce-testing
需要预先收集的上下文
询问或推断：
- 智能体目的以及 Agent Script 是否真正合适
- 服务智能体与员工智能体
- 目标组织和发布意图
- 预期的操作/目标（Flow、Apex、PromptTemplate 等）
- 请求是编写、验证、预览还是发布故障排除
激活检查清单
在您编写或修复任何 .agent 文件之前，首先验证这些：
- 正好一个
start_agent块 - 不要混用制表符和空格
- 布尔值为
True/False - 没有
else if和没有嵌套的if - 没有顶级
actions:块 set表达式中没有@inputslinked变量没有默认值linked变量不使用object/list类型- 使用明确的
agent_type - 一致地使用
@actions.前缀
完整版本请使用 references/activation-checklist.md。
不可协商的规则
1) 服务智能体 vs 员工智能体
| 智能体类型 | 必需 | 禁止/注意事项 |
|---|---|---|
AgentforceServiceAgent |
有效的 default_agent_user、正确权限、目标组织检查 |
在没有真实 Einstein 智能体用户的情况下发布 |
AgentforceEmployeeAgent |
明确的 agent_type |
提供 default_agent_user |
详细信息：references/agent-user-setup.md
2) 必需的块顺序
config:
variables:
system:
connection:
knowledge:
language:
start_agent:
topic:
3) 关键配置字段
| 字段 | 规则 |
|---|---|
developer_name |
必须与文件夹/包名称匹配 |
agent_description |
使用此字段而非旧的 description |
agent_type |
每次都要明确设置 |
default_agent_user |
仅服务智能体使用 |
4) 应视为立即失败的语法阻塞项
else if- 嵌套的
if - 仅有注释的
if主体 - 顶级
actions: - 调用级别的
inputs:/outputs:块 - 保留的变量/字段名，如
description和label
规范规则集：references/syntax-reference.md 和 references/validator-rule-catalog.md
推荐工作流程
阶段 1 — 设计智能体
- 确定问题是否足够确定，适合使用 Agent Script
- 将主题建模为状态，将转换建模为边
- 仅定义您真正需要的变量
阶段 2 — 编写 .agent 文件
- 首先创建
config、system、start_agent和主题 - 添加带有完整
inputs:和outputs:的基于目标的操作 - 使用
available when实现确定性工具可见性 - 将操作后检查放在
instructions: ->的顶部
阶段 3 — 持续验证
写入/编辑时验证已自动运行。在发布前使用 CLI：
sf agent validate authoring-bundle --api-name MyAgent -o TARGET_ORG --json
验证器涵盖结构、运行时陷阱、目标就绪状态和面向组织的服务智能体检查。规则 ID 位于 references/validator-rule-catalog.md。
阶段 4 — 预览冒烟测试
在发布前使用预览循环：
- 推导 3-5 个冒烟测试语句
- 开始预览
- 检查主题路由/操作调用/安全性/接地性
- 修复并重新运行最多 3 次
完整循环：references/preview-test-loop.md
阶段 5 — 发布和激活
sf agent publish authoring-bundle --api-name MyAgent -o TARGET_ORG --json
sf agent activate --api-name MyAgent -o TARGET_ORG
发布不会激活智能体。
确定性构建块
这些作为代码执行，而非建议：
- 条件语句
available when守卫- 变量检查
- 内联操作执行
- 实用操作，如转换/升级
- 将变量注入面向 LLM 的文本
参见 references/instruction-resolution.md 和 references/architecture-patterns.md。
跨技能集成
| 任务 | 委托给 | 原因 |
|---|---|---|
构建 flow:// 目标 |
sf-flow | Flow 创建/验证 |
| 构建 Apex 操作目标 | sf-apex | @InvocableMethod 和业务逻辑 |
| 测试主题路由/操作 | sf-ai-agentforce-testing | 正式测试规范和修复循环 |
| 部署/发布 | sf-deploy | 部署编排 |
高频失败模式
| 症状 | 可能原因 | 下一步阅读 |
|---|---|---|
发布时出现 Internal Error |
无效的服务智能体用户或缺失的操作输入/输出 | references/agent-user-setup.md、references/actions-reference.md |
提示模板操作上的 invalid input/output parameters |
目标模板处于草稿状态 — 先激活它 | references/action-prompt-templates.md |
| 解析器拒绝条件语句 | else if、嵌套 if、空的 if 主体 |
references/syntax-reference.md |
| 操作目标问题 | 缺失 Flow/Apex 目标、Flow 未激活、架构错误 | references/actions-reference.md |
| 预览和运行时不一致 | 链接变量/上下文/已知平台问题 | references/known-issues.md |
| 验证通过但发布失败 | 特定于组织的用户/权限/检索问题 | references/production-gotchas.md、references/cli-guide.md |
参考映射
从这里开始
发布/运行时安全
- references/agent-user-setup.md
- references/production-gotchas.md
- references/customer-web-client.md
- references/known-issues.md
架构/推理
- references/architecture-patterns.md
- references/instruction-resolution.md
- references/fsm-architecture.md
- references/patterns-quick-ref.md
验证/测试/调试
- references/preview-test-loop.md
- references/testing-guide.md
- references/debugging-guide.md
- references/validator-rule-catalog.md
示例/模板
项目文档
评分指南
| 分数 | 含义 |
|---|---|
| 90+ | 可自信部署 |
| 75–89 | 良好，需检查警告 |
| 60–74 | 需要针对性修订 |
| < 60 | 阻止发布 |
完整评分标准：references/scoring-rubric.md
评论(0)