服务商扩展 ​

当你准备接入新的模型平台时，最重要的不是先改表单，而是先把这件事拆清楚：

• 你是只想让后台多一个协议选项
• 还是想让这个平台真正支持聊天、Embedding、图片、视频
• 还是还要把文件解析、机器人渠道一起接进来

把这几件事分开理解，后面的扩展会清晰很多。

先判断你要扩的是哪一层 ​

服务商协议 ​

这一层主要解决的是：

• 后台服务商表单里要出现新的协议选项
• 向导里要显示协议说明
• 默认 Base URL 和是否要求 API Key 要有统一来源

如果你现在只是希望系统里多一个协议可选，通常先从这一层开始。

运行时模型能力 ​

如果你不仅想让后台能选这个协议，还想让它真的跑起来，那接下来还要继续补运行时能力链路。

例如：

• 聊天
• Embedding
• 图片生成
• 视频生成
• 文件接口

文件解析能力 ​

如果这个平台的文档解析、OCR、PDF 识别是单独的一套协议，就更适合走解析驱动扩展，而不是直接混进服务商协议里。

机器人渠道能力 ​

如果你要接的是聊天平台、IM 或机器人渠道，那应该走机器人驱动扩展，而不是服务商扩展。

推荐的扩展顺序 ​

如果你要接一个新平台，建议按这个顺序推进：

1. 先确认它的协议类型和文档
2. 先决定是否只需要新增协议元信息
3. 再决定要不要继续补聊天、Embedding、图片、视频能力
4. 如果文件解析是独立协议，再单独扩解析驱动
5. 如果还要接聊天平台，再扩机器人驱动

最容易踩坑的地方 ​

后台能选，但实际跑不通 ​

这通常说明你只补了协议元信息，没有把运行时能力链路一起补上。

把文件解析误当成服务商能力 ​

文件解析通常更适合走“解析驱动”这条线，而不是直接塞进服务商协议里。

一开始就想把所有能力一起接完 ​

更稳妥的做法通常是：

1. 先跑通聊天
2. 再补 Embedding
3. 再补图片和视频
4. 最后再补文件、异步任务和其他高级能力

继续往下看 ​

如果你已经确认自己要扩哪一层，可以继续看这些页面：

• 注册服务商协议
• 注册解析驱动
• 注册机器人驱动

如果你只是想先复用现有能力，而不是自己扩展实现，也建议先从：

• 开发概览
• 智能体服务
• 能力扩展 开始看。