Microsoft Agent Framework for Go

微软官方开源框架,用 Go 构建生产级 AI Agent 与多智能体工作流,覆盖编排、可观测性与 Foundry 集成。

Star 数
★ 695
最近更新
今天
License
MIT
主语言
Go

30 秒速览

运行形态
代码库 / SDK开发框架
可在哪里用
通用 · 跨平台OpenAI API
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
GoAzure CLI(az login,用于 Foundry/Azure 凭据)Microsoft Foundry 项目终结点或 OpenAI API 凭据Shell / 命令行网络访问本地文件系统MCP Server
典型场景
Go 团队需要将单轮对话之外的多智能体编排(顺序、并发、群组协作、条件路由)落地到生产系统
不适合
  • 需要声明式 Agent、DevUI、AF Labs 或 handoff 编排等尚未在 Go SDK 实现的特性的团队
  • 不用 Go 语言的开发团队,应考虑 .NET 或 Python 版 Agent Framework
  • 不接受公共预览阶段、需要生产级稳定性承诺的团队
官网
aka.ms/agent-framework ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-22

这个 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 完整应用。

  1. Go 团队需要将单轮对话之外的多智能体编排(顺序、并发、群组协作、条件路由)落地到生产系统
  2. 平台工程团队需要可检查点、可重启、可观测(OpenTelemetry)、人在回路的 Agent 工作流
  3. 企业开发者要在 Microsoft Foundry 上构建项目级 Foundry Agent 或调用服务端已有 Foundry Agent
  4. 知识型应用需要自动检索并引用外部知识(RAG)或从向量存储恢复会话记忆
  5. 需要接入 MCP 服务器、A2A 或 AG-UI 等互操作协议的集成场景
  6. 团队需要向量搜索、混合搜索与嵌入生成等检索基础设施

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

环境变量
FOUNDRY_PROJECT_ENDPOINT FOUNDRY_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?

FollowAgents 源码审查 · FARS-2.1
表现良好
82/ 100 五分制 4.1 / 5
信任安全 21/29
可靠稳定 11/14
适用触发 16/18
规范维护 15/18
有效结果 12/13
证据核验 7/8
查看各维度的扣分理由
信任安全21 / 29 · 3.6/5

证据显示框架自身不带危险的默认权限:遥测文档明确功能掩码仅发往白名单 Azure 域名、绝不发往第三方,且有环境变量关闭开关;README 明确第三方系统风险由用户承担并建议生产环境用受管身份凭据,最终权限交由开发者配置,属合理的最小权限设计但未见代码级权限审计证据,扣一分。工具审批中间件(tool approval)在特性列表中提及,说明存在用户确认机制,但该包源码未在样本中,只能按'存在但未验证'给2分。数据流透明度极佳:遥测文档逐位说明掩码含义、发射条件、域名白名单和 opt-out。敏感数据处理方面,README 强调用户需自行审查数据流出边界,框架文档称掩码不含用户数据,但未见加密/脱敏代码证据。依赖安全:go.mod 锁定版本且多为知名官方库,但无漏洞扫描/审计配置证据。外部影响:示例涉及 Azure 服务与文件内存写入,均需环境变量与认证,无破坏性默认。回滚:仅提到工作流 checkpointing 能力,框架级回滚/撤销机制未见文档,扣分明显。来源归属清晰:MIT License、Microsoft 版权、SECURITY.md 指向 MSRC。

可靠稳定11 / 14 · 3.9/5

自一致性很好:README 的功能说明、telemetry 文档与 cmd/verifyexamples 的行为互相吻合,明确标注未实现项(handoff、declarative agents、DevUI 等),无自相矛盾。依赖可用性:全部依赖来自知名公开模块且版本固定,AG-UI 使用伪提交哈希依赖属不稳定来源,扣一分。失败信息:verifyexamples 和 catalog 工具都有结构化错误输出和明确错误消息,README 有认证故障排查表,但框架运行时的错误消息质量未在样本中体现,给2分。

适用触发16 / 18 · 4.4/5

受众与场景描述充分: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 环境。

规范维护15 / 18 · 4.2/5

信息架构优秀: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 漏洞响应路径明确。

有效结果12 / 13 · 4.6/5

输出可用性好:示例输出可预期,verifyexamples 工具可自动校验示例输出,catalog 工具输出结构化 JSON 且有缓冲避免半输出。边际价值高:Go 生态中尚无等价的 .NET/Python MAF 对应物,symbol catalog、feature mask 等工具是独特贡献。成本收益:框架本身学习成本与依赖面较大(大量云 SDK 依赖),对非 Azure 用户成本偏高,扣一分。

证据核验7 / 8 · 4.4/5

声明可追溯性好: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),建议在生产中复核依赖来源与漏洞状况。
证据充分度:低 评估于 2026年11月22日 审查版本 045c7be52783
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agent-framework-go.svg?lang=zh)](https://followagents.com/zh/agents/agent-framework-go)
<a href="https://followagents.com/zh/agents/agent-framework-go"><img src="https://followagents.com/badge/agent-framework-go.svg?lang=zh" alt="FARS 评测"></a>

常见问题

项目是否可以用于生产?
Go SDK 处于公共预览(public preview),官方预期随采用和反馈与上游 MAF 生态更紧密对齐;是否用于生产需自行评估风险并实现负责任 AI 缓解措施。
会产生哪些费用?
框架本身基于 MIT 许可免费开源,但调用 Foundry/Azure OpenAI/OpenAI 等模型服务会产生相应的 API 使用费用,由使用者承担。
它会收集哪些遥测数据?
仓库不配置微软遥测导出器;OpenAI/Foundry 适配器仅在访问已批准的 Azure/Foundry HTTPS 端点时附加进程级特性使用位掩码,不记录调用次数、提示词、参数或用户数据。设置 AGENT_FRAMEWORK_FEATURE_MASK_DISABLED=true 或 AGENT_FRAMEWORK_USER_AGENT_DISABLED=true 可关闭。
Go 版本缺哪些功能?
声明式 Agent、DevUI、AF Labs、handoff 编排、Foundry 托管部署在 Go SDK 中尚未实现,详见 docs/dotnet-go-sdk-feature-comparison.md。
支持哪些模型提供方?
README 明确列出 Microsoft Foundry、Azure OpenAI、OpenAI,以及 MCP、A2A、AG-UI、GitHub Copilot SDK 等生态支持,并称提供方持续增加中。
Microsoft Agent Framework for Go 官网是什么?
Microsoft Agent Framework for Go 的 GitHub 仓库填写的官网是 https://aka.ms/agent-framework。这个链接由仓库作者设置;源码在 GitHub(microsoft/agent-framework-go)。
Microsoft Agent Framework for Go 开源吗?
开源。源码在 GitHub(microsoft/agent-framework-go),许可证是 MIT。
Microsoft Agent Framework for Go 安全吗?
FollowAgents 的 FARS 评审(2026年11月22日)给 Microsoft Agent Framework for Go 的“信任与安全”打了 21/29 分。评审检查的 8 项安全措施没有完全缺失的。
Microsoft Agent Framework for Go 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-22,在最近 30 天内。
Microsoft Agent Framework for Go 是谁开发的?
Microsoft Agent Framework for Go 由 Microsoft 发布。FollowAgents 已核实 GitHub 账号 microsoft 属于 Microsoft。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念