프레임워크 개요

Microsoft Agent Framework(MAF)는 .NET과 파이썬에서 프로덕션급 AI 에이전트와 다중 에이전트 워크플로를 만들기 위한 오픈·다중 언어 프레임워크예요. 에이전트를 프로토타입에서 운영까지 끌어올리는 팀을 기준으로 설계됐어요.

출처: https://github.com/microsoft/agent-framework

MAF가 좋은 선택이 되는 경우는 이래요. 운영에서 돌아갈 에이전트와 워크플로를 만들고, 단일 프롬프트나 상태 없는 채팅 루프 너머의 오케스트레이션이 필요하며, 시퀀셜·동시·핸드오프·그룹 협력 같은 그래프 기반 패턴을 쓰고 싶은 경우죠. 지속성, 재시작성, 관찰 가능성, 거버넌스, 휴먼 인 더 루프도 신경 쓴다면 더 맞아요.

주요 특징을 짚어 볼게요. 파이썬과 C#/.NET을 동일한 API 규약으로 지원하고, Go용은 별도 리포(microsoft/agent-framework-go)로 제공돼요. 여러 LLM 프로바이더를 지원하며, 미들웨어로 요청·응답 처리와 예외 처리 파이프라인을 만들 수 있어요. 오케스트레이션은 체크포인팅, 스트리밍, 휴먼 인 더 루프, 타임트래블을 포함한 그래프 기반 워크플로를 지원해요.

# pip install agent-framework
import asyncio
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential

async def main():
    agent = Agent(
      client=FoundryChatClient(
          credential=AzureCliCredential(),
      ),
      name="HaikuAgent",
      instructions="You are an upbeat assistant that writes beautifully.",
    )
    print(await agent.run("Write a haiku about Microsoft Agent Framework."))

if __name__ == "__main__":
    asyncio.run(main())

또한 내장 OpenTelemetry로 분산 추적·모니터링을 지원하고, YAML로 에이전트를 선언적으로 정의하는 Declarative Agents, 파일·인라인 코드로 구성한 도메인 지식을 에이전트가 발견해 쓰는 Agent Skills까지 갖췄어요.