Skip to main content

配置

provider.json

主要的模型配置文件。定义可用的提供商和模型:

结构

  • 顶层 = 提供商 ID → 模型配置数组
  • 查找 = providers[provider_id][model_name]
  • 多密钥 = 在 api_keys 中的密钥之间进行负载均衡

字段说明

加载

或者使用 Responses API:

最佳实践

  • 每个项目维护一个 provider.json(纳入版本控制,但去掉密钥)
  • 为热门模型在 api_keys 中配置多个密钥(自动轮换)
  • 使用 api_params 配置稳定的每模型默认参数,例如 reasoning_effort;一次性覆盖请在调用时传 kwargs
  • 根据你的服务等级调整 rate_limit_capacityrate_limit_refill_rate
  • 本地模型使用 max_retries=2(快速失败),云端模型使用 max_retries=5(应对瞬时错误)

环境变量(.env)

框架从 .env 文件读取日志和可观测性配置:

优先级

运行时环境变量 → .env 文件 → 框架默认值

推荐默认值

  • LOG_LEVEL=WARNING —— 在正常使用时减少框架的输出噪音
  • LOG_DIR=logs —— 将日志文件放在项目根目录之外
  • Langfuse 默认禁用 —— 仅在需要收集 trace 时启用

直接构造(无需文件)

对于脚本和一次性使用场景,可以完全跳过 provider.json:
这种方式非常适合 shell 脚本、演示和快速实验。