Azure AI Agent Server Agent Framework

1.0.0b17 verified Fri May 01 auth: no python

Agents server adapter for Azure AI, enabling integration of AI agents with Azure services. Current version 1.0.0b17 (beta), requires Python >=3.10. Release cadence is pre-release with frequent updates.

pip install azure-ai-agentserver-agentframework

Common errors

error ImportError: cannot import name 'AgentFrameworkClient' from 'azure_ai_agentserver_agentframework' ↓

cause Incorrect import path using underscores instead of dots

fix

Use from azure.ai.agentserver.agentframework import AgentFrameworkClient

error azure.core.exceptions.HttpResponseError: (AuthenticationFailed) Authentication failed. ↓

cause Missing or invalid Azure credential or endpoint

fix

Ensure AZURE_AI_AGENT_ENDPOINT environment variable is set and credential has permissions.

Warnings

breaking Beta versions may have breaking changes between releases. Pin to exact version in production. ↓

fix Use `pip install azure-ai-agentserver-agentframework==1.0.0b17`

gotcha The package name contains hyphens but the import path uses dots. Common mistake is to replace hyphens with underscores. ↓

fix Import as `from azure.ai.agentserver.agentframework import ...`

deprecated Some authentication methods may be deprecated. Use DefaultAzureCredential from azure-identity. ↓

fix Replace legacy credential patterns with `DefaultAzureCredential`

Imports

AgentFrameworkClient

wrong

from azure_ai_agentserver_agentframework import AgentFrameworkClient

correct

from azure.ai.agentserver.agentframework import AgentFrameworkClient

Use dot notation, not underscores in package name

AgentFrameworkConfig

wrong

from azure.ai.agentserver import AgentFrameworkConfig

correct

from azure.ai.agentserver.agentframework import AgentFrameworkConfig

Subpackage omitted in wrong import

Quickstart

Initialize the agent framework client with Azure credentials and endpoint.

import os
from azure.ai.agentserver.agentframework import AgentFrameworkClient
from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()
client = AgentFrameworkClient(
    endpoint=os.environ.get('AZURE_AI_AGENT_ENDPOINT', ''),
    credential=credential
)
print('Client initialized successfully')