课程章节介绍
好，我们来看动作的几个关键属性，一个一个说。
先说操作名称。这个名字要符合Salesforce的开发人员命名规则，什么意思呢？就是只能以字母开头，后面可以用字母、数字，还有下划线。总长度不能超过80个字符。我们推荐用snake_case这种风格，就是全部小写，单词之间用下划线分开，比如`send_email`。这样一目了然，AI处理起来也方便。
接下来是描述，这个是可选的，但是很关键。因为大语言模型，也就是那个做决策的LLM，它在决定要不要调用你这个动作时，会去读这段描述。所以你哪怕一句话，也要把动作干什么说清楚，这样LLM才能准确判断。
然后是输入和输出。输入就是你这个动作需要什么参数，输出就是执行完会返回什么。参数的类型有很多，比如字符串、数字、布尔值、对象、日期，还有列表类型。你要根据实际需求去定义，这样Agent才知道传什么给你，你又会还给Agent什么。
再往下看，目标引用。这个是告诉系统，你这个动作具体执行什么东西。格式是固定的，用大括号把类型括起来，后面跟着冒号和标识符。比如Apex类，就是`apex://`开头，后面跟类名；如果是Flow，就用`flow://`；如果是提示模板，就用`prompt://`。这个格式必须写对，不然系统找不到你要执行的东西。
最后还有一个属性，叫“滤镜_from_代理输出”。这个有什么用呢？它可以把一些敏感的信息从代理的输出里隐藏掉。比如，动作返回了内部错误代码，你不想让最终用户看到，就可以用这个属性过滤掉。这样既保护了安全，又让输出更干净。
简单总结一下：名称要规范，描述帮LLM理解，输入输出定义清楚参数类型，目标引用指向真正的执行体，滤镜能保护敏感信息。记牢这几点，你定义的Actions就能被Agent准确调用，还能控制好安全和体验。