Fix response_format validation for OpenAI-compatible models

- Allow OpenAI provider models to use response_format without validation errors
- Add comprehensive tests for OpenAI-compatible models like qwen-plus
- Ensure non-OpenAI providers still use original validation logic
- Fixes issue #3174 where structured output failed for third-party OpenAI-compatible models

Co-Authored-By: Jo\u00E3o <joao@crewai.com>

docs/en/observability/neatlogs.mdx

@@ -10,8 +10,6 @@ Neatlogs helps you **see what your agent did**, **why**, and **share it**.
 
 It captures every step: thoughts, tool calls, responses, evaluations. No raw logs. Just clear, structured traces. Great for debugging and collaboration.
 
----
-
 ## Why use Neatlogs?
 
 CrewAI agents use multiple tools and reasoning steps. When something goes wrong, you need context — not just errors.
@@ -37,8 +35,6 @@ The best UX to view a CrewAI trace. Post comments anywhere you want. Use AI to d
 ![Ai Chat Bot With A Trace](/images/neatlogs-4.png)
 ![Comments Drawer](/images/neatlogs-5.png)
 
----
-
 ## Core Features
 
 - **Trace Viewer**: Track thoughts, tools, and decisions in sequence
@@ -49,8 +45,6 @@ The best UX to view a CrewAI trace. Post comments anywhere you want. Use AI to d
 - **Ask the Trace (AI)**: Chat with your trace using Neatlogs AI bot
 - **Public Sharing**: Publish trace links to your community
 
----
-
 ## Quick Setup with CrewAI
 
 <Steps>
@@ -61,7 +55,7 @@ The best UX to view a CrewAI trace. Post comments anywhere you want. Use AI to d
     ```bash
     pip install neatlogs
     ```
-    (Latest version 0.8.0, Python 3.8+; MIT license) :contentReference[oaicite:1]{index=1}
+    (Latest version 0.8.0, Python 3.8+; MIT license)
   </Step>
   <Step title="Initialize Neatlogs">
     Before starting Crew agents, add:
@@ -76,18 +70,18 @@ The best UX to view a CrewAI trace. Post comments anywhere you want. Use AI to d
   </Step>
 </Steps>
 
----
+
 
 ## Under the Hood
 
 According to GitHub, Neatlogs:
 
-- Captures thoughts, tool calls, responses, errors, and token stats :contentReference[oaicite:2]{index=2}
-- Supports AI-powered task generation and robust evaluation workflows :contentReference[oaicite:3]{index=3}
+- Captures thoughts, tool calls, responses, errors, and token stats
+- Supports AI-powered task generation and robust evaluation workflows
 
 All with just two lines of code.
 
----
+
 
 ## Watch It Work
 
@@ -113,7 +107,7 @@ All with just two lines of code.
   allowFullScreen
 ></iframe>
 
----
+
 
 ## Links & Support
 
@@ -121,9 +115,9 @@ All with just two lines of code.
 - 🔐 [Dashboard & API Key](https://app.neatlogs.com/)
 - 🐦 [Follow on Twitter](https://twitter.com/neatlogs)
 - 📧 Contact: hello@neatlogs.com
-- 🛠 [GitHub SDK](https://github.com/NeatLogs/neatlogs) :contentReference[oaicite:4]{index=4}
+- 🛠 [GitHub SDK](https://github.com/NeatLogs/neatlogs)
+
 
----
 
 ## TL;DR
 

pyproject.toml

@@ -47,7 +47,7 @@ Documentation = "https://docs.crewai.com"
 Repository = "https://github.com/crewAIInc/crewAI"
 
 [project.optional-dependencies]
-tools = ["crewai-tools~=0.51.0"]
+tools = ["crewai-tools~=0.55.0"]
 embeddings = [
     "tiktoken~=0.8.0"
 ]

src/crewai/__init__.py

@@ -54,7 +54,7 @@ def _track_install_async():
 
 _track_install_async()
 
-__version__ = "0.141.0"
+__version__ = "0.148.0"
 __all__ = [
     "Agent",
     "Crew",

src/crewai/cli/templates/crew/pyproject.toml

@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]>=0.141.0,<1.0.0"
+    "crewai[tools]>=0.148.0,<1.0.0"
 ]
 
 [project.scripts]

src/crewai/cli/templates/flow/pyproject.toml

@@ -5,7 +5,7 @@ description = "{{name}} using crewAI"
 authors = [{ name = "Your Name", email = "you@example.com" }]
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]>=0.141.0,<1.0.0",
+    "crewai[tools]>=0.148.0,<1.0.0",
 ]
 
 [project.scripts]

src/crewai/cli/templates/tool/pyproject.toml

@@ -5,7 +5,7 @@ description = "Power up your crews with {{folder_name}}"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"
 dependencies = [
-    "crewai[tools]>=0.141.0"
+    "crewai[tools]>=0.148.0"
 ]
 
 [tool.crewai]

src/crewai/llm.py

@@ -1090,14 +1090,18 @@ class LLM(BaseLLM):
           - If no slash is present, "openai" is assumed.
         """
         provider = self._get_custom_llm_provider()
-        if self.response_format is not None and not supports_response_schema(
-            model=self.model,
-            custom_llm_provider=provider,
-        ):
-            raise ValueError(
-                f"The model {self.model} does not support response_format for provider '{provider}'. "
-                "Please remove response_format or use a supported model."
-            )
+        if self.response_format is not None:
+            if provider == "openai":
+                return
+            
+            if not supports_response_schema(
+                model=self.model,
+                custom_llm_provider=provider,
+            ):
+                raise ValueError(
+                    f"The model {self.model} does not support response_format for provider '{provider}'. "
+                    "Please remove response_format or use a supported model."
+                )
 
     def supports_function_calling(self) -> bool:
         try:

tests/llm_test.py

@@ -259,6 +259,41 @@ def test_validate_call_params_no_response_format():
     llm._validate_call_params()
 
 
+def test_openai_compatible_models_response_format():
+    """Test that OpenAI-compatible models support response_format without validation errors."""
+    from pydantic import BaseModel
+    
+    class TestResponse(BaseModel):
+        content: str
+    
+    llm = LLM(model="openai/qwen-plus", response_format=TestResponse)
+    llm._validate_call_params()
+    
+    llm = LLM(model="openai/custom-model", response_format=TestResponse)
+    llm._validate_call_params()
+    
+    llm = LLM(model="openai/gpt-4", response_format=TestResponse)
+    llm._validate_call_params()
+
+
+def test_non_openai_providers_still_use_validation():
+    """Test that non-OpenAI providers still use the original validation logic."""
+    from pydantic import BaseModel
+    
+    class TestResponse(BaseModel):
+        content: str
+    
+    with patch("crewai.llm.supports_response_schema", return_value=False):
+        llm = LLM(model="gemini/gemini-1.5-pro", response_format=TestResponse)
+        with pytest.raises(ValueError) as excinfo:
+            llm._validate_call_params()
+        assert "does not support response_format" in str(excinfo.value)
+    
+    with patch("crewai.llm.supports_response_schema", return_value=True):
+        llm = LLM(model="anthropic/claude-3", response_format=TestResponse)
+        llm._validate_call_params()
+
+
 @pytest.mark.vcr(filter_headers=["authorization"], filter_query_parameters=["key"])
 @pytest.mark.parametrize(
     "model",