怎么说呢，

AI大模型兼容教程，你踩坑了吗？

前言

大模型厂商众多，OpenAI、Anthropic、Google Gemini、GitHub Copilot、xAI Grok…，每个厂商的 API 接口设计都不尽相同。如果业务代码直接耦合某一家 SDK，换模型几乎等于重写。

这篇文章介绍一种统一抽象层的设计思路：让业务代码只依赖一套接口协议，底层可以无缝切换任意大模型。兼容同步对话和流式输出，并支持工具调用这一复杂能力。

这篇文章展示主要设计决策和实现思路。

. 问题：模型差异在哪里？

消息结构的差异

OpenAI 系列

• 用 role: "assistant" 表示模型回复
• 用 role: "tool" 独立消息传递工具结果

  // OpenAI 工具结果
  {
  再看"role"，"tool","tool_call_id": "abc123"。"content": "..."
  }

  Anthropic:

  • 一样用 role: "assistant" 表示模型回复

• . 用 "content" 数组里的 type:"tool_result" 来表示工具结果，不是独立消息。

  // Anthropic 工具结果
  {
  "role"这方面，"user"。"content":
  }