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 兼容模型即可。
推荐上线顺序
- 先验证最基础的聊天补全。
- 基础链路稳定后,再加 tool use、结构化输出或 agent loop。
- 切换模型家族后重新验证提示词效果。
- 给长时间运行的 agent 任务准备一个备用模型。
常见失败场景
| 问题 | 处理方式 |
|---|---|
| LangChain 能初始化,但请求打错主机 | 重新检查 base_url / OPENAI_API_BASE |
| 某些提示词稳定,某些不稳定 | 先回到更简单的请求形态,确认不是请求复杂度问题 |
| Agent 运行把成本放大 | 增加单次运行预算和回退上限 |
| 结构化输出在不同模型上表现不同 | 对 schema 敏感链路逐模型验证 |