用途:在 Azure AI Foundry 上使用 Microsoft Agent Framework Python SDK 构建持久化智能体。架构为:用户查询 → AzureAIAgentsProvider → Azure AI Agent Service(持久化)→ Agent.run()/run_stream() → 工具(函数、托管工具、MCP)→ AgentThread(会话持久化)。
安装:pip install agent-framework --pre,或仅装 Azure 包 pip install agent-framework-azure-ai --pre。需设置环境变量 AZURE_AI_PROJECT_ENDPOINT、AZURE_AI_MODEL_DEPLOYMENT_NAME,Web 搜索另需 BING_CONNECTION_ID。认证使用 azure.identity.aio 的 AzureCliCredential(开发)或 DefaultAzureCredential(生产)。
主要能力:通过 provider.create_agent() 创建智能体,支持函数工具(直接传入函数,参数用 Annotated[type, Field(description=...)] 标注)、托管工具(HostedCodeInterpreterTool、HostedFileSearchTool、HostedWebSearchTool、HostedMCPTool、MCPStreamableHTTPTool)、流式响应 run_stream()、多轮会话线程 get_new_thread() 与 conversation_id 续接、以及基于 Pydantic 模型的结构化输出 response_format。Provider 还提供 get_agent(agent_id) 与 as_agent(sdk_agent)。
使用方式:始终使用 async with 上下文管理器管理 provider 与凭据;多轮对话用 get_new_thread();服务托管 MCP 用 HostedMCPTool,客户端托管用 MCPStreamableHTTPTool。
限制:仅适用于与上述范围明确匹配的任务;输出不能替代针对具体环境的验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。具体收费与价格暂未提供。