集成指南/LangChain 接入

通过 OpenAI 兼容的 langchain-openai 包把 UniGateway 接入 LangChain。

LangChain 接入

通过 langchain-openai 的 OpenAI 兼容集成,可以把 UniGateway 接入 LangChain。

最小配置

  • 包:langchain-openai
  • API key:你的 UniGateway key
  • Base URL:https://api.unigateway.ai/v1
  • Model:GET /v1/models 返回的精确模型 ID

LangChain 的 OpenAI 集成支持配置 OpenAI API 的 base URL。

Python 示例

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-5.2",
    api_key="<YOUR_UNIGATEWAY_API_KEY>",
    base_url="https://api.unigateway.ai/v1",
    temperature=0,
)

print(llm.invoke("给我一个简短的上线检查清单。").content)

环境变量模式

export OPENAI_API_KEY="$UNIGATEWAY_API_KEY"
export OPENAI_API_BASE="https://api.unigateway.ai/v1"

然后按正常方式初始化 LangChain 的 OpenAI 兼容模型即可。

推荐上线顺序

  1. 先验证最基础的聊天补全。
  2. 基础链路稳定后,再加 tool use、结构化输出或 agent loop。
  3. 切换模型家族后重新验证提示词效果。
  4. 给长时间运行的 agent 任务准备一个备用模型。

常见失败场景

问题处理方式
LangChain 能初始化,但请求打错主机重新检查 base_url / OPENAI_API_BASE
某些提示词稳定,某些不稳定先回到更简单的请求形态,确认不是请求复杂度问题
Agent 运行把成本放大增加单次运行预算和回退上限
结构化输出在不同模型上表现不同对 schema 敏感链路逐模型验证