Microsoft Agent Framework for Go
微软官方开源框架,用 Go 构建生产级 AI Agent 与多智能体工作流,覆盖编排、可观测性与 Foundry 集成。
- Star 数
- ★ 695
- 最近更新
- 今天
- License
- MIT
- 主语言
- Go
- FA 评分
- 82/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- Go 团队需要将单轮对话之外的多智能体编排(顺序、并发、群组协作、条件路由)落地到生产系统
- 不适合
- 需要声明式 Agent、DevUI、AF Labs 或 handoff 编排等尚未在 Go SDK 实现的特性的团队
- 不用 Go 语言的开发团队,应考虑 .NET 或 Python 版 Agent Framework
- 不接受公共预览阶段、需要生产级稳定性承诺的团队
- 官网
- aka.ms/agent-framework ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-22
- 源码审查
- 82/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Microsoft Agent Framework for Go(microsoft/agent-framework-go)是微软 Agent Framework 的 Go 语言实现,目前处于公共预览阶段,与上游 .NET/Python 版本分离演进。它提供 agent、provider、workflow、middleware 等包,用于构建、编排和部署 AI Agent 及多智能体工作流。框架支持 Microsoft Foundry、Azure OpenAI、OpenAI、MCP、A2A、AG-UI 与 GitHub Copilot SDK 等生态。工作流采用基于图的模式,支持顺序、并发、群组协作、条件路由、子工作流、检查点、流式处理、人在回路等能力。Go SDK 已覆盖核心 agent、工具、中间件、工作流、可观测性与互操作集成,但声明式 Agent、DevUI、AF Labs 和 handoff 编排尚未实现。
通过 provider/foundryprovider、provider/openaiprovider 等包调用 Foundry 与 OpenAI 模型,用 a.RunText(ctx, ...) 运行 agent;通过 workflow 包构建基于图的多智能体编排(顺序、并发、群组协作、条件路由、子工作流、检查点、人在回路);通过 agent/middleware.go 提供请求/响应处理、OpenTelemetry、工具审批与自动工具调用;通过 agent/skills、agent/textsearch、agent/memory 提供技能库、RAG 检索与向量化聊天记忆;通过 vectordata 包提供向量存储(含 Azure AI Search 与内存连接器);通过 embedding 包生成文本嵌入;通过 workflow/observability/opentelemetry 与 provider/otelprovider 输出分布式追踪。样例位于 examples/,从 01-get-started 渐进教程到 03-workflows 与 05-end-to-end 完整应用。
- Go 团队需要将单轮对话之外的多智能体编排(顺序、并发、群组协作、条件路由)落地到生产系统
- 平台工程团队需要可检查点、可重启、可观测(OpenTelemetry)、人在回路的 Agent 工作流
- 企业开发者要在 Microsoft Foundry 上构建项目级 Foundry Agent 或调用服务端已有 Foundry Agent
- 知识型应用需要自动检索并引用外部知识(RAG)或从向量存储恢复会话记忆
- 需要接入 MCP 服务器、A2A 或 AG-UI 等互操作协议的集成场景
- 团队需要向量搜索、混合搜索与嵌入生成等检索基础设施
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 环境变量
FOUNDRY_PROJECT_ENDPOINTFOUNDRY_MODEL
如何安装或部署这个 Agent?
通过 go get 安装:
go get github.com/microsoft/agent-framework-go运行样例前需要认证到 Azure/Foundry(开发环境推荐 az login),并设置相应的环境变量。
如何使用这个 Agent?
一个最小的 Foundry Agent 示例(创建并运行一个写俳句的 agent):
package main
import (
"cmp"
"context"
"fmt"
"os"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/microsoft/agent-framework-go/provider/foundryprovider"
)
func main() {
endpoint := os.Getenv("FOUNDRY_PROJECT_ENDPOINT")
model := cmp.Or(os.Getenv("FOUNDRY_MODEL"), "gpt-4o-mini")
token, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
panic(err)
}
a := foundryprovider.NewAgent(endpoint, token, foundryprovider.ModelDeployment(model),
foundryprovider.AgentConfig{
Instructions: "You are a helpful assistant.",
},
)
ctx := context.Background()
fmt.Println(a.RunText(ctx, "Write a haiku about the Microsoft Agent Framework").Collect())
}需要设置 FOUNDRY_PROJECT_ENDPOINT(可选 FOUNDRY_MODEL),并先用 az login 认证。更多示例见 examples/01-get-started、examples/03-workflows 与 docs/agent-harness.md。
这个 Agent 有哪些优点和局限?
- 微软官方维护,生态覆盖 Foundry、Azure OpenAI、OpenAI、MCP、A2A、AG-UI 与 GitHub Copilot SDK,供应商锁定风险低
- 图式工作流支持检查点、重启、流式处理、人在回路与 time-travel 等生产级编排能力
- 内置 OpenTelemetry 分布式追踪,provider/otelprovider 与 workflow/observability/opentelemetry 双层覆盖
- 提供 skills、textsearch(RAG)、memory、vectordata、embedding 等完整检索与记忆组件
- 公共预览状态,声明式 Agent、DevUI、AF Labs、handoff 编排、Foundry 托管部署均未在 Go SDK 实现,与 .NET 存在功能差距
- 使用第三方服务器、Agent 或非 Azure 直连模型需自行承担风险、成本与合规责任
- 生产环境需自行实现负责任 AI 缓解措施(元提示、内容过滤等)
- 默认行为会在访问已批准的 Azure/Foundry 端点时发送特性使用位掩码,需通过 AGENT_FRAMEWORK_FEATURE_MASK_DISABLED 显式关闭
这个 Agent 与同类方案有什么区别?
上游 microsoft/agent-framework 仓库提供 .NET 与 Python 实现,产品集成更广、功能更完整;Go SDK 目前处于预览阶段且与上游核心分离演进,未来预期会更紧密对齐。README 提供了 docs/dotnet-go-sdk-feature-comparison.md 功能对比文档。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Microsoft Agent Framework for Go 当前 | 82 · 表现良好 | 代码库 / SDK免费 + 模型费 | ★ 695 | 今天 | Go | OpenAI API |
| Microsoft Agent Framework 实战示例 | 54 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 397 | 5 个月前 | Jupyter Notebook | — |
| Microsoft Agent Framework | 70 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 15k | 5 天前 | Python | OpenAI API |
| AgentOS | 64 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 691 | 1 天前 | TypeScript | Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示框架自身不带危险的默认权限:遥测文档明确功能掩码仅发往白名单 Azure 域名、绝不发往第三方,且有环境变量关闭开关;README 明确第三方系统风险由用户承担并建议生产环境用受管身份凭据,最终权限交由开发者配置,属合理的最小权限设计但未见代码级权限审计证据,扣一分。工具审批中间件(tool approval)在特性列表中提及,说明存在用户确认机制,但该包源码未在样本中,只能按'存在但未验证'给2分。数据流透明度极佳:遥测文档逐位说明掩码含义、发射条件、域名白名单和 opt-out。敏感数据处理方面,README 强调用户需自行审查数据流出边界,框架文档称掩码不含用户数据,但未见加密/脱敏代码证据。依赖安全:go.mod 锁定版本且多为知名官方库,但无漏洞扫描/审计配置证据。外部影响:示例涉及 Azure 服务与文件内存写入,均需环境变量与认证,无破坏性默认。回滚:仅提到工作流 checkpointing 能力,框架级回滚/撤销机制未见文档,扣分明显。来源归属清晰:MIT License、Microsoft 版权、SECURITY.md 指向 MSRC。
自一致性很好:README 的功能说明、telemetry 文档与 cmd/verifyexamples 的行为互相吻合,明确标注未实现项(handoff、declarative agents、DevUI 等),无自相矛盾。依赖可用性:全部依赖来自知名公开模块且版本固定,AG-UI 使用伪提交哈希依赖属不稳定来源,扣一分。失败信息:verifyexamples 和 catalog 工具都有结构化错误输出和明确错误消息,README 有认证故障排查表,但框架运行时的错误消息质量未在样本中体现,给2分。
受众与场景描述充分:README 明确'是否适合你'章节,覆盖生产级 agent、多 agent 编排、RAG、记忆等场景。能力边界处理是该仓库亮点:逐条列出 Go SDK 未实现的功能(handoff、声明式 agent、AF Labs、DevUI、Foundry 托管部署),并给出 .NET-Go 对照文档。触发精度:SKILL.md(dotnet-symbols、agentic-workflows)description 明确、有 argument-hint,但样本 SKILL 文件主要是仓库内部工具技能而非面向最终用户的产品触发面,给2分。环境适配好:快速入门、环境变量表、az login 指引、验证工具均适配 Go/Azure 环境。
信息架构优秀:README 目录完整、示例按 01-05 分类渐进、文档链接指向具体路径。安装说明简洁可用(go get 一行),但缺少版本/发布渠道说明,给2分。命名稳定性:Go 包命名一致(provider/、agent/、workflow/),但项目处于 public preview,API 可能变化,给2分。示例与 FAQ 丰富:渐进式示例、故障排查表、TRANSPARENCY_FAQ。已知限制诚实列出(preview 状态、未实现功能)。License 完整明确(MIT,微软版权)。版本与变更日志:未见 CHANGELOG,User-Agent 显示 v0.1.0 但无版本策略文档,扣分明显。维护责任明确:CONTRIBUTING、SECURITY、SUPPORT 政策齐全,MSRC 漏洞响应路径明确。
输出可用性好:示例输出可预期,verifyexamples 工具可自动校验示例输出,catalog 工具输出结构化 JSON 且有缓冲避免半输出。边际价值高:Go 生态中尚无等价的 .NET/Python MAF 对应物,symbol catalog、feature mask 等工具是独特贡献。成本收益:框架本身学习成本与依赖面较大(大量云 SDK 依赖),对非 Azure 用户成本偏高,扣一分。
声明可追溯性好:README 中每项功能都链接到具体示例或包路径,telemetry 文档链接到 .NET registry 源码提交。跨源印证:telemetry 行为在 README 与 docs/feature-usage-telemetry.md 中一致描述,但静态审阅无法执行验证,且 SKILL 文件引用的远程 gh-aw 内容未在包内,给2分。事实与推断分离做得好:明确区分'已实现'与'未实现'、'发布预览'状态、映射声明'不等于行为对等'(symbolmap 注释明示),证据诚实。
- 项目处于 public preview,API 尚不稳定,生产使用需做好变更应对。
- 回滚/撤销机制文档薄弱,工作流虽有 checkpointing,但框架级错误恢复路径需自行验证。
- 功能掩码遥测默认开启(仅发往 Azure 白名单域名),不希望任何遥测时须设置 AGENT_FRAMEWORK_FEATURE_MASK_DISABLED 或 USER_AGENT_DISABLED。
- 连接第三方系统(OpenAI、MCP、A2A 等)的数据流与风险由使用者承担,需自行审查数据边界与审批机制。
- go.mod 依赖面很大,含伪版本依赖(AG-UI),建议在生产中复核依赖来源与漏洞状况。
常见问题
项目是否可以用于生产?
会产生哪些费用?
它会收集哪些遥测数据?
Go 版本缺哪些功能?
支持哪些模型提供方?
Microsoft Agent Framework for Go 官网是什么?
Microsoft Agent Framework for Go 开源吗?
Microsoft Agent Framework for Go 安全吗?
Microsoft Agent Framework for Go 还在维护吗?
Microsoft Agent Framework for Go 是谁开发的?
谢谢反馈,我们会据此改进页面。