{"id":23324,"library":"azure-ai-agentserver-agentframework","title":"Azure AI Agent Server Agent Framework","description":"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.","status":"active","version":"1.0.0b17","language":"python","source_language":"en","source_url":"https://github.com/Azure/azure-sdk-for-python","tags":["azure","ai","agent","framework"],"install":[{"cmd":"pip install azure-ai-agentserver-agentframework","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for authentication with Azure","package":"azure-identity","optional":true}],"imports":[{"note":"Use dot notation, not underscores in package name","wrong":"from azure_ai_agentserver_agentframework import AgentFrameworkClient","symbol":"AgentFrameworkClient","correct":"from azure.ai.agentserver.agentframework import AgentFrameworkClient"},{"note":"Subpackage omitted in wrong import","wrong":"from azure.ai.agentserver import AgentFrameworkConfig","symbol":"AgentFrameworkConfig","correct":"from azure.ai.agentserver.agentframework import AgentFrameworkConfig"}],"quickstart":{"code":"import os\nfrom azure.ai.agentserver.agentframework import AgentFrameworkClient\nfrom azure.identity import DefaultAzureCredential\n\ncredential = DefaultAzureCredential()\nclient = AgentFrameworkClient(\n    endpoint=os.environ.get('AZURE_AI_AGENT_ENDPOINT', ''),\n    credential=credential\n)\nprint('Client initialized successfully')","lang":"python","description":"Initialize the agent framework client with Azure credentials and endpoint."},"warnings":[{"fix":"Use `pip install azure-ai-agentserver-agentframework==1.0.0b17`","message":"Beta versions may have breaking changes between releases. Pin to exact version in production.","severity":"breaking","affected_versions":">=1.0.0b1"},{"fix":"Import as `from azure.ai.agentserver.agentframework import ...`","message":"The package name contains hyphens but the import path uses dots. Common mistake is to replace hyphens with underscores.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace legacy credential patterns with `DefaultAzureCredential`","message":"Some authentication methods may be deprecated. Use DefaultAzureCredential from azure-identity.","severity":"deprecated","affected_versions":">=1.0.0b10"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `from azure.ai.agentserver.agentframework import AgentFrameworkClient`","cause":"Incorrect import path using underscores instead of dots","error":"ImportError: cannot import name 'AgentFrameworkClient' from 'azure_ai_agentserver_agentframework'"},{"fix":"Ensure AZURE_AI_AGENT_ENDPOINT environment variable is set and credential has permissions.","cause":"Missing or invalid Azure credential or endpoint","error":"azure.core.exceptions.HttpResponseError: (AuthenticationFailed) Authentication failed."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}