用途:使用 Microsoft Agent Framework Python SDK 在 Azure AI Foundry 上构建持久化智能体(Agent)。架构上由用户查询经 AzureAIAgentsProvider 接入 Azure AI Agent Service,通过 Agent.run()/run_stream() 执行,可挂载函数工具、托管工具(代码解释器/文件搜索/Web 搜索)与 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。
主要能力:创建/获取智能体、函数工具、托管工具、流式响应、会话线程持久化、结构化输出(Pydantic response_format)、Agent Skills 模块化能力按需加载、Foundry 托管记忆(用户画像与上下文记忆)、以及评测与红队测试(FoundryEvals、RedTeam、自反思)。
认证:优先使用 DefaultAzureCredential,本地开发可直接用;生产设置 AZURE_TOKEN_CREDENTIALS=prod。客户端需用上下文管理器(with / async with)确保释放。
替代模式:如从 agent_framework.azure 导入 AzureAIAgentsProvider 报 ImportError,可使用 Agent 配合 FoundryChatClient(agent_framework.foundry)的无状态模式。
限制:当前为预览版(--pre),部分接口未导出,API 可能变动;记忆功能需为调用身份授予相应角色,否则可能返回 401 或 UnicodeDecodeError;agent-framework 1.0.0rc3 的 evaluate_agent 暂不建议使用 GROUNDEDNESS。完整对比与设置细节参见技能内参考文档。