Python: [Bug]: cannot import name 'ResponseTextFormatConfigurationJsonObject' from 'azure.ai.projects.models'

[jetiba]

Description

Just importing the AzureAIClient from agent_framework.azure fails with the stacktrace attached.

Code Sample

[project]
name = "sampletest"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
    "agent-framework-azure-ai==1.0.0rc1",
    "opentelemetry-semantic-conventions-ai==0.4.13",
]



from agent_framework.azure import AzureAIClient

def main():
    print("Hello!")


if __name__ == "__main__":
    main()

Error Messages / Stack Traces

Traceback (most recent call last):
  File "/workspace/main.py", line 1, in <module>
    from agent_framework.azure import AzureAIClient
  File "/workspace/.venv/lib/python3.13/site-packages/agent_framework/azure/__init__.py", line 54, in __getattr__
    return getattr(importlib.import_module(import_path), name)
                   ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^
  File "/opt/homebrew/Caskroom/miniconda/base/lib/python3.13/importlib/__init__.py", line 88, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/workspace/.venv/lib/python3.13/site-packages/agent_framework_azure_ai/__init__.py", line 5, in <module>
    from ._agent_provider import AzureAIAgentsProvider
  File "/workspace/.venv/lib/python3.13/site-packages/agent_framework_azure_ai/_agent_provider.py", line 26, in <module>
    from ._chat_client import AzureAIAgentClient, AzureAIAgentOptions
  File "/workspace/.venv/lib/python3.13/site-packages/agent_framework_azure_ai/_chat_client.py", line 93, in <module>
    from ._shared import AzureAISettings, to_azure_ai_agent_tools
  File "/workspace/.venv/lib/python3.13/site-packages/agent_framework_azure_ai/_shared.py", line 18, in <module>
    from azure.ai.projects.models import (
    ...<7 lines>...
    )
ImportError: cannot import name 'ResponseTextFormatConfigurationJsonObject' from 'azure.ai.projects.models' (/workspace/.venv/lib/python3.13/site-packages/azure/ai/projects/models/__init__.py)

Package Versions

agent-framework-azure-ai==1.0.0rc1

Python Version

3.13

Additional Context

No response

[Adisauz]

Root Cause Analysis

After investigating both repositories, I discovered that the agent-framework-azure-ai package is trying to import non-existent classes from the Azure AI Projects SDK.

In agent-framework code:

Looking at agent_framework_azure_ai/_shared.py#L21, it imports:

from azure.ai.projects.models import (
    CodeInterpreterTool,
    MCPTool,
    ResponseTextFormatConfigurationJsonObject,  # ❌ This class doesn't exist
    ResponseTextFormatConfigurationJsonSchema,  # ❌ This class doesn't exist
    ResponseTextFormatConfigurationText,        # ❌ This class doesn't exist
    Tool,
    WebSearchPreviewTool,
)

In Azure SDK code

Checking the Azure SDK for Python source, the actual class names are:

# The actual classes in azure.ai.projects.models:
class TextResponseFormatConfiguration(_Model):
    # Known sub-classes are:
    # - TextResponseFormatConfigurationResponseFormatJsonObject  ✅
    # - TextResponseFormatJsonSchema                              ✅  
    # - TextResponseFormatConfigurationResponseFormatText        ✅

Key Finding

The class names in Azure AI Projects SDK have mostly used the TextResponse prefix, never ResponseTextFormat.

The incorrect ResponseTextFormat names in agent-framework are likely a typo or copy-paste error. This causes an import error for every user trying to use the package, regardless of which Azure SDK version they have installed.

Proposed Fix

I would like to raise a Pull Request to fix these import names in agent_framework_azure_ai/_shared.py

# agent_framework_azure_ai/_shared.py
from azure.ai.projects.models import (
    CodeInterpreterTool,
    MCPTool,
-   ResponseTextFormatConfigurationJsonObject,
-   ResponseTextFormatConfigurationJsonSchema,
-   ResponseTextFormatConfigurationText,
+   TextResponseFormatConfigurationResponseFormatJsonObject,
+   TextResponseFormatJsonSchema,
+   TextResponseFormatConfigurationResponseFormatText,
    Tool,
    WebSearchPreviewTool,
)

Impact

• Current: Package is unusable out-of-the-box for all users
• After fix: Package works correctly with the Azure AI Projects SDK

Can I Raise a PR?

I'd be happy to submit a Pull Request with this fix. Please let me know if:

1. This is the correct approach to fix the issue
2. There are any other files that might need similar fixes
3. There are any specific testing requirements or coding standards I should follow

Links for Reference

• agent-framework source with incorrect imports

• Azure SDK source with correct class names

Looking forward to contributing!

@jetiba @markwallace-microsoft

[eavanvalkenburg]

Please update to rc2