microsoft/agent-framework-go

A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Go.

Microsoft Agent Framework for Go – 개요

Microsoft Agent Framework (MAF)는 AI 에이전트와 복잡한 멀티 에이전트 워크플로를 구축하기 위한 다중 언어 지원 프로덕션급 프레임워크입니다. 이 리포지토리에는 해당 프레임워크의 Go 구현과 샘플, 문서, Go 전용 SDK가 포함되어 있습니다.

누가 필요한가?

단순한 챗봇 프로토타입에서 강력하고 오케스트레이션된 에이전트 시스템으로 전환하려는 팀.
그래프 기반 워크플로(순차, 동시, 조건부 라우팅, 체크포인트, 인간 개입 등)가 필요한 프로젝트.
관찰 가능성(OpenTelemetry), 공급자 유연성(Azure OpenAI, OpenAI, Microsoft Foundry 등), 그리고 로깅, 도구 승인 또는 자동 도구 호출을 위한 미들웨어 추가 기능을 원하는 조직.
이미 .NET 또는 Python 버전의 MAF를 사용 중이며 Go 네이티브 API를 원하는 개발자.

핵심 기능(README 기준)

영역	Go SDK 제공 기능
에이전트 및 공급자 지원	다중 LLM/에이전트 공급자를 위한 패키지; Azure OpenAI, OpenAI, Microsoft Foundry 예제 포함.
미들웨어	요청/응답 처리, 로깅, OpenTelemetry, 컨텍스트 주입, 도구 승인 및 자동 도구 호출을 위한 훅(Hooks).
워크플로	순차, 동시, 그룹 협업, 조건부 라우팅, 하위 워크플로, 체크포인트, 스트리밍 및 인간 개입을 지원하는 그래프 기반 오케스트레이션. (핸드오프 오케스트레이션은 아직 구현되지 않음.)
관찰 가능성	에이전트 및 워크플로를 위한 OpenTelemetry 통합 내장.
기술(Skills)	에이전트가 쿼리할 수 있는 도메인별 지식 베이스(파일, 인라인 정의, 스크립트)를 연결하는 기능.
Foundry 통합	Microsoft Foundry 에이전트 생성 및 호출, 클라이언트 헤더 전달, 모델 메타데이터 캡처 및 Foundry 메모리 사용(배포 측 호스팅은 Go에서 아직 구현되지 않음).
누락/향후 기능	선언적 에이전트, RAG, CodeAct, 함수형 워크플로, DevUI, AF Labs 및 일부 고급 공급자 기능은 아직 미구현 상태입니다.

시작하기(README 기준)

설치 SDK:

go get github.com/microsoft/agent-framework-go

간단한 에이전트 작성 – README에는 하이쿠를 생성하는 최소한의 Foundry 에이전트 예제가 있습니다:

a := foundryprovider.NewAgent(endpoint, token,
    foundryprovider.ModelDeployment(model),
    foundryprovider.AgentConfig{Instructions: "You are a helpful assistant."})
fmt.Println(a.RunText(ctx, "Write a haiku about the Microsoft Agent Framework").Collect())

examples/ 폴더의 샘플 탐색:
- 01-get-started – 단계별 튜토리얼.
- 02-agents – 도구, 미들웨어, 공급자, 기술 등에 대한 심층 분석.
- 03-workflows – 멀티 에이전트 패턴, 라우팅, 체크포인트.
- 05-end-to-end – 전체 애플리케이션 데모.
문서 읽기 – Microsoft Learn 링크, 기능 비교 매트릭스 및 퀵스타트 가이드.

생태계 및 커뮤니티

실시간 도움말은 Discord 사용.
버그 보고 및 기능 요청은 GitHub Issues 사용.
자세한 튜토리얼 및 사용자 가이드는 Microsoft Learn 페이지 참조.
Go SDK는 현재 공개 미리 보기 단계이므로 빠르게 발전하고 있으며, 정렬이 개선될 때까지 상위 .NET/Python 리포지토리와 차이가 있을 수 있습니다.

적합하지 않은 경우

.NET 버전에만 있는 선언적 에이전트 모델, RAG 파이프라인 또는 DevUI가 필요한 경우.
핸드오프 오케스트레이션이나 Foundry 호스팅 배포(Go에서 아직 미구현)가 필요한 프로젝트.
워크플로 오케스트레이션이나 관찰 가능성이 필요 없는 매우 작은 단일 프롬프트 봇.

요약: Microsoft Agent Framework for Go는 Go에서 정교한 AI 에이전트 시스템을 구축하기 위한 본격적인 프로덕션 지향 SDK로, 다중 공급자, 미들웨어, 관찰 가능한 워크플로 및 Microsoft Foundry 플랫폼과의 통합을 지원합니다. 이는 단순한 챗봇을 넘어 확장 가능하고 오케스트레이션된 AI 애플리케이션을 지향하는 개발자를 대상으로 합니다.