课程章节介绍
好，同学们，我们现在来看一下，在 Agentforce 里用 Apex 调用大模型时，所有方法其实都遵循一个非常统一的套路，记住这个套路，你就能轻松上手任何一个模型方法。
这个套路分几步呢？很简单：
第一步，先创建一个请求对象，你想做生成文本、聊天还是嵌入，就建对应的请求对象，比如生成文本就是 `GenerativeModelRequest`。
第二步，给这个请求对象设上你要用的模型名称。这个名称通常长什么样呢？默认都是 `sfdc_ai__` 开头的，或者如果你配了自定义模型或者 BYOLLM（自带大模型），就去 AI 模型配置页面里查它的 API 名称。
第三步，把你要模型处理的内容填进去，也就是填充请求的主体部分。
第四步，在你拿到的 `ModelsAPI` 实例上，调用对应的方法，比如 `generateText` 、 `generateChat` 等等。
最后一步，处理返回的响应，拿到结果，也要注意抓错误。
那不同的任务，请求主体里要填的东西稍微不一样：
- 如果只是做，生成文本，，最简单，直接塞一个提示字符串就行。
- 如果要，聊天生成，，你就得构建一个 `ChatMessage` 请求对象的列表，每个消息都要指定角色和内容，角色可以是 system、user 或者 assistant。
- 如果要做，嵌入，，传入的是一个字符串数组，你想把哪些文本转成向量。
- 还有一种特殊的是，反馈，，它需要你提供唯一的 ID 和生成 ID，用来跟某一次生成挂上钩，方便做评估。
最后注意一下，所有这些方法如果出了错，都会抛出一个类型化异常，叫做 `ResponseException`，所以你在写代码的时候一定要做好 try-catch，捕获这个错误去处理。
好了，这个统一模式掌握了，你就能很舒服地在 Apex 里调用 Agentforce 的大模型能力了。记牢：创建请求 → 设模型名 → 填主体 → 调方法 → 处理响应，出了错就抓 `ResponseException`。很简单对吧？