REST Setup: App, JWT & API Calls

今天我们来看看如何通过 REST API 来使用 Agentforce 的生成能力。这个过程其实很简单，总共就三步，我来一步步给你说清楚。 第一步，我们要在 Salesforce 里创建一个“外部客户端应用程序”。创建的时候，记得勾选上客户端凭据流和 JWT 令牌这两种认证方式，并且在作用域里填入 `api`、`refresh_token` 还有 `sfap_api` 这三个范围。这样做，以后这个应用就能安全地代表自己调用接口，而不需要用户每次手动登录。 第二步，就是生成访问令牌，也就是 `access_token`。你需要把自己的消费者密钥和消费者秘密，发给 OAuth 令牌端点，用 JWT 的方式来请求。拿到响应之后，把里面的 `access_token` 复制下来，后面每次调用 API 都要用到它。 第三步，是真正调用 Agentforce 的端点。你需要把刚才的令牌放在请求头里，而且还要带上几个固定的头信息。一共四个：`Authorization` 的值是 `Bearer` 加上你的令牌；`Content-Type` 设为 `application/json`；然后还有两个自定义头，`x-sfdc-app-context` 固定填 `EinsteinGPT`，`x-client-feature-id` 就按你实际的功能标识来填。最后，请求的网址记得要用你自己的“我的域名” URL，而不是老式的 `lightning.force.com` 地址。 发完请求后，你会得到一个 JSON 响应，里面包含了三部分信息：最核心的当然是 AI 生成的文本；然后是内容质量数据，它会给出一个毒性评分，并且按身份、仇恨、亵渎、暴力、性、身体这几个类别分别打分，让你能看到内容是否安全；最后还会告诉你这次调用用了多少 token，方便你掌握用量。 这样三个步骤下来，你就能成功调用 Agentforce 的 REST API 了。是不是挺清晰的？