课程章节介绍
同学们，今天我们来看看使用Agentforce API时，一定要留意的几个关键点，还有一些常见的HTTP错误和解决方法。这些细节很容易被忽略，但一不注意就可能让你的调用失败，或者产生不必要的消费。
首先，要记住Agentforce API目前，不支持，“Agentforce（默认）”类型的代理。也就是说，如果你在后台建了那个默认的代理，API是调不起来的，必须使用自定义类型的代理。另外，调用API是会计入信用消费的，每一次请求都会消耗你的Agentforce信用额度，所以要规划好用量。还有一个硬性限制——每个请求有，120秒的超时，，如果你的逻辑特别复杂，超过了这个时间，连接就会被掐断。特别提醒一下，如果是政府云组织，端点不一样，一定要用 `api.gov.salesforce.com`，而不是普通的商业版域名。
接下来，了解一下最常见的HTTP错误码，这样遇到报错时，你能快速定位问题。
* ，400错误，：通常意味着你传的，代理ID，不对。检查下是不是复制错了，或者这个代理根本不存在。
* ，401错误，：授权问题。多半是访问令牌无效、过期，或者没有正确设置认证头。再确认一下你的会话ID或OAuth流程。
* ，404错误，：这个很常见。可能是你的，令牌错误，或者，端点URL，错了。记住，一定要用“我的域”URL作为基础，千万，不要，使用 `lightning.force.com` 这样的旧版域名。路径里代理ID拼错也会报404。
* ，423错误，：这表示有并发请求。Agentforce API同一时间只允许，一个请求，在处理，如果前一个还没完成你又发一个，就会返回423。你需要排队或者等上一个完成再发。
* ，500错误，：服务器内部错误。别慌，这往往是我们自己的请求格式有问题。最常见的是缺少，Content-Type头，，记得设成 `application/json`。另外可能是使用了错误的域URL，比如误用了 `lightning.force.com`，或者代理ID压根不存在。所以遇到500，马上去检查：域名是不是我的域？请求头带没带Content-Type？代理ID对不对？
最后，给你一个简单排查清单：
1. 确保端点URL使用的是我的域，格式类似 `https://你的域名.my.salesforce.com/...`（政府云用 `.gov.salesforce.com`）。
2. 检查请求头，必须包含合法的认证信息和 `Content-Type: application/json`。
3. 确认代理ID有效，而且不是“默认”类型。
4. 留意超时和并发限制，避免重试风暴反而加重问题。
把这些基础打牢，调用Agentforce API就会顺畅很多。下节课我们会动手写一个完整的调用示例，现在有任何疑问吗？没有的话就先休息一下。