Connect API Setup & Endpoints

DEX801 - Test Agents API

📄 第 197 页 🎬 视频课程

课程章节介绍

同学,我们来看一下这一页讲的是什么。它其实在说,如果你想通过程序来调用Agentforce的测试服务,你需要先配置一个外部的客户端应用,让它能安全地连接到Salesforce。 首先,这个客户端应用必须具备特定的OAuth权限范围,特别是`chatter_api`这个范围。因为Agentforce的Connect REST API就是依托在Chatter API上的,有了这个权限,你的程序才能调用那些测试端点。 接下来,你要启用两种身份验证方式:一个是客户端凭据流,另一个是JWT令牌流。这两种方式都能让你的后端服务无需用户交互就能获取访问令牌。你拿到客户端密钥和消费者密钥之后,就可以用它们去换取一个有效的令牌了。 有了令牌之后,你就能访问三个主要的接口端点。想想看,第一个是开始测试,你发起一个请求后,它会立即返回一个`runId`,这就像是测试运行的编号,后面全靠它来跟踪。第二个是获取测试状态,你可以拿着这个`runId`不断轮询,看测试跑完了没有。第三个是获取测试结果,当测试完成后,访问这个端点就能拿到一份详细的报告。 这份报告里内容很丰富,包含一个`generatedData`部分,里面记录了这次测试执行的操作序列、每一步的结果,还有用了哪些子代理。另外还有一个`testResults`数组,每个测试用例都会有一个结果,并且会给出预期的指标分数,简单来说就是“通过”还是会出现一些常见问题,它会标出来。 最后,如果你觉得通过代码去处理这些OAuth和API调用有点麻烦,也可以用Agentforce DX命令行工具,它把这些操作都封装好了,敲几行命令就能完成同样的工作,对刚入门的同学来说会更友好。 这样看起来,整个过程是不是就清晰多了?我们一步一步来,后面还会有更多实践。

关键词

Agentforce Salesforce