跳到正文

配置档案

Profile

中级通用

配置档案(Profile)是一组有名字、可以整套切换的连接或运行设置,例如“测试环境”和“正式环境”。它解决的是同一工具要连接不同服务时,地址、身份和其他参数容易混用的问题。

你可能会说:「我想给测试环境和正式环境各存一套连接设置,切换时别让我逐项改地址和密钥。」

读之前建议先了解

动手看看

订单服务连接
测试环境
正式环境
当前使用:测试环境以下设置属于同一个配置档案。
服务地址https://api.sandbox.orders.example
登录身份qa-team@orders.example
数据空间orders_sandbox
当前使用:正式环境以下设置属于同一个配置档案。
服务地址https://api.orders.example
登录身份ops-team@orders.example
数据空间orders_live
配置档案

用下方的「配置档案」切换环境,观察地址、登录身份和数据空间怎样一起变化。也可以悬停或聚焦右上角的档案入口,看看它作为界面控件的反馈。

现在连接的是测试环境:请求发往沙盒地址,使用测试团队身份,数据也落在测试空间。

要点

  1. 1

    把相关设置归到同一组

    假设你的 AI 工具要分别连接测试服务和正式服务,两边的服务地址、模型或账户可能不同。把每套设置命名为一个配置档案,切换时就能一起选中,不用逐项改。

  2. 2

    档案名称不是连接凭证

    “测试环境”只是方便你识别的一组设置,并不能代替 API 密钥。档案可以引用凭证,但具体怎么保存密钥取决于工具;如果会共享配置,先确认凭证不会跟着泄露。

  3. 3

    切换前弄清生效范围

    有的工具只在当前命令中使用指定档案,有的会记住默认档案。你让 Agent 接入服务时,可以说清楚在哪个项目、哪次运行里使用它,因为选错档案可能把测试请求发到正式环境。

容易混淆的地方

配置文件是存放设置的一种载体,里面可以定义多个配置档案;档案强调的是“选用哪一整套设置”,不限定存在哪里。环境变量则是向程序提供单项或多项值的方式,也可能被档案引用。你要切换整套连接时谈档案;只改一个地址时,不一定需要新建档案。

什么时候用

适合用

  • 同一个后台项目要连接测试和正式数据库,两边地址与账户不同,你希望通过名称切换整套连接设置。
  • 做 AI 工具时要在不同模型提供方或服务地址间切换,并保留各自的模型名称、超时等参数。
  • 团队共用一套命令行工具,但每个人连接自己的开发服务,可以各自选用本地配置档案。

不适合用

  • 项目只有一个固定服务地址,也没有切换需求时,直接在现有配置中写清楚即可,不必多套档案。
  • 只是想给不同成员开放不同页面时,用权限控制;配置档案不能替代用户身份和访问授权。
  • 只是临时调整一次请求的超时时间时,使用该次调用的参数更直接,没必要为单次变化新建档案。

练一练

你在开发一个 AI 客服工具,测试环境和正式环境使用不同的服务地址、模型和 API 密钥。团队需要反复切换测试,但不想每次手动改三个地方。哪种做法更合适?

让 AI 帮你做

请为这个 AI 客服项目设计“测试环境”和“正式环境”两个配置档案,分别管理服务地址、模型和凭证引用。说明如何显式选择档案、默认档案的生效范围,以及怎样避免把密钥写进会提交到仓库的文件;先不要连接正式服务。

接下来学什么