Azure-Samples/python-ai-agent-frameworks-demos

它解决的问题

开发人员常常难以比较和选择众多Python AI代理框架。此仓库为几个流行的框架提供了可直接运行的示例，所有这些示例都连接到Azure OpenAI模型（或替代方案，如OpenAI.com和本地Ollama）。它消除了为每个框架设置环境的猜测，并展示了如何使用常见模式，如工具调用、监督代理和MCP服务器。

工作原理

该项目在examples目录中包含一组Python脚本。每个脚本展示不同的框架或代理模式。这些示例旨在准备好的环境中运行：您可以在GitHub Codespaces中打开仓库（默认设置使用Azure OpenAI，可选的Ollama设置预安装本地模型），使用VS Code Dev Containers，或使用uv设置本地Python环境。所有脚本从.env文件读取模型连接详细信息。README解释了如何配置三个模型提供商：Azure OpenAI（使用Azure Developer CLI来配置资源）、OpenAI.com（只需设置您的API密钥和模型）或Ollama（本地服务器）。配置完成后，您可以直接运行任何示例脚本，每个脚本演示特定功能：基本代理、带有一个或多个工具的代理、监督子代理的监督者、基于工作流的代理、基于图的状态机、函数调用以及与MCP服务器的外部工具集成。

适用对象

希望在承诺使用一个AI代理框架之前获得实用、并排示例的Python开发人员。它也对已经使用Azure OpenAI并希望探索不同代理模式或评估Microsoft Agent Framework、LangChain v1 + LangGraph、OpenAI Agents、PydanticAI和LlamaIndex等框架如何处理类似任务的团队有用。

亮点

• 涵盖六个主要的Python代理生态系统：Microsoft Agent Framework、LangChain v1 + LangGraph、OpenAI Function Calling和OpenAI Agents、PydanticAI和LlamaIndex。
• 示例脚本说明常见代理模式：基本代理、使用工具的代理、多工具规划器、监督者编排、工作流图和MCP（模型上下文协议）集成。
• 通过更改环境变量，针对Azure OpenAI、OpenAI.com或本地Ollama服务器运行相同示例。
• 当您选择Azure路径时，基础设施即代码脚本自动配置Azure OpenAI资源（通过Azure Developer CLI）。
• 提供多种快速入门路线：使用默认或Ollama容器的GitHub Codespaces、VS Code Dev Containers或基于uv的本地设置。