MINARA

设置首选提供商(热切换)

PUT /v1/auth/preferred-provider:设置或清除首选提供商覆盖项;保存前会实时探测所选凭据。

PUT /v1/auth/preferred-provider

设置或清除首选提供商覆盖项。保存前会实时探测所选凭据;配置已存在但凭据过期时,返回 400 reauth_required

成功后还会在进程内完成热切换:通过 selectProvider + createLLMClient 为新提供商重建 LLM 客户端,并原子更新唯一真相来源 LLMRouter。长驻组件(Minara、ScenarioClassifier、ChartBuilder 等)通过实时 Proxy 在下一次 createMessage 时使用新客户端。Minara 会在每轮开始时快照客户端,因此切换发生时正在执行的一轮仍会使用旧提供商完成,不会拆分对话;下一轮使用新提供商。

模型会自动选择 defaultModelForProvider(newKind),因为模型 ID 受提供商范围限制(grok-4 仅适用于 xAI,gpt-5 仅适用于 OpenAI)。新模型会保存到以新提供商为键的 defaultModel 槽位,下次网关启动时仍使用相同组合。

响应为 { ok, preferredProvider, activeModel, swapped, inflightOnOldProvider }swapped: false 表示已保存偏好,但进程内重建失败(例如探测和重建之间凭据消失);下次网关启动仍会读取保存的偏好。

方法PUT
路径/v1/auth/preferred-provider
认证需要 Authorization: Bearer <token>
类别auth

请求体

{ "provider": ProviderKind | null }

本页目录