首页/文档/Provider 与模型

核心概念

Provider 与模型

接入模型 Provider,并理解 Provider 配置与模型选择在系统中的位置。

KCode 把模型接入和模型选择作为独立的一层,而不是散落在每个页面或每次请求里。这样做的目标是让 Provider、鉴权信息和模型选择可以被统一管理,而不是跟某个具体 Session 强绑定。

什么时候应该先检查 Provider

如果本地服务已经跑起来,但无法正常发起模型请求,优先检查:

  • 你是否已经接入至少一个 Provider。
  • 当前模型是否和该 Provider 匹配。
  • 当前运行环境里是否存在必要的鉴权信息。

为什么 Provider 和模型要分开理解

对外使用时,最好把它拆成两步:

  1. 接入哪个 Provider。
  2. 当前会话选择哪个模型。

这样你在排查问题时会更清楚,到底是账号和鉴权问题,还是模型选择问题。

KCode 里 Provider 层负责什么

仓库内部有独立的 domains/provider,用于描述:

  • Provider 列表
  • 鉴权信息
  • 模型选择
  • 运行时 Provider 配置映射

这说明 Provider 更接近运行时能力配置,而不是项目目录的一部分。

使用建议

  • 先接入一个稳定可用的 Provider,再开始试不同模型。
  • 把模型切换看成运行参数,而不是项目结构的一部分。
  • 团队共享使用方式时,优先记录 Provider 与模型约定,而不是只保存某次 prompt。

相关阅读

  • 想确认默认地址和环境变量:看 配置说明
  • 想理解这层配置如何接到运行链路:看 系统如何工作
  • 想快速排查为什么“服务启动了但还不能工作”:看 常见问题