Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
feat(azure): add Responses API support for Azure OpenAI provider (#5201)
Kunal Karmakare0b86750c27e
diff --git a/lib/crewai/src/crewai/llms/providers/azure/completion.py b/lib/crewai/src/crewai/llms/providers/azure/completion.pyindex 714a7f0e9..b5cb30fb1 100644--- a/lib/crewai/src/crewai/llms/providers/azure/completion.py+++ b/lib/crewai/src/crewai/llms/providers/azure/completion.py@@ -89,8 +89,22 @@ class AzureCompletion(BaseLLM):is_openai_model: bool = Falseis_azure_openai_endpoint: bool = False+ # Responses API settings+ api: Literal["completions", "responses"] = "completions"+ reasoning_effort: str | None = None+ instructions: str | None = None+ store: bool | None = None+ previous_response_id: str | None = None+ include: list[str] | None = None+ builtin_tools: list[str] | None = None+ parse_tool_outputs: bool = False+ auto_chain: bool = False+ auto_chain_reasoning: bool = False+ max_completion_tokens: int | None = None+_client: Any = PrivateAttr(default=None)_async_client: Any = PrivateAttr(default=None)+ _responses_delegate: Any = PrivateAttr(default=None)@model_validator(mode="before")@classmethod@@ -147,12 +161,89 @@ class AzureCompletion(BaseLLM):import time even before deployment env vars are set."""try:- self._client = self._build_sync_client()- self._async_client = self._build_async_client()+ if self.api == "responses":+ self._init_responses_delegate()+ else:+ self._client = self._build_sync_client()+ self._async_client = self._build_async_client()except ValueError:passreturn self+ def _init_responses_delegate(self) -> None:+ """Create an OpenAICompletion delegate for the Azure OpenAI Responses API.++ The Azure OpenAI Responses API uses the standard OpenAI Python SDK+ with a base_url pointing to the Azure resource's /openai/v1/ endpoint.+ """+ from crewai.llms.providers.openai.completion import OpenAICompletion++ base_url = self._get_responses_base_url()++ delegate_kwargs: dict[str, Any] = {+ "model": self.model,+ "api_key": self.api_key,+ "base_url": base_url,+ "api": "responses",+ "provider": "openai",+ "stream": self.stream,+ }++ if self.temperature is not None:+ delegate_kwargs["temperature"] = self.temperature+ if self.top_p is not None:+ delegate_kwargs["top_p"] = self.top_p+ if self.max_tokens is not None:+ delegate_kwargs["max_tokens"] = self.max_tokens+ if self.max_completion_tokens is not None:+ delegate_kwargs["max_completion_tokens"] = self.max_completion_tokens+ if self.stop:+ delegate_kwargs["stop"] = self.stop+ if self.timeout is not None:+ delegate_kwargs["timeout"] = self.timeout+ if self.max_retries != 2:+ delegate_kwargs["max_retries"] = self.max_retries+ if self.reasoning_effort is not None:+ delegate_kwargs["reasoning_effort"] = self.reasoning_effort+ if self.instructions is not None:+ delegate_kwargs["instructions"] = self.instructions+ if self.store is not None:+ delegate_kwargs["store"] = self.store+ if self.previous_response_id is not None:+ delegate_kwargs["previous_response_id"] = self.previous_response_id+ if self.include is not None:+ delegate_kwargs["include"] = self.include+ if self.builtin_tools is not None:+ delegate_kwargs["builtin_tools"] = self.builtin_tools+ if self.parse_tool_outputs:+ delegate_kwargs["parse_tool_outputs"] = self.parse_tool_outputs+ if self.auto_chain:+ delegate_kwargs["auto_chain"] = self.auto_chain+ if self.auto_chain_reasoning:+ delegate_kwargs["auto_chain_reasoning"] = self.auto_chain_reasoning+ if self.response_format is not None:+ delegate_kwargs["response_format"] = self.response_format+ if self.additional_params:+ delegate_kwargs["additional_params"] = self.additional_params++ self._responses_delegate = OpenAICompletion(**delegate_kwargs)++ def _get_responses_base_url(self) -> str:+ """Construct the base URL for the Azure OpenAI Responses API.++ Extracts the scheme and host from the configured endpoint and appends+ the ``/openai/v1/`` path required by the Azure OpenAI Responses API.++ Returns:+ The Responses API base URL, e.g.+ ``https://myresource.openai.azure.com/openai/v1/``+ """+ if not self.endpoint:+ raise ValueError("Azure endpoint is required for Responses API")+ parsed = urlparse(self.endpoint)+ base = f"{parsed.scheme}://{parsed.netloc}"+ return f"{base}/openai/v1/"+def _build_sync_client(self) -> Any:return ChatCompletionsClient(**self._make_client_kwargs())@@ -252,6 +343,16 @@ class AzureCompletion(BaseLLM):config["presence_penalty"] = self.presence_penaltyif self.max_tokens is not None:config["max_tokens"] = self.max_tokens+ if self.api != "completions":+ config["api"] = self.api+ if self.reasoning_effort is not None:+ config["reasoning_effort"] = self.reasoning_effort+ if self.instructions is not None:+ config["instructions"] = self.instructions+ if self.store is not None:+ config["store"] = self.store+ if self.max_completion_tokens is not None:+ config["max_completion_tokens"] = self.max_completion_tokensreturn config@staticmethod@@ -357,10 +458,10 @@ class AzureCompletion(BaseLLM):from_agent: Any | None = None,response_model: type[BaseModel] | None = None,) -> str | Any:- """Call Azure AI Inference chat completions API.+ """Call Azure AI Inference API.Args:- messages: Input messages for the chat completion+ messages: Input messagestools: List of tool/function definitionscallbacks: Callback functions (not used in native implementation)available_functions: Available functions for tool calling@@ -369,8 +470,19 @@ class AzureCompletion(BaseLLM):response_model: Response modelReturns:- Chat completion response or tool call result+ Completion response or tool call result"""+ if self.api == "responses":+ return self._responses_delegate.call(+ messages=messages,+ tools=tools,+ callbacks=callbacks,+ available_functions=available_functions,+ from_task=from_task,+ from_agent=from_agent,+ response_model=response_model,+ )+with llm_call_context():try:# Emit call started event@@ -429,10 +541,10 @@ class AzureCompletion(BaseLLM):from_agent: Any | None = None,response_model: type[BaseModel] | None = None,) -> str | Any:- """Call Azure AI Inference chat completions API asynchronously.+ """Call Azure AI Inference API asynchronously.Args:- messages: Input messages for the chat completion+ messages: Input messagestools: List of tool/function definitionscallbacks: Callback functions (not used in native implementation)available_functions: Available functions for tool calling@@ -441,8 +553,19 @@ class AzureCompletion(BaseLLM):response_model: Pydantic model for structured outputReturns:- Chat completion response or tool call result+ Completion response or tool call result"""+ if self.api == "responses":+ return await self._responses_delegate.acall(+ messages=messages,+ tools=tools,+ callbacks=callbacks,+ available_functions=available_functions,+ from_task=from_task,+ from_agent=from_agent,+ response_model=response_model,+ )+with llm_call_context():try:self._emit_call_started_event(@@ -1178,6 +1301,32 @@ class AzureCompletion(BaseLLM):return resultreturn {"total_tokens": 0}+ @property+ def last_response_id(self) -> str | None:+ """Get the last response ID from Responses API auto-chaining."""+ if self._responses_delegate is not None:+ result: str | None = self._responses_delegate.last_response_id+ return result+ return None++ @property+ def last_reasoning_items(self) -> list[Any] | None:+ """Get the last reasoning items from Responses API auto-chain reasoning."""+ if self._responses_delegate is not None:+ result: list[Any] | None = self._responses_delegate.last_reasoning_items+ return result+ return None++ def reset_chain(self) -> None:+ """Reset the Responses API auto-chain state."""+ if self._responses_delegate is not None:+ self._responses_delegate.reset_chain()++ def reset_reasoning_chain(self) -> None:+ """Reset the Responses API reasoning chain state."""+ if self._responses_delegate is not None:+ self._responses_delegate.reset_reasoning_chain()+async def aclose(self) -> None:"""Close the async client and clean up resources.diff --git a/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_call_delegates_to_responses.yaml b/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_call_delegates_to_responses.yamlnew file mode 100644index 000000000..7d3bd8437--- /dev/null+++ b/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_call_delegates_to_responses.yaml@@ -0,0 +1,133 @@+interactions:+- request:+ body: '{"input":[{"role":"user","content":"Say hello in one sentence."}],"model":"gpt-5.2-chat"}'+ headers:+ User-Agent:+ - X-USER-AGENT-XXX+ accept:+ - application/json+ accept-encoding:+ - ACCEPT-ENCODING-XXX+ authorization:+ - AUTHORIZATION-XXX+ connection:+ - keep-alive+ content-length:+ - '89'+ content-type:+ - application/json+ host:+ - kkarmakar-ai-eus2.openai.azure.com+ x-stainless-arch:+ - X-STAINLESS-ARCH-XXX+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - X-STAINLESS-OS-XXX+ x-stainless-package-version:+ - 2.32.0+ x-stainless-read-timeout:+ - X-STAINLESS-READ-TIMEOUT-XXX+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.13.12+ method: POST+ uri: https://fake-azure-endpoint.openai.azure.com/openai/v1/responses+ response:+ body:+ string: "{\n \"id\": \"resp_0473c8c2b1c49f8c0069f23d0910e081958ebce72a734935c7\",\n+ \ \"object\": \"response\",\n \"created_at\": 1777483017,\n \"status\":+ \"completed\",\n \"background\": false,\n \"completed_at\": 1777483018,\n+ \ \"content_filters\": [\n {\n \"blocked\": false,\n \"source_type\":+ \"prompt\",\n \"content_filter_raw\": [],\n \"content_filter_results\":+ {\n \"jailbreak\": {\n \"detected\": false,\n \"filtered\":+ false\n },\n \"hate\": {\n \"filtered\": false,\n \"severity\":+ \"safe\"\n },\n \"sexual\": {\n \"filtered\": false,\n+ \ \"severity\": \"safe\"\n },\n \"violence\": {\n \"filtered\":+ false,\n \"severity\": \"safe\"\n },\n \"self_harm\":+ {\n \"filtered\": false,\n \"severity\": \"safe\"\n }\n+ \ },\n \"content_filter_offsets\": {\n \"start_offset\": 0,\n+ \ \"end_offset\": 368,\n \"check_offset\": 0\n }\n },\n+ \ {\n \"blocked\": false,\n \"source_type\": \"completion\",\n+ \ \"content_filter_raw\": [],\n \"content_filter_results\": {\n \"protected_material_code\":+ {\n \"detected\": false,\n \"filtered\": false\n },\n+ \ \"protected_material_text\": {\n \"detected\": false,\n \"filtered\":+ false\n },\n \"hate\": {\n \"filtered\": false,\n \"severity\":+ \"safe\"\n },\n \"sexual\": {\n \"filtered\": false,\n+ \ \"severity\": \"safe\"\n },\n \"violence\": {\n \"filtered\":+ false,\n \"severity\": \"safe\"\n },\n \"self_harm\":+ {\n \"filtered\": false,\n \"severity\": \"safe\"\n }\n+ \ },\n \"content_filter_offsets\": {\n \"start_offset\": 0,\n+ \ \"end_offset\": 53,\n \"check_offset\": 0\n }\n }\n+ \ ],\n \"error\": null,\n \"frequency_penalty\": 0.0,\n \"incomplete_details\":+ null,\n \"instructions\": null,\n \"max_output_tokens\": null,\n \"max_tool_calls\":+ null,\n \"model\": \"gpt-5.2-chat\",\n \"output\": [\n {\n \"id\":+ \"rs_0473c8c2b1c49f8c0069f23d09f24481959bcf9fd847a9a475\",\n \"type\":+ \"reasoning\",\n \"summary\": []\n },\n {\n \"id\": \"msg_0473c8c2b1c49f8c0069f23d0a8ccc81958f776ad6016d7edd\",\n+ \ \"type\": \"message\",\n \"status\": \"completed\",\n \"content\":+ [\n {\n \"type\": \"output_text\",\n \"annotations\":+ [],\n \"logprobs\": [],\n \"text\": \"Hello! \\ud83d\\ude0a\"\n+ \ }\n ],\n \"role\": \"assistant\"\n }\n ],\n \"parallel_tool_calls\":+ true,\n \"presence_penalty\": 0.0,\n \"previous_response_id\": null,\n \"prompt_cache_key\":+ null,\n \"prompt_cache_retention\": null,\n \"reasoning\": {\n \"effort\":+ \"medium\",\n \"summary\": null\n },\n \"safety_identifier\": null,\n+ \ \"service_tier\": \"default\",\n \"store\": true,\n \"temperature\": 1.0,\n+ \ \"text\": {\n \"format\": {\n \"type\": \"text\"\n },\n \"verbosity\":+ \"medium\"\n },\n \"tool_choice\": \"auto\",\n \"tools\": [],\n \"top_logprobs\":+ 0,\n \"top_p\": 0.85,\n \"truncation\": \"disabled\",\n \"usage\": {\n+ \ \"input_tokens\": 12,\n \"input_tokens_details\": {\n \"cached_tokens\":+ 0\n },\n \"output_tokens\": 22,\n \"output_tokens_details\": {\n+ \ \"reasoning_tokens\": 0\n },\n \"total_tokens\": 34\n },\n \"user\":+ null,\n \"metadata\": {}\n}"+ headers:+ Content-Length:+ - '3203'+ Content-Type:+ - application/json+ Date:+ - Wed, 29 Apr 2026 17:16:59 GMT+ Strict-Transport-Security:+ - STS-XXX+ apim-request-id:+ - APIM-REQUEST-ID-XXX+ skip-error-remapping:+ - 'true'+ x-content-type-options:+ - X-CONTENT-TYPE-XXX+ x-ms-client-request-id:+ - X-MS-CLIENT-REQUEST-ID-XXX+ x-ms-is-spilled-over:+ - 'false'+ x-ms-region:+ - X-MS-REGION-XXX+ x-ratelimit-abusepenalty-active:+ - 'False'+ x-ratelimit-key:+ - gpt-5.2-chat+ x-ratelimit-limit-requests:+ - X-RATELIMIT-LIMIT-REQUESTS-XXX+ x-ratelimit-limit-tokens:+ - X-RATELIMIT-LIMIT-TOKENS-XXX+ x-ratelimit-remaining-requests:+ - X-RATELIMIT-REMAINING-REQUESTS-XXX+ x-ratelimit-remaining-tokens:+ - X-RATELIMIT-REMAINING-TOKENS-XXX+ x-ratelimit-renewalperiod-requests:+ - '60'+ x-ratelimit-renewalperiod-tokens:+ - '60'+ x-ratelimit-reset-requests:+ - X-RATELIMIT-RESET-REQUESTS-XXX+ x-ratelimit-reset-tokens:+ - X-RATELIMIT-RESET-TOKENS-XXX+ x-request-id:+ - X-REQUEST-ID-XXX+ status:+ code: 200+ message: OK+version: 1diff --git a/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_call_with_tools_delegates.yaml b/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_call_with_tools_delegates.yamlnew file mode 100644index 000000000..5a886ea55--- /dev/null+++ b/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_call_with_tools_delegates.yaml@@ -0,0 +1,137 @@+interactions:+- request:+ body: '{"input":[{"role":"user","content":"What is 2 + 2? Be brief."}],"model":"gpt-5.2-chat","tools":[{"type":"web_search_preview"}]}'+ headers:+ User-Agent:+ - X-USER-AGENT-XXX+ accept:+ - application/json+ accept-encoding:+ - ACCEPT-ENCODING-XXX+ authorization:+ - AUTHORIZATION-XXX+ connection:+ - keep-alive+ content-length:+ - '127'+ content-type:+ - application/json+ host:+ - kkarmakar-ai-eus2.openai.azure.com+ x-stainless-arch:+ - X-STAINLESS-ARCH-XXX+ x-stainless-async:+ - 'false'+ x-stainless-lang:+ - python+ x-stainless-os:+ - X-STAINLESS-OS-XXX+ x-stainless-package-version:+ - 2.32.0+ x-stainless-read-timeout:+ - X-STAINLESS-READ-TIMEOUT-XXX+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.13.12+ method: POST+ uri: https://fake-azure-endpoint.openai.azure.com/openai/v1/responses+ response:+ body:+ string: "{\n \"id\": \"resp_0d80ad9adad65fca0069f23d0c904c8194862acae4bd866cf5\",\n+ \ \"object\": \"response\",\n \"created_at\": 1777483020,\n \"status\":+ \"completed\",\n \"background\": false,\n \"completed_at\": 1777483022,\n+ \ \"content_filters\": [\n {\n \"blocked\": false,\n \"source_type\":+ \"prompt\",\n \"content_filter_raw\": [],\n \"content_filter_results\":+ {\n \"jailbreak\": {\n \"detected\": false,\n \"filtered\":+ false\n },\n \"hate\": {\n \"filtered\": false,\n \"severity\":+ \"safe\"\n },\n \"sexual\": {\n \"filtered\": false,\n+ \ \"severity\": \"safe\"\n },\n \"violence\": {\n \"filtered\":+ false,\n \"severity\": \"safe\"\n },\n \"self_harm\":+ {\n \"filtered\": false,\n \"severity\": \"safe\"\n }\n+ \ },\n \"content_filter_offsets\": {\n \"start_offset\": 0,\n+ \ \"end_offset\": 19017,\n \"check_offset\": 0\n }\n },\n+ \ {\n \"blocked\": false,\n \"source_type\": \"completion\",\n+ \ \"content_filter_raw\": [],\n \"content_filter_results\": {\n \"hate\":+ {\n \"filtered\": false,\n \"severity\": \"safe\"\n },\n+ \ \"sexual\": {\n \"filtered\": false,\n \"severity\":+ \"safe\"\n },\n \"violence\": {\n \"filtered\": false,\n+ \ \"severity\": \"safe\"\n },\n \"self_harm\": {\n \"filtered\":+ false,\n \"severity\": \"safe\"\n },\n \"protected_material_code\":+ {\n \"detected\": false,\n \"filtered\": false\n },\n+ \ \"protected_material_text\": {\n \"detected\": false,\n \"filtered\":+ false\n }\n },\n \"content_filter_offsets\": {\n \"start_offset\":+ 0,\n \"end_offset\": 889,\n \"check_offset\": 0\n }\n }\n+ \ ],\n \"error\": null,\n \"frequency_penalty\": 0.0,\n \"incomplete_details\":+ null,\n \"instructions\": null,\n \"max_output_tokens\": null,\n \"max_tool_calls\":+ null,\n \"model\": \"gpt-5.2-chat\",\n \"output\": [\n {\n \"id\":+ \"rs_0d80ad9adad65fca0069f23d0d8b8c8194b1a9ab61ddc3420d\",\n \"type\":+ \"reasoning\",\n \"summary\": []\n },\n {\n \"id\": \"msg_0d80ad9adad65fca0069f23d0e262081949c36d6cc1958eeed\",\n+ \ \"type\": \"message\",\n \"status\": \"completed\",\n \"content\":+ [\n {\n \"type\": \"output_text\",\n \"annotations\":+ [],\n \"logprobs\": [],\n \"text\": \"2 + 2 = 4.\"\n }\n+ \ ],\n \"role\": \"assistant\"\n }\n ],\n \"parallel_tool_calls\":+ true,\n \"presence_penalty\": 0.0,\n \"previous_response_id\": null,\n \"prompt_cache_key\":+ null,\n \"prompt_cache_retention\": null,\n \"reasoning\": {\n \"effort\":+ \"medium\",\n \"summary\": null\n },\n \"safety_identifier\": null,\n+ \ \"service_tier\": \"default\",\n \"store\": true,\n \"temperature\": 1.0,\n+ \ \"text\": {\n \"format\": {\n \"type\": \"text\"\n },\n \"verbosity\":+ \"medium\"\n },\n \"tool_choice\": \"auto\",\n \"tools\": [\n {\n \"type\":+ \"web_search_preview\",\n \"search_content_types\": [\n \"text\"\n+ \ ],\n \"search_context_size\": \"medium\",\n \"user_location\":+ {\n \"type\": \"approximate\",\n \"city\": null,\n \"country\":+ \"US\",\n \"region\": null,\n \"timezone\": null\n }\n+ \ }\n ],\n \"top_logprobs\": 0,\n \"top_p\": 0.85,\n \"truncation\":+ \"disabled\",\n \"usage\": {\n \"input_tokens\": 4312,\n \"input_tokens_details\":+ {\n \"cached_tokens\": 0\n },\n \"output_tokens\": 28,\n \"output_tokens_details\":+ {\n \"reasoning_tokens\": 0\n },\n \"total_tokens\": 4340\n },\n+ \ \"user\": null,\n \"metadata\": {}\n}"+ headers:+ Content-Length:+ - '3507'+ Content-Type:+ - application/json+ Date:+ - Wed, 29 Apr 2026 17:17:03 GMT+ Strict-Transport-Security:+ - STS-XXX+ apim-request-id:+ - APIM-REQUEST-ID-XXX+ skip-error-remapping:+ - 'true'+ x-content-type-options:+ - X-CONTENT-TYPE-XXX+ x-ms-client-request-id:+ - X-MS-CLIENT-REQUEST-ID-XXX+ x-ms-is-spilled-over:+ - 'false'+ x-ms-region:+ - X-MS-REGION-XXX+ x-ratelimit-abusepenalty-active:+ - 'False'+ x-ratelimit-key:+ - gpt-5.2-chat+ x-ratelimit-limit-requests:+ - X-RATELIMIT-LIMIT-REQUESTS-XXX+ x-ratelimit-limit-tokens:+ - X-RATELIMIT-LIMIT-TOKENS-XXX+ x-ratelimit-remaining-requests:+ - X-RATELIMIT-REMAINING-REQUESTS-XXX+ x-ratelimit-remaining-tokens:+ - X-RATELIMIT-REMAINING-TOKENS-XXX+ x-ratelimit-renewalperiod-requests:+ - '60'+ x-ratelimit-renewalperiod-tokens:+ - '60'+ x-ratelimit-reset-requests:+ - X-RATELIMIT-RESET-REQUESTS-XXX+ x-ratelimit-reset-tokens:+ - X-RATELIMIT-RESET-TOKENS-XXX+ x-request-id:+ - X-REQUEST-ID-XXX+ status:+ code: 200+ message: OK+version: 1diff --git a/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_completions_call_unchanged.yaml b/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_completions_call_unchanged.yamlnew file mode 100644index 000000000..3c4fc8675--- /dev/null+++ b/lib/crewai/tests/cassettes/llms/azure/TestAzureResponsesCall.test_completions_call_unchanged.yaml@@ -0,0 +1,84 @@+interactions:+- request:+ body: '{"messages": [{"role": "user", "content": "Say hello in one sentence."}],+ "stream": false}'+ headers:+ Accept:+ - application/json+ Connection:+ - keep-alive+ Content-Length:+ - '90'+ Content-Type:+ - application/json+ User-Agent:+ - X-USER-AGENT-XXX+ accept-encoding:+ - ACCEPT-ENCODING-XXX+ api-key:+ - X-API-KEY-XXX+ authorization:+ - AUTHORIZATION-XXX+ x-ms-client-request-id:+ - X-MS-CLIENT-REQUEST-ID-XXX+ method: POST+ uri: https://fake-azure-endpoint.openai.azure.com/openai/deployments/gpt-5.2-chat/chat/completions?api-version=2024-02-15-preview+ response:+ body:+ string: "{\"choices\":[{\"content_filter_results\":{\"hate\":{\"filtered\":false,\"severity\":\"safe\"},\"protected_material_code\":{\"detected\":false,\"filtered\":false},\"protected_material_text\":{\"detected\":false,\"filtered\":false},\"self_harm\":{\"filtered\":false,\"severity\":\"safe\"},\"sexual\":{\"filtered\":false,\"severity\":\"safe\"},\"violence\":{\"filtered\":false,\"severity\":\"safe\"}},\"finish_reason\":\"stop\",\"index\":0,\"logprobs\":null,\"message\":{\"annotations\":[],\"content\":\"Hello!+ \U0001F60A\",\"refusal\":null,\"role\":\"assistant\"}}],\"created\":1777483024,\"id\":\"chatcmpl-Da2oyIDHFopG5fmCKbhDiEYG5ciBN\",\"model\":\"gpt-5.2-chat-latest\",\"object\":\"chat.completion\",\"prompt_filter_results\":[{\"prompt_index\":0,\"content_filter_results\":{\"hate\":{\"filtered\":false,\"severity\":\"safe\"},\"jailbreak\":{\"detected\":false,\"filtered\":false},\"self_harm\":{\"filtered\":false,\"severity\":\"safe\"},\"sexual\":{\"filtered\":false,\"severity\":\"safe\"},\"violence\":{\"filtered\":false,\"severity\":\"safe\"}}}],\"service_tier\":\"default\",\"system_fingerprint\":null,\"usage\":{\"completion_tokens\":13,\"completion_tokens_details\":{\"accepted_prediction_tokens\":0,\"audio_tokens\":0,\"reasoning_tokens\":0,\"rejected_prediction_tokens\":0},\"prompt_tokens\":12,\"prompt_tokens_details\":{\"audio_tokens\":0,\"cached_tokens\":0},\"total_tokens\":25}}\n"+ headers:+ Content-Length:+ - '1233'+ Content-Type:+ - application/json+ Date:+ - Wed, 29 Apr 2026 17:17:05 GMT+ Strict-Transport-Security:+ - STS-XXX+ apim-request-id:+ - APIM-REQUEST-ID-XXX+ azureml-model-session:+ - AZUREML-MODEL-SESSION-XXX+ skip-error-remapping:+ - 'true'+ x-accel-buffering:+ - 'no'+ x-content-type-options:+ - X-CONTENT-TYPE-XXX+ x-ms-client-request-id:+ - X-MS-CLIENT-REQUEST-ID-XXX+ x-ms-deployment-name:+ - gpt-5.2-chat+ x-ms-is-spilled-over:+ - 'false'+ x-ms-rai-invoked:+ - 'true'+ x-ms-region:+ - X-MS-REGION-XXX+ x-ratelimit-abusepenalty-active:+ - 'False'+ x-ratelimit-key:+ - gpt-5.2-chat+ x-ratelimit-limit-requests:+ - X-RATELIMIT-LIMIT-REQUESTS-XXX+ x-ratelimit-limit-tokens:+ - X-RATELIMIT-LIMIT-TOKENS-XXX+ x-ratelimit-remaining-requests:+ - X-RATELIMIT-REMAINING-REQUESTS-XXX+ x-ratelimit-remaining-tokens:+ - X-RATELIMIT-REMAINING-TOKENS-XXX+ x-ratelimit-renewalperiod-requests:+ - '60'+ x-ratelimit-renewalperiod-tokens:+ - '60'+ x-ratelimit-reset-requests:+ - X-RATELIMIT-RESET-REQUESTS-XXX+ x-ratelimit-reset-tokens:+ - X-RATELIMIT-RESET-TOKENS-XXX+ x-request-id:+ - X-REQUEST-ID-XXX+ status:+ code: 200+ message: OK+version: 1diff --git a/lib/crewai/tests/cassettes/llms/azure/test_acall_delegates_to_responses.yaml b/lib/crewai/tests/cassettes/llms/azure/test_acall_delegates_to_responses.yamlnew file mode 100644index 000000000..205bb3dab--- /dev/null+++ b/lib/crewai/tests/cassettes/llms/azure/test_acall_delegates_to_responses.yaml@@ -0,0 +1,128 @@+interactions:+- request:+ body: '{"input":[{"role":"user","content":"Say hello in one sentence."}],"model":"gpt-5.2-chat"}'+ headers:+ User-Agent:+ - X-USER-AGENT-XXX+ accept:+ - application/json+ accept-encoding:+ - ACCEPT-ENCODING-XXX+ authorization:+ - AUTHORIZATION-XXX+ connection:+ - keep-alive+ content-length:+ - '89'+ content-type:+ - application/json+ host:+ - kkarmakar-ai-eus2.openai.azure.com+ x-stainless-arch:+ - X-STAINLESS-ARCH-XXX+ x-stainless-async:+ - async:asyncio+ x-stainless-lang:+ - python+ x-stainless-os:+ - X-STAINLESS-OS-XXX+ x-stainless-package-version:+ - 2.32.0+ x-stainless-read-timeout:+ - X-STAINLESS-READ-TIMEOUT-XXX+ x-stainless-retry-count:+ - '0'+ x-stainless-runtime:+ - CPython+ x-stainless-runtime-version:+ - 3.13.12+ method: POST+ uri: https://fake-azure-endpoint.openai.azure.com/openai/v1/responses+ response:+ body:+ string: "{\n \"id\": \"resp_02861ec017218a520069f23d21dbf88193aa91a73d63d91302\",\n+ \ \"object\": \"response\",\n \"created_at\": 1777483041,\n \"status\":+ \"completed\",\n \"background\": false,\n \"completed_at\": 1777483043,\n+ \ \"content_filters\": [\n {\n \"blocked\": false,\n \"source_type\":+ \"prompt\",\n \"content_filter_raw\": [],\n \"content_filter_results\":+ {\n \"jailbreak\": {\n \"detected\": false,\n \"filtered\":+ false\n }\n },\n \"content_filter_offsets\": {\n \"start_offset\":+ 0,\n \"end_offset\": 368,\n \"check_offset\": 0\n }\n },\n+ \ {\n \"blocked\": false,\n \"source_type\": \"completion\",\n+ \ \"content_filter_raw\": [],\n \"content_filter_results\": {\n \"protected_material_text\":+ {\n \"detected\": false,\n \"filtered\": false\n },\n+ \ \"protected_material_code\": {\n \"detected\": false,\n \"filtered\":+ false\n },\n \"hate\": {\n \"filtered\": false,\n \"severity\":+ \"safe\"\n },\n \"sexual\": {\n \"filtered\": false,\n+ \ \"severity\": \"safe\"\n },\n \"violence\": {\n \"filtered\":+ false,\n \"severity\": \"safe\"\n },\n \"self_harm\":+ {\n \"filtered\": false,\n \"severity\": \"safe\"\n }\n+ \ },\n \"content_filter_offsets\": {\n \"start_offset\": 0,\n+ \ \"end_offset\": 44,\n \"check_offset\": 0\n }\n }\n+ \ ],\n \"error\": null,\n \"frequency_penalty\": 0.0,\n \"incomplete_details\":+ null,\n \"instructions\": null,\n \"max_output_tokens\": null,\n \"max_tool_calls\":+ null,\n \"model\": \"gpt-5.2-chat\",\n \"output\": [\n {\n \"id\":+ \"rs_02861ec017218a520069f23d2287ac819399dd23b8dd56028e\",\n \"type\":+ \"reasoning\",\n \"summary\": []\n },\n {\n \"id\": \"msg_02861ec017218a520069f23d23082c81939838ab2eebf4e89c\",\n+ \ \"type\": \"message\",\n \"status\": \"completed\",\n \"content\":+ [\n {\n \"type\": \"output_text\",\n \"annotations\":+ [],\n \"logprobs\": [],\n \"text\": \"Hello! \\ud83d\\udc4b\"\n+ \ }\n ],\n \"role\": \"assistant\"\n }\n ],\n \"parallel_tool_calls\":+ true,\n \"presence_penalty\": 0.0,\n \"previous_response_id\": null,\n \"prompt_cache_key\":+ null,\n \"prompt_cache_retention\": null,\n \"reasoning\": {\n \"effort\":+ \"medium\",\n \"summary\": null\n },\n \"safety_identifier\": null,\n+ \ \"service_tier\": \"default\",\n \"store\": true,\n \"temperature\": 1.0,\n+ \ \"text\": {\n \"format\": {\n \"type\": \"text\"\n },\n \"verbosity\":+ \"medium\"\n },\n \"tool_choice\": \"auto\",\n \"tools\": [],\n \"top_logprobs\":+ 0,\n \"top_p\": 0.85,\n \"truncation\": \"disabled\",\n \"usage\": {\n+ \ \"input_tokens\": 12,\n \"input_tokens_details\": {\n \"cached_tokens\":+ 0\n },\n \"output_tokens\": 21,\n \"output_tokens_details\": {\n+ \ \"reasoning_tokens\": 0\n },\n \"total_tokens\": 33\n },\n \"user\":+ null,\n \"metadata\": {}\n}"+ headers:+ Content-Length:+ - '2844'+ Content-Type:+ - application/json+ Date:+ - Wed, 29 Apr 2026 17:17:25 GMT+ Strict-Transport-Security:+ - STS-XXX+ apim-request-id:+ - APIM-REQUEST-ID-XXX+ skip-error-remapping:+ - 'true'+ x-content-type-options:+ - X-CONTENT-TYPE-XXX+ x-ms-client-request-id:+ - X-MS-CLIENT-REQUEST-ID-XXX+ x-ms-is-spilled-over:+ - 'false'+ x-ms-region:+ - X-MS-REGION-XXX+ x-ratelimit-abusepenalty-active:+ - 'False'+ x-ratelimit-key:+ - gpt-5.2-chat+ x-ratelimit-limit-requests:+ - X-RATELIMIT-LIMIT-REQUESTS-XXX+ x-ratelimit-limit-tokens:+ - X-RATELIMIT-LIMIT-TOKENS-XXX+ x-ratelimit-remaining-requests:+ - X-RATELIMIT-REMAINING-REQUESTS-XXX+ x-ratelimit-remaining-tokens:+ - X-RATELIMIT-REMAINING-TOKENS-XXX+ x-ratelimit-renewalperiod-requests:+ - '60'+ x-ratelimit-renewalperiod-tokens:+ - '60'+ x-ratelimit-reset-requests:+ - X-RATELIMIT-RESET-REQUESTS-XXX+ x-ratelimit-reset-tokens:+ - X-RATELIMIT-RESET-TOKENS-XXX+ x-request-id:+ - X-REQUEST-ID-XXX+ status:+ code: 200+ message: OK+version: 1diff --git a/lib/crewai/tests/llms/azure/test_azure_responses.py b/lib/crewai/tests/llms/azure/test_azure_responses.pynew file mode 100644index 000000000..765dbb40b--- /dev/null+++ b/lib/crewai/tests/llms/azure/test_azure_responses.py@@ -0,0 +1,395 @@+"""Tests for Azure OpenAI Responses API support.++Verifies that AzureCompletion with api='responses' correctly delegates+to OpenAICompletion configured with the Azure OpenAI /openai/v1/ base URL.+"""++import os+from unittest.mock import AsyncMock, MagicMock, patch++import pytest+++# ---------------------------------------------------------------------------+# Fixtures+# ---------------------------------------------------------------------------+++def azure_env():+ """Set Azure environment variables for tests."""+ with patch.dict(+ os.environ,+ {+ "AZURE_API_KEY": "test-azure-key",+ "AZURE_ENDPOINT": "https://myresource.openai.azure.com",+ },+ ):+ yield+++def mock_openai_completion():+ """Mock OpenAICompletion to avoid real client creation.++ Patches at the source module so that the dynamic import inside+ _init_responses_delegate picks up the mock.+ """+ instance = MagicMock()+ instance.call = MagicMock(return_value="responses-result")+ instance.acall = AsyncMock(return_value="async-responses-result")+ instance.last_response_id = "resp_abc123"+ instance.last_reasoning_items = [{"type": "reasoning"}]+ instance.reset_chain = MagicMock()+ instance.reset_reasoning_chain = MagicMock()+ mock_cls = MagicMock(return_value=instance)++ with patch(+ "crewai.llms.providers.openai.completion.OpenAICompletion",+ mock_cls,+ ):+ yield mock_cls, instance+++# ---------------------------------------------------------------------------+# Helper to build AzureCompletion with api="responses" while mocking imports+# ---------------------------------------------------------------------------+++def _create_azure_responses(**overrides):+ """Create an AzureCompletion(api='responses').++ Must be called inside a context where OpenAICompletion is already mocked+ (i.e. via the ``mock_openai_completion`` fixture).+ """+ from crewai.llms.providers.azure.completion import AzureCompletion++ defaults = {+ "model": "gpt-4o",+ "api_key": "test-azure-key",+ "endpoint": "https://myresource.openai.azure.com",+ "api": "responses",+ }+ defaults.update(overrides)+ return AzureCompletion(**defaults)+++# ---------------------------------------------------------------------------+# Initialization tests+# ---------------------------------------------------------------------------+++class TestAzureResponsesInit:+ """Test initialization with api='responses'."""++ def test_default_api_is_completions(self):+ """Default api should be 'completions' (existing behaviour)."""+ from crewai.llms.providers.azure.completion import AzureCompletion++ comp = AzureCompletion(+ model="gpt-4o",+ api_key="key",+ endpoint="https://res.openai.azure.com",+ )+ assert comp.api == "completions"+ assert comp._responses_delegate is None++ def test_responses_api_creates_delegate(self, mock_openai_completion):+ mock_cls, instance = mock_openai_completion+ comp = _create_azure_responses()++ assert comp.api == "responses"+ assert comp._responses_delegate is instance+ mock_cls.assert_called_once()++ def test_completions_clients_not_created_in_responses_mode(+ self, mock_openai_completion+ ):+ """When api='responses', azure-ai-inference clients should not be created."""+ _mock_cls, _ = mock_openai_completion+ comp = _create_azure_responses()++ assert comp._client is None+ assert comp._async_client is None++ def test_responses_base_url_from_base_endpoint(self, mock_openai_completion):+ mock_cls, _ = mock_openai_completion+ _create_azure_responses(+ endpoint="https://myresource.openai.azure.com",+ )+ call_kwargs = mock_cls.call_args[1]+ assert (+ call_kwargs["base_url"] == "https://myresource.openai.azure.com/openai/v1/"+ )++ def test_responses_base_url_strips_deployment_path(self, mock_openai_completion):+ """Endpoint with /openai/deployments/... should still produce correct base_url."""+ mock_cls, _ = mock_openai_completion+ _create_azure_responses(+ endpoint="https://myresource.openai.azure.com/openai/deployments/gpt-4o",+ )+ call_kwargs = mock_cls.call_args[1]+ assert (+ call_kwargs["base_url"] == "https://myresource.openai.azure.com/openai/v1/"+ )++ def test_responses_base_url_preserves_port(self, mock_openai_completion):+ mock_cls, _ = mock_openai_completion+ _create_azure_responses(+ endpoint="https://myresource.openai.azure.com:8443/openai/deployments/gpt-4o",+ )+ call_kwargs = mock_cls.call_args[1]+ assert (+ call_kwargs["base_url"]+ == "https://myresource.openai.azure.com:8443/openai/v1/"+ )++ def test_delegate_receives_model_and_api_key(self, mock_openai_completion):+ mock_cls, _ = mock_openai_completion+ _create_azure_responses(+ model="gpt-4o",+ api_key="my-key",+ )+ call_kwargs = mock_cls.call_args[1]+ assert call_kwargs["model"] == "gpt-4o"+ assert call_kwargs["api_key"] == "my-key"+ assert call_kwargs["api"] == "responses"+ assert call_kwargs["provider"] == "openai"++ def test_delegate_receives_optional_params(self, mock_openai_completion):+ mock_cls, _ = mock_openai_completion+ _create_azure_responses(+ temperature=0.5,+ top_p=0.9,+ max_tokens=1000,+ max_completion_tokens=800,+ reasoning_effort="medium",+ instructions="Be helpful",+ store=True,+ previous_response_id="resp_prev",+ include=["reasoning.encrypted_content"],+ builtin_tools=["web_search"],+ parse_tool_outputs=True,+ auto_chain=True,+ auto_chain_reasoning=True,+ stream=True,+ )+ call_kwargs = mock_cls.call_args[1]+ assert call_kwargs["temperature"] == 0.5+ assert call_kwargs["top_p"] == 0.9+ assert call_kwargs["max_tokens"] == 1000+ assert call_kwargs["max_completion_tokens"] == 800+ assert call_kwargs["reasoning_effort"] == "medium"+ assert call_kwargs["instructions"] == "Be helpful"+ assert call_kwargs["store"] is True+ assert call_kwargs["previous_response_id"] == "resp_prev"+ assert call_kwargs["include"] == ["reasoning.encrypted_content"]+ assert call_kwargs["builtin_tools"] == ["web_search"]+ assert call_kwargs["parse_tool_outputs"] is True+ assert call_kwargs["auto_chain"] is True+ assert call_kwargs["auto_chain_reasoning"] is True+ assert call_kwargs["stream"] is True++ def test_delegate_omits_unset_optional_params(self, mock_openai_completion):+ """Params left at defaults should not be passed to the delegate."""+ mock_cls, _ = mock_openai_completion+ _create_azure_responses()+ call_kwargs = mock_cls.call_args[1]+ # These should NOT be in kwargs because they were not set+ assert "temperature" not in call_kwargs+ assert "reasoning_effort" not in call_kwargs+ assert "instructions" not in call_kwargs+ assert "store" not in call_kwargs+ assert "max_completion_tokens" not in call_kwargs+++# ---------------------------------------------------------------------------+# Call delegation tests (VCR cassette-based)+# ---------------------------------------------------------------------------+++class TestAzureResponsesCall:+ """Test call / acall delegation to the Responses API using VCR cassettes."""++ @pytest.mark.vcr()+ def test_call_delegates_to_responses(self):+ from crewai.llm import LLM++ llm = LLM(model="azure/gpt-5.2-chat", api="responses")+ result = llm.call("Say hello in one sentence.")++ assert isinstance(result, str)+ assert len(result) > 0++ @pytest.mark.vcr()+ def test_call_with_tools_delegates(self):+ from crewai.llm import LLM++ llm = LLM(+ model="azure/gpt-5.2-chat",+ api="responses",+ builtin_tools=["web_search"],+ )+ result = llm.call("What is 2 + 2? Be brief.")++ assert isinstance(result, str)+ assert len(result) > 0++ @pytest.mark.vcr()+ def test_completions_call_unchanged(self):+ """Default api='completions' should not use the responses delegate."""+ from crewai.llm import LLM++ llm = LLM(model="azure/gpt-5.2-chat")+ result = llm.call("Say hello in one sentence.")++ assert isinstance(result, str)+ assert len(result) > 0+++# ---------------------------------------------------------------------------+# Delegated property & method tests+# ---------------------------------------------------------------------------+++class TestAzureResponsesProperties:+ """Test properties and methods delegated to the responses delegate."""++ def test_last_response_id(self, mock_openai_completion):+ _mock_cls, _ = mock_openai_completion+ comp = _create_azure_responses()+ assert comp.last_response_id == "resp_abc123"++ def test_last_response_id_none_for_completions(self):+ from crewai.llms.providers.azure.completion import AzureCompletion++ comp = AzureCompletion(+ model="gpt-4o",+ api_key="key",+ endpoint="https://res.openai.azure.com",+ )+ assert comp.last_response_id is None++ def test_last_reasoning_items(self, mock_openai_completion):+ _mock_cls, _ = mock_openai_completion+ comp = _create_azure_responses()+ assert comp.last_reasoning_items == [{"type": "reasoning"}]++ def test_reset_chain(self, mock_openai_completion):+ _mock_cls, instance = mock_openai_completion+ comp = _create_azure_responses()+ comp.reset_chain()+ instance.reset_chain.assert_called_once()++ def test_reset_reasoning_chain(self, mock_openai_completion):+ _mock_cls, instance = mock_openai_completion+ comp = _create_azure_responses()+ comp.reset_reasoning_chain()+ instance.reset_reasoning_chain.assert_called_once()++ def test_reset_chain_noop_for_completions(self):+ """reset_chain should not raise when delegate is None."""+ from crewai.llms.providers.azure.completion import AzureCompletion++ comp = AzureCompletion(+ model="gpt-4o",+ api_key="key",+ endpoint="https://res.openai.azure.com",+ )+ comp.reset_chain() # should not raise+++# ---------------------------------------------------------------------------+# Feature-support method tests+# ---------------------------------------------------------------------------+++class TestAzureResponsesFeatures:+ """Test supports_* and config methods."""++ def test_supports_function_calling_responses(self, mock_openai_completion):+ _mock_cls, _ = mock_openai_completion+ comp = _create_azure_responses()+ assert comp.supports_function_calling() is True++ def test_supports_function_calling_completions_openai_model(self):+ from crewai.llms.providers.azure.completion import AzureCompletion++ comp = AzureCompletion(+ model="gpt-4o",+ api_key="key",+ endpoint="https://res.openai.azure.com",+ )+ assert comp.supports_function_calling() is True++ def test_supports_stop_words_false_for_responses(self, mock_openai_completion):+ _mock_cls, _ = mock_openai_completion+ comp = _create_azure_responses(model="o4-mini")+ assert comp.supports_stop_words() is False++ def test_supports_stop_words_true_for_completions_gpt4(self):+ from crewai.llms.providers.azure.completion import AzureCompletion++ comp = AzureCompletion(+ model="gpt-4o",+ api_key="key",+ endpoint="https://res.openai.azure.com",+ )+ assert comp.supports_stop_words() is True++ def test_to_config_dict_includes_responses_fields(self, mock_openai_completion):+ _mock_cls, _ = mock_openai_completion+ comp = _create_azure_responses(+ reasoning_effort="high",+ instructions="Be concise",+ store=True,+ max_completion_tokens=500,+ )+ config = comp.to_config_dict()+ assert config["api"] == "responses"+ assert config["reasoning_effort"] == "high"+ assert config["instructions"] == "Be concise"+ assert config["store"] is True+ assert config["max_completion_tokens"] == 500++ def test_to_config_dict_omits_api_for_completions(self):+ from crewai.llms.providers.azure.completion import AzureCompletion++ comp = AzureCompletion(+ model="gpt-4o",+ api_key="key",+ endpoint="https://res.openai.azure.com",+ )+ config = comp.to_config_dict()+ assert "api" not in config+++# ---------------------------------------------------------------------------+# LLM factory integration test+# ---------------------------------------------------------------------------+++class TestAzureResponsesViaLLMFactory:+ """Test that the LLM factory passes api='responses' through to AzureCompletion."""++ @pytest.mark.usefixtures("azure_env")+ def test_llm_factory_passes_api_kwarg(self):+ """LLM(model='azure/gpt-4o', api='responses') should create AzureCompletion+ with api='responses' and a delegate."""+ with (+ patch(+ "crewai.llms.providers.openai.completion.OpenAI",+ ),+ patch(+ "crewai.llms.providers.openai.completion.AsyncOpenAI",+ ),+ ):+ from crewai.llm import LLM++ llm = LLM(model="azure/gpt-4o", api="responses")++ from crewai.llms.providers.azure.completion import AzureCompletion++ assert isinstance(llm, AzureCompletion)+ assert llm.api == "responses"+ assert llm._responses_delegate is not Nonediff --git a/lib/crewai/tests/llms/azure/test_azure_responses_async.py b/lib/crewai/tests/llms/azure/test_azure_responses_async.pynew file mode 100644index 000000000..934b5fe0a--- /dev/null+++ b/lib/crewai/tests/llms/azure/test_azure_responses_async.py@@ -0,0 +1,15 @@+"""Async tests for Azure OpenAI Responses API support."""++import pytest+++async def test_acall_delegates_to_responses():+ from crewai.llm import LLM++ llm = LLM(model="azure/gpt-5.2-chat", api="responses")+ result = await llm.acall("Say hello in one sentence.")++ assert isinstance(result, str)+ assert len(result) > 0