课程章节介绍
同学们，今天我们来看一下Agentforce里一个挺有用的新功能——OTel API。简单来说，它就是给你提供了一个GET接口，你只要调一下，就能把一个完整的会话跟踪数据拿出来。
那它拿出来的是什么格式呢？是OpenTelemetry的ResourceSpans格式。可能有些同学还不熟这个，没关系，你就把它理解成一种业内标准的、专门用来记录分布式追踪的结构化数据就行了。通俗点说，就是你跟Agentforce一整轮对话的记录，包括每一步发生了什么，都会被完整保存，然后打包成这个标准格式给你。
当然，要用这个API，你需要先在Agentforce那边打开两个开关：一个是“会话跟踪”，另一个是“审核/反馈”。这两个功能启动了，系统才会开始帮你把对话细节收集起来。
身份验证这块，它用的是ECA，通过OAuth 2.0来做的。也就是说，你得先拿到令牌，然后带着令牌去调接口，安全性是有保障的。
最方便的是，你可以直接用“会话ID”来查。比如你在自己的应用里记录了用户的一个对话ID，那你想看这次对话里到底发生了什么，就直接拿这个ID去查API，返回的结果里就会包含全部信息——每一轮的对话、用户说了什么、助手回了什么、幕后的LLM调用记录、执行了哪些动作、耗了多少时间等等指标，甚至可以带出你提前关联好的用户反馈数据。而且这些数据是直接按照OpenTelemetry的标准给你的，所以你根本不需要再做任何格式转换，直接就能灌到任何一个兼容OTLP的可观察性平台里去，比如你可以配一个OTLP收集器，让它定期轮询这个API，然后你还可以在这中间做一些数据丰富，再转发到Datadog之类的监控工具里，很方便地做分析和告警。
不过既然是Beta阶段，有一些限制我们还是要知道的。第一，目前一次只能查一个会话的数据，不支持批量；第二，它只保留最近72小时的数据，太久以前的就拉不到了；第三，因为底层用的是Connect API，所以会有速率限制，你调得太频繁可能会被限流；第四，这个功能强依赖数据云（Data Cloud），如果数据云那边有什么变动，也会直接影响到它。
好，总的来记就是：这是一个“把Agentforce对话透明化”的工具，用标准格式把每一步都暴露给你，方便你做监控和调试。想用的话，先把Agentforce里的两个开关打开，然后拿会话ID去调接口就行，注意一下Beta阶段的这几个限制就好了。这样讲是不是就清楚多了？