配置
provider.json
主要的模型配置文件。定义可用的提供商和模型:结构
- 顶层 = 提供商 ID → 模型配置数组
- 查找 =
providers[provider_id][model_name] - 多密钥 = 在
api_keys中的密钥之间进行负载均衡
字段说明
加载
最佳实践
- 每个项目维护一个
provider.json(纳入版本控制,但去掉密钥) - 为热门模型在
api_keys中配置多个密钥(自动轮换) - 使用
api_params配置稳定的每模型默认参数,例如reasoning_effort;一次性覆盖请在调用时传 kwargs - 根据你的服务等级调整
rate_limit_capacity和rate_limit_refill_rate - 本地模型使用
max_retries=2(快速失败),云端模型使用max_retries=5(应对瞬时错误)
环境变量(.env)
框架从.env 文件读取日志和可观测性配置:
优先级
运行时环境变量 →.env 文件 → 框架默认值
推荐默认值
LOG_LEVEL=WARNING—— 在正常使用时减少框架的输出噪音LOG_DIR=logs—— 将日志文件放在项目根目录之外- Langfuse 默认禁用 —— 仅在需要收集 trace 时启用