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 }

本頁目錄