课程章节介绍
同学们，今天咱们来聊聊怎么给 Agentforce 设置自定义连接。这就像你要让咱们的 AI 代理能跟外部的系统说上话，比如连上你公司自己的后台，或者一个第三方的聊天工具。要做到这个，咱们得先创建三个“元数据零件”，缺一不可。
第一个零件叫 ，AiSurface，，你可以把它想成是连接配置的容器，里面定义了代理要跟哪个外部服务打交道，比如那个服务的网址、认证方式这些信息。它就像一座桥的桥墩，把两头给固定住。
第二个呢，叫 ，AiResponseForm，。当外部系统返回数据的时候，数据可能有各种格式，有的是简单的一段文字，有的是一串清单。这个 AiResponseForm 就是用来告诉代理：“嘿，对方回给你的数据是这个结构，你得按这个规矩去读，然后再整理成用户能看懂的样子。” 每一种不同格式的输出，你都得单独定义一个 AiResponseForm。它好比是我们提前给代理准备好的翻译说明书。
第三个零件是 ，GenAiPlannerBundle，。这个名字听起来有点复杂，其实就是把前面那两个零件给捆在一起，再指派给具体的代理。这样一来，代理就知道自己现在具备了这个新连接的能力，遇到相关问题时，会自动去调用那个外部服务。它就是让代理跟连接真正产生关联的“牵线人”。
有了这三个零件，桥才算搭好了。但在动手搭之前，咱们得确认几个前提条件，就像盖房得先打好地基一样：
第一，你的 Agentforce 环境必须已经开通了 ，代理 API 的连接能力，。也就是说，得确保代理能往外发请求，而不会被困在 Salesforce 里头。
第二，你那边得有一个实实在在在运行的 ，外部客户端应用程序，。桥的另一头得真的有个服务在等着，对吧？哪怕是个简单的测试接口都可以。
第三，开发的时候要注意，你使用的 ，元数据 API 版本必须是 66.0 或者更高，。因为只有从那个版本开始，Agentforce 才能识别并正确处理咱们刚说的那三种新元数据类型。版本太老的话，部署的时候会直接报错。
简单总结一下：要自定义一个连接，咱们得按顺序准备好 AiSurface、AiResponseForm 和 GenAiPlannerBundle 这三个元数据，同时确保环境、外部应用和 API 版本都满足要求。这样，代理才能安全、聪明地跟外部世界互动起来。
好了，这些就是今天这页内容的要点，大家先消化一下。有疑问随时提出来。