{"record":{"id":"ca06210d9ee84c08","repo":"microsoft/semantic-kernel","slug":"please-provide-an-azure-openai-responses-deploymen","errorCode":null,"errorMessage":"Please provide an Azure OpenAI Responses deployment name","messagePattern":"Please provide an Azure OpenAI Responses deployment name","errorType":"exception","errorClass":"AgentInitializationException","httpStatus":null,"severity":"critical","filePath":"python/semantic_kernel/agents/open_ai/azure_responses_agent.py","lineNumber":134,"sourceCode":"\n        # If we still have no credentials, we can't proceed\n        if not azure_openai_settings.api_key and not ad_token and not ad_token_provider and not credential:\n            raise AgentInitializationException(\n                \"Please provide either an api_key, ad_token, ad_token_provider or credential for authentication.\"\n            )\n\n        merged_headers = dict(copy(default_headers)) if default_headers else {}\n        if default_headers:\n            merged_headers.update(default_headers)\n        if APP_INFO:\n            merged_headers.update(APP_INFO)\n            merged_headers = prepend_semantic_kernel_to_user_agent(merged_headers)\n\n        if not azure_openai_settings.endpoint:\n            raise AgentInitializationException(\"Please provide an Azure OpenAI endpoint\")\n\n        if not azure_openai_settings.responses_deployment_name:\n            raise AgentInitializationException(\"Please provide an Azure OpenAI Responses deployment name\")\n\n        client = AsyncAzureOpenAI(\n            azure_endpoint=str(azure_openai_settings.endpoint),\n            api_version=azure_openai_settings.api_version,\n            api_key=azure_openai_settings.api_key.get_secret_value() if azure_openai_settings.api_key else None,\n            azure_ad_token=ad_token,\n            azure_ad_token_provider=ad_token_provider,\n            default_headers=merged_headers,\n            **kwargs,\n        )\n\n        return client, azure_openai_settings.responses_deployment_name\n\n    @staticmethod\n    def create_client(\n        *,\n        ad_token: str | None = None,\n        ad_token_provider: Callable[[], str | Awaitable[str]] | None = None,","sourceCodeStart":116,"sourceCodeEnd":152,"githubUrl":"https://github.com/microsoft/semantic-kernel/blob/c028a0c7dc4f0814cdcbaba9d998f187a41197bf/python/semantic_kernel/agents/open_ai/azure_responses_agent.py#L116-L152","documentation":"Raised by AzureResponsesAgent's client builder when AzureOpenAISettings.responses_deployment_name is unset. The Responses API path needs the specific deployment name configured for the Responses API in Azure; without it the client cannot target a model.","triggerScenarios":"Constructing AzureResponsesAgent where responses_deployment_name resolves to None/empty. This is set via AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME or the deployment_name argument; chat_deployment_name does not satisfy this check.","commonSituations":"Setting AZURE_OPENAI_CHAT_DEPLOYMENT_NAME instead of AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME; not passing deployment_name to the constructor; using a resource that has no Responses API deployment configured.","solutions":["Set AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME to the Responses deployment name from Azure portal > Deployments.","Pass deployment_name='...' to the AzureResponsesAgent constructor.","Do not confuse with chat_deployment_name; the Responses API requires its own deployment.","Confirm the deployment actually exists and is a Responses-capable model in your resource."],"exampleFix":"# before\nAzureResponsesAgent(endpoint=..., api_key=...)  # responses_deployment_name missing\n# after\nAzureResponsesAgent(\n    endpoint=\"https://myresource.openai.azure.com/\",\n    deployment_name=\"my-responses-deploy\",\n    api_key=\"...\",\n)","handlingStrategy":"validation","validationCode":"from semantic_kernel.connectors.ai.open_ai.settings import AzureOpenAISettings\n\nsettings = AzureOpenAISettings()\nif not settings.responses_deployment_name:\n    raise SystemExit(\n        \"AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME is not set. \"\n        \"This must be a Responses-capable deployment.\"\n    )","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME, not the chat deployment name, for the Responses API.","Document which deployments each agent type requires.","Add a startup check for the specific deployment name field the agent needs."],"tags":["azure-openai","configuration","semantic-kernel","agents","deployment-name","responses-api","initialization"],"backgroundTag":null,"analyzedSha":"c028a0c7dc4f0814cdcbaba9d998f187a41197bf","analyzedAt":"2026-08-13T13:48:05.040Z","schemaVersion":2},"datasetVersion":"2026-08-13T14:17:21.547Z"}