agent combo: 多模型接入与成本可观测

Metadata

id	`combo-model-access`	recorded	2026-08-29
members	2	status	partial

tool role version install guide

tool	role	version	install	guide
`litellm`	统一接入网关	`>= 1.98.0（2026-08-29 实测；Python >= 3.8）`	`python3 -m venv ~/.litellm-venv ~/.litellm-venv/bin/pip install -i https://pypi.tuna.tsinghua.edu.cn/simple litellm[proxy]`	guide
`logfire`	可观测	`== 4.41.0（2026-08-28 收录实测版本）`	`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple logfire==4.41.0 logfire --version`	guide

litellm

统一接入网关

>= 1.98.0（2026-08-29 实测；Python >= 3.8）

python3 -m venv ~/.litellm-venv
~/.litellm-venv/bin/pip install -i https://pypi.tuna.tsinghua.edu.cn/simple litellm[proxy]

logfire

可观测

== 4.41.0（2026-08-28 收录实测版本）

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple logfire==4.41.0
logfire --version

litellm（网关）→ 2. logfire（可观测）；全装完跑通才算组合就绪。litellm 为服务端进程（默认端口 4000），logfire 为 SDK/CLI 形态。

版本：Python >= 3.8（两工具 pip 形态）；litellm >= 1.98.0（实测）；logfire == 4.41.0。
环境：litellm 建议隔离 venv（依赖多）；litellm 首次启动拉取远程 cost map 超时会自动回退本地备份（国内网络观察，2026-08-29 实测）。
端口：litellm 默认 4000（--port 可改）；与占用 4000 的服务冲突。
冲突：两工具写面互不重叠（代理配置 / 遥测数据）→ compatible（组合包实测态：2026-08-29 litellm 代理面冒烟通过）。
国内网络：pip → 清华镜像；litellm 远程 cost map 国内可能超时（自动回退本地备份）。
注意：真实转发需模型 API key（key 集中放 litellm 配置，客户端不再散落）。

Evidence details kept locally (2026-08-29)