[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93354":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":19,"hasPages":19,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":16,"starSnapshotCount":16,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},93354,"agent-framework-go","microsoft\u002Fagent-framework-go","microsoft","A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Go.",null,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go","Go",191,13,3,19,0,40,64.44,false,"main","2026-07-22 04:02:08","![Microsoft Agent Framework](docs\u002Fassets\u002Freadme-banner.png)\n\n# Welcome to Microsoft Agent Framework for Go!\n\n[![Microsoft Foundry Discord](https:\u002F\u002Fdcbadge.limes.pink\u002Fapi\u002Fserver\u002Fb5zjErwbQM?style=flat)](https:\u002F\u002Fdiscord.gg\u002Fb5zjErwbQM)\n[![MS Learn Documentation](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMS%20Learn-Documentation-blue)](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002F)\n[![Go Reference](https:\u002F\u002Fpkg.go.dev\u002Fbadge\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go.svg)](https:\u002F\u002Fpkg.go.dev\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go)\n[![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fmicrosoft\u002Fagent-framework-go?style=social)](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go\u002Fstargazers)\n\nMicrosoft Agent Framework (MAF) is an open, multi-language framework for building **production-grade AI agents and multi-agent workflows**. This repository contains the Go implementation of Microsoft Agent Framework, along with Go samples and documentation to help you get started.\n\nMicrosoft Agent Framework is built for teams taking agents from prototype to production. It provides a consistent foundation for building, orchestrating, and operating agent systems while keeping architecture choices open as requirements evolve, and supports a broad ecosystem including Microsoft Foundry, Azure OpenAI, OpenAI, Model Context Protocol (MCP), Agent2Agent (A2A), AG-UI, and the GitHub Copilot SDK.\n\nThe .NET and Python implementations are available in the [upstream Microsoft Agent Framework repository](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework).\n\n> **Note:** Microsoft Agent Framework for Go is in public preview and is currently evolving outside the core upstream codebase. As adoption and feedback grow, we expect closer alignment with the broader MAF ecosystem.\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=AAgdMhftj8w\" title=\"Watch the full Agent Framework introduction (30 min)\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FAAgdMhftj8w\u002Fhqdefault.jpg\"\n         alt=\"Watch the full Agent Framework introduction (30 min)\" width=\"480\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=AAgdMhftj8w\">\n    Watch the full Agent Framework introduction (30 min)\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## Is this the right framework for you?\n\nMAF is a strong fit if you:\n\n- are building agents and workflows you expect to run in production,\n- need orchestration beyond a single prompt or stateless chat loop,\n- want graph-based patterns such as sequential, concurrent, group collaboration, and custom workflow routing,\n- care about checkpointing, restartability, observability, governance, or human-in-the-loop control,\n- need provider flexibility so your architecture can evolve without major rewrites.\n\n## Key Features\n\nExplore new MAF capabilities and real implementation patterns on the [official blog](https:\u002F\u002Fdevblogs.microsoft.com\u002Fagent-framework\u002F).\n\nFor a detailed .NET-to-Go feature comparison, see the [.NET and Go SDK feature comparison](.\u002Fdocs\u002Fdotnet-go-sdk-feature-comparison.md). In short, the Go SDK covers core agents, tools, middleware, workflows, observability, and interoperability integrations, while .NET currently has broader product integrations and several features that are not implemented yet in Go.\n\n- **Go Support**: Go packages, examples, and APIs for building agents and workflows in Go.\n  - [Go reference](https:\u002F\u002Fpkg.go.dev\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go) | [Go examples](.\u002Fexamples\u002F)\n- **Multiple Agent Provider Support**: Support for various LLM and agent providers, with more being added continuously.\n  - [Provider examples](.\u002Fexamples\u002F02-agents\u002Fproviders\u002F) | [Provider packages](.\u002Fprovider\u002F)\n- **Middleware**: Flexible middleware for request\u002Fresponse processing, logging, OpenTelemetry, context providers, tool approval, and automatic tool calling.\n  - [Agent middleware](.\u002Fagent\u002Fmiddleware.go) | [Agent harness](.\u002Fagent\u002Fharness\u002F)\n- **Orchestration Patterns & Workflows**: Build multi-agent systems with graph-based workflows supporting sequential, concurrent, group collaboration, conditional routing, subworkflows, checkpointing, streaming, human-in-the-loop, and time-travel patterns. Handoff orchestration is not implemented yet in the Go SDK.\n  - [Workflow examples](.\u002Fexamples\u002F03-workflows\u002F) | [Workflow package](.\u002Fworkflow\u002F)\n- **Microsoft Foundry Agents**: Build project-backed Foundry agents, invoke existing server-side Foundry agents, pass Foundry client headers, capture served-model metadata, and use Foundry memory. Foundry-hosted deployment is not implemented yet in the Go SDK.\n  - [Foundry examples](.\u002Fexamples\u002F02-agents\u002Fproviders\u002Ffoundry\u002F) | [Foundry provider](.\u002Fprovider\u002Ffoundryprovider\u002F)\n- **Observability**: OpenTelemetry integration for distributed tracing, monitoring, and debugging.\n  - [Agent OpenTelemetry](.\u002Fprovider\u002Fotelprovider\u002F) | [Workflow OpenTelemetry](.\u002Fworkflow\u002Fobservability\u002Fopentelemetry\u002F)\n- **Declarative Agents**: Not implemented yet in the Go SDK.\n- **Agent Skills**: Build domain-specific knowledge bases from files, inline definitions, and scripts for agents to discover and use.\n  - [Skills examples](.\u002Fexamples\u002F02-agents\u002Fskills\u002F) | [Skills package](.\u002Fagent\u002Fskills\u002F)\n- **AF Labs**: Not implemented yet in the Go SDK.\n- **DevUI**: Not implemented yet in the Go SDK.\n\n## Table of Contents\n\n- [Welcome to Microsoft Agent Framework for Go!](#welcome-to-microsoft-agent-framework-for-go)\n\t- [Is this the right framework for you?](#is-this-the-right-framework-for-you)\n\t- [Key Features](#key-features)\n\t- [Table of Contents](#table-of-contents)\n\t- [Getting Started](#getting-started)\n\t\t- [Installation](#installation)\n\t\t- [Learning Resources](#learning-resources)\n\t\t- [Quickstart](#quickstart)\n\t\t\t- [Basic Agent - Go](#basic-agent---go)\n\t- [More Examples \\& Samples](#more-examples--samples)\n\t\t- [Go](#go)\n\t- [Community \\& Feedback](#community--feedback)\n\t- [Troubleshooting](#troubleshooting)\n\t\t- [Authentication](#authentication)\n\t\t- [Environment Variables](#environment-variables)\n\t- [Contributor Resources](#contributor-resources)\n\t- [Important Notes](#important-notes)\n\t\t- [Telemetry and data collection](#telemetry-and-data-collection)\n\t\t- [Preview status](#preview-status)\n\t\t- [Trademarks](#trademarks)\n\n## Getting Started\n\n### Installation\n\nGo\n\n```bash\ngo get github.com\u002Fmicrosoft\u002Fagent-framework-go\n```\n\n### Learning Resources\n\n- **[Overview](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Foverview\u002Fagent-framework-overview)** - High level overview of the framework\n- **[Quick Start](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Ftutorials\u002Fquick-start)** - Get started with a simple agent\n- **[Tutorials](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Ftutorials\u002Foverview)** - Step by step tutorials\n- **[User Guide](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fuser-guide\u002Foverview)** - In-depth user guide for building agents and workflows\n\n### Quickstart\n\n#### Basic Agent - Go\n\nCreate a simple Microsoft Foundry agent that writes a haiku about the Microsoft Agent Framework.\n\n```go\npackage main\n\nimport (\n\t\"cmp\"\n\t\"context\"\n\t\"fmt\"\n\t\"os\"\n\n\t\"github.com\u002FAzure\u002Fazure-sdk-for-go\u002Fsdk\u002Fazidentity\"\n\t\"github.com\u002Fmicrosoft\u002Fagent-framework-go\u002Fprovider\u002Ffoundryprovider\"\n)\n\nfunc main() {\n\tendpoint := os.Getenv(\"FOUNDRY_PROJECT_ENDPOINT\")\n\tmodel := cmp.Or(os.Getenv(\"FOUNDRY_MODEL\"), \"gpt-4o-mini\")\n\n\t\u002F\u002F Authenticate to Microsoft Foundry.\n\ttoken, err := azidentity.NewDefaultAzureCredential(nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\t\u002F\u002F Create a Microsoft Foundry agent.\n\ta := foundryprovider.NewAgent(endpoint, token, foundryprovider.ModelDeployment(model),\n\t\tfoundryprovider.AgentConfig{\n\t\t\tInstructions: \"You are a helpful assistant.\",\n\t\t},\n\t)\n\n\t\u002F\u002F Run the agent.\n\tctx := context.Background()\n\tfmt.Println(a.RunText(ctx, \"Write a haiku about the Microsoft Agent Framework\").Collect())\n}\n```\n\n## More Examples & Samples\n\n### Go\n\n- [Getting Started](.\u002Fexamples\u002F01-get-started): progressive tutorial from hello world to workflows\n- [Agent Concepts](.\u002Fexamples\u002F02-agents): deep-dive samples by topic, including tools, middleware, providers, observability, A2A, AG-UI, MCP, and skills\n- [Workflows](.\u002Fexamples\u002F03-workflows): multi-agent patterns, routing, checkpointing, observability, and workflow orchestration\n- [End-to-End](.\u002Fexamples\u002F05-end-to-end): full applications and demos\n- [Feature Comparison](.\u002Fdocs\u002Fdotnet-go-sdk-feature-comparison.md): .NET and Go SDK feature parity notes\n\n## Community & Feedback\n\n- **Found a bug?** File a [GitHub issue](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go\u002Fissues) to help us improve.\n- **Enjoying MAF for Go?** [![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStar-us%20on%20GitHub-yellow)](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go) to show your support and help others discover the project.\n- **Have questions?** Join our [Discord](https:\u002F\u002Fdiscord.gg\u002Fb5zjErwbQM).\n\n## Troubleshooting\n\n### Authentication\n\n| Problem | Cause | Fix |\n| --- | --- | --- |\n| Authentication errors when using Azure credentials | Not signed in to Azure CLI or another configured credential source | Run `az login` before starting your app, or configure the specific credential your app uses |\n| API key errors | Wrong or missing API key | Verify the key and ensure it is for the correct resource or provider |\n| Provider endpoint errors | Missing or incorrect endpoint, deployment, model, or API version | Check the environment variables and constructor options used by the sample or provider |\n\n> **Tip:** `DefaultAzureCredential` is convenient for development but in production, consider using a specific credential, such as managed identity, to avoid latency issues, unintended credential probing, and potential security risks from fallback mechanisms.\n\n### Environment Variables\n\nFor environment variable configuration specific to each sample, refer to the README or source in the sample directory under [examples](.\u002Fexamples\u002F).\n\n## Contributor Resources\n\n- [Contributing Guide](.\u002FCONTRIBUTING.md)\n- [Code of Conduct](.\u002FCODE_OF_CONDUCT.md)\n- [Security Policy](.\u002FSECURITY.md)\n- [Support Policy](.\u002FSUPPORT.md)\n- [Responsible AI Transparency FAQ](.\u002FTRANSPARENCY_FAQ.md)\n\n## Important Notes\n\n> [!IMPORTANT]\n> If you use Microsoft Agent Framework to build applications that operate with any third-party servers, agents, code, or non-Azure Direct models (\"Third-Party Systems\"), you do so at your own risk. Third-Party Systems are Non-Microsoft Products under the Microsoft Product Terms and are governed by their own third-party license terms. You are responsible for any usage and associated costs.\n>\n> We recommend reviewing all data being shared with and received from Third-Party Systems and being cognizant of third-party practices for handling, sharing, retention, and location of data. It is your responsibility to manage whether your data will flow outside of your organization's Azure compliance and geographic boundaries and any related implications, and that appropriate permissions, boundaries, and approvals are provisioned.\n>\n> You are responsible for carefully reviewing and testing applications you build using Microsoft Agent Framework in the context of your specific use cases, and making all appropriate decisions and customizations. This includes implementing your own responsible AI mitigations such as metaprompt, content filters, or other safety systems, and ensuring your applications meet appropriate quality, reliability, security, and trustworthiness standards. See also: [Transparency FAQ](.\u002FTRANSPARENCY_FAQ.md).\n\n### Telemetry and data collection\n\nThis repository does not configure Microsoft telemetry collection by default. Some packages and samples include optional OpenTelemetry instrumentation or connect to Microsoft-hosted services. To turn off framework instrumentation, do not configure OpenTelemetry exporters or telemetry middleware in your application. Service telemetry, if any, is governed by the services you choose to call.\n\n### Preview status\n\nThe Agent Framework for Go is in public preview. Declarative agents, RAG, CodeAct, and functional workflows are not yet available. File issues on GitHub at https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework-go\u002Fissues.\n\n### Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https:\u002F\u002Fwww.microsoft.com\u002Fen-us\u002Flegal\u002Fintellectualproperty\u002Ftrademarks\u002Fusage\u002Fgeneral). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third-party policies.\n","Microsoft Agent Framework for Go 是一个用于构建、编排和部署生产级 AI 代理及多代理工作流的开源框架。它提供图式工作流编排（支持串行、并行、协作与自定义路由）、检查点恢复、可观测性、治理控制和人机协同能力，并兼容 Azure OpenAI、OpenAI、MCP、A2A 等主流协议与服务。框架设计面向工程化落地，强调架构开放性与演进弹性，适合需长期运维、高可靠性要求的 AI 应用场景，如企业级智能助手、自动化业务流程、跨系统协同代理系统等。",2,"2026-07-17 02:30:06","trending"]