fix: align Azure AI Inference routing guidance

Author: edelauna

packages/types/src/providers/openai.ts

@@ -706,17 +706,32 @@ export const OPENAI_NATIVE_DEFAULT_TEMPERATURE = 0
 
 export const OPENAI_AZURE_AI_INFERENCE_PATH = "/models/chat/completions"
 
+/**
+ * Returns true when the base URL belongs to Azure AI Inference.
+ * These endpoints use the regular OpenAI client and expect a model identifier,
+ * even when the Azure compatibility flag is enabled.
+ */
+export function isAzureAiInferenceBaseUrl(baseUrl?: string): boolean {
+	try {
+		const host = new URL(baseUrl ?? "").host
+		return host.endsWith(".services.ai.azure.com")
+	} catch {
+		return false
+	}
+}
+
 /**
  * Returns true when the base URL and/or flag indicate an Azure OpenAI endpoint.
  * Azure AI Inference endpoints (*.services.ai.azure.com) return false — the
  * backend routes those through the plain OpenAI client, not AzureOpenAI.
  */
 export function isAzureOpenAiBaseUrl(baseUrl?: string, useAzure?: boolean): boolean {
+	if (isAzureAiInferenceBaseUrl(baseUrl)) return false
 	if (useAzure) return true
 
 	try {
 		const host = new URL(baseUrl ?? "").host
-		return (host === "azure.com" || host.endsWith(".azure.com")) && !host.endsWith(".services.ai.azure.com")
+		return host === "azure.com" || host.endsWith(".azure.com")
 	} catch {
 		return false
 	}

src/api/providers/__tests__/openai.spec.ts

@@ -897,6 +897,16 @@ describe("OpenAiHandler", () => {
 			expect(azureHandler.getModel().id).toBe(azureOptions.openAiModelId)
 		})
 
+		it("should keep Azure AI Inference precedence when Azure mode is enabled", () => {
+			vi.mocked(OpenAI).mockClear()
+			vi.mocked(AzureOpenAI).mockClear()
+
+			new OpenAiHandler({ ...azureOptions, openAiUseAzure: true })
+
+			expect(vi.mocked(OpenAI)).toHaveBeenCalled()
+			expect(vi.mocked(AzureOpenAI)).not.toHaveBeenCalled()
+		})
+
 		it("should handle streaming responses with Azure AI Inference Service", async () => {
 			const azureHandler = new OpenAiHandler(azureOptions)
 			const systemPrompt = "You are a helpful assistant."

src/api/providers/openai.ts

@@ -5,6 +5,7 @@ import axios from "axios"
 import {
 	type ModelInfo,
 	azureOpenAiDefaultApiVersion,
+	isAzureAiInferenceBaseUrl,
 	isAzureOpenAiBaseUrl,
 	openAiModelInfoSaneDefaults,
 	DEEP_SEEK_DEFAULT_TEMPERATURE,
@@ -521,8 +522,7 @@ export class OpenAiHandler extends BaseProvider implements SingleCompletionHandl
 	}
 
 	protected _isAzureAiInference(baseUrl?: string): boolean {
-		const urlHost = this._getUrlHost(baseUrl)
-		return urlHost.endsWith(".services.ai.azure.com")
+		return isAzureAiInferenceBaseUrl(baseUrl)
 	}
 
 	/**

webview-ui/src/components/settings/providers/__tests__/OpenAICompatible.spec.tsx

@@ -201,6 +201,24 @@ describe("OpenAICompatible Component - includeMaxTokens checkbox", () => {
 				screen.queryByText("settings:providers.azureOpenAiDeploymentNameDescription"),
 			).not.toBeInTheDocument()
 		})
+
+		it("keeps generic guidance when Azure AI Inference uses the Azure compatibility flag", () => {
+			render(
+				<OpenAICompatible
+					apiConfiguration={
+						{
+							openAiBaseUrl: "https://my-resource.services.ai.azure.com/models",
+							openAiUseAzure: true,
+						} as ProviderSettings
+					}
+					setApiConfigurationField={mockSetApiConfigurationField}
+					organizationAllowList={mockOrganizationAllowList}
+				/>,
+			)
+
+			expect(screen.getByPlaceholderText("settings:placeholders.baseUrl")).toBeInTheDocument()
+			expect(mockModelPicker).toHaveBeenLastCalledWith(expect.objectContaining({ label: undefined }))
+		})
 	})
 
 	describe("Initial State", () => {