服务基准地址
Base URL
中级通用服务基准地址（Base URL）是一组请求共同使用的地址前缀，通常包含协议、域名，也可能包含统一的路径前缀。它让你在切换开发、预发布和正式服务时，只改一处配置，而不用逐个修改请求地址。
你可能会说：「我想让所有接口请求跟着环境切换地址，不想在每个功能里分别改链接。」
动手看看订单后台的服务地址配置
切换服务环境，看看三条完整地址如何一起变化。悬停某条请求或用 Tab 聚焦，可以对照它不变的路径和变化的前缀。
这里约定基准地址末尾不带斜杠，请求路径以斜杠开头，直接拼接成完整地址。/api/v1 也属于共用前缀，不必在每条请求里重写。
预发布使用独立域名，供上线前验证。三条请求共享同一处配置，不需要逐个查找并替换域名。
要点服务基准地址怎么用在请求里？
- 1
它是请求地址的共同前缀
假设后台的用户和订单接口都在同一服务下，你可以把共同的地址部分设为基准地址，再分别填写接口路径。这样我们一眼就能看出请求发往哪个服务、调用哪个功能。
- 2
路径前缀也可能属于它
基准地址不一定只到域名。如果服务把接口统一放在 /api 下，这段路径也可能写进基准地址。你要和 AI 说清楚前缀包含到哪里，否则拼接后可能少一段路径，或重复出现 /api。
- 3
切换环境只改一处配置
开发、预发布和正式环境可能提供相同的接口路径，却使用不同地址。把基准地址放进环境配置后，我们就能复用请求代码。切换时也要确认实际生效的配置，免得测试请求发到正式服务。
容易混淆的地方
服务基准地址是地址的共同部分，不是某个具体接口：基准地址加上接口路径，才会定位到一次请求要访问的位置。它也不等于 API 密钥；前者决定请求发往哪里，后者用于向服务证明调用者身份。换了基准地址，不代表密钥也能通用。
什么时候用
适合用
- 你做一个管理后台，用户、订单等接口都由同一后端提供，想统一管理请求发往的地址。
- 你要让 AI 工具在本地、预发布和正式环境调用对应服务，而接口路径保持不变。
- 你接入模型服务，多个功能共用同一个 API 入口，希望换服务时集中修改地址。
不适合用
- 你只是让用户从网站首页跳到帮助页，这属于页面导航；用路由或链接描述目标页面就够了。
- 你处理的是用户提交的任意网页链接，没有共同的服务前缀；直接保存并校验完整 URL 更合适。
- 你只是想限制谁能调用接口，改地址解决不了授权问题；应使用身份认证和权限控制。
练一练选一个答案，看看解释
你做的 AI 工具在本地和预发布环境都要调用同一套模型接口，接口路径相同，但服务地址不同。怎样交代给 AI Agent 更合适？
让 AI 帮你做复制给 AI Agent 直接用
请把项目中调用后端 API 的共同地址前缀整理为可按环境切换的服务基准地址，接口路径保留在各请求处。先确认基准地址是否包含 /api 等路径前缀，再检查拼接结果，并说明本地和预发布环境分别从哪里读取配置。