Unified-Agent-Framework
遵循微软官方规范的Python AI智能体开发框架。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Unified-Agent-Framework。 它的用途是:遵循微软官方规范的Python AI智能体开发框架。 完整的 Skill 内容见:https://321skill.com/skills/unified-agent-framework/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我开发一个能查询天气和做简单计算的智能体。”,它会引导你使用 `@tool` 装饰器定义 `get_weather` 和 `calculate` 函数,然后创建 `Agent` 实例并注入OpenAI客户端,最后通过 `agent.run()` 让智能体处理用户关于“北京天气和123+456等于多少”的复杂查询。
介绍
Unified Agent Framework v6 解决了AI智能体开发中框架各异、标准不一的问题,它严格遵循 Microsoft Agent Framework 1.0.0-rc1 的官方API规范,为开发者提供了一个统一、标准化的开发体验。
使用方式非常直观:通过 Agent 类作为核心入口,注入 ChatClient 连接大模型,使用 @tool 装饰器轻松将普通函数转化为AI可调用的工具,并通过 agent.run() 方法执行任务。框架内置了会话管理、多智能体协作、中间件管道和分布式追踪等高级功能。
它非常适合需要构建标准化、可维护、功能复杂的AI智能体的开发者,尤其是那些希望与微软生态对齐或需要将智能体能力模块化集成的团队。
建议在开始前先熟悉微软Agent Framework的基本概念。由于框架较新,在生产环境中大规模应用前,建议进行充分的测试和评估。
核心特点
这是市面上少数严格遵循并兼容 Microsoft Agent Framework 1.0.0-rc1 官方规范的Python框架,确保了与微软生态的互操作性和未来的兼容性。其核心设计围绕 `Agent` 类,提供了从工具自动转换、多智能体协作到生产级可观测性(OpenTelemetry)的一体化解决方案,而非简单的LLM调用封装。
注意事项
对于仅需简单、一次性LLM调用或快速原型验证的极简场景,本框架可能显得过于重型。
常见问题
和直接调用OpenAI API有什么区别?
它提供了完整的智能体开发生命周期管理,包括工具调用循环、会话历史、多智能体编排和可观测性,远超简单的API调用。
必须使用微软的模型吗?
不需要,框架通过 `ChatClient` 抽象层支持 OpenAI、Azure OpenAI 等多种LLM提供商,可自由切换。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/unified-agent-framework/raw/index.md 读取 Unified-Agent-Framework 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/unified-agent-framework/raw/index.md(查看排版版本)