Microsoft Agent Framework – 에이전트를 설계하고 운영하는 두 레이어 SDK

핵심 개념: SKILL
두 레이어 아키텍처
스킬 형태
오케스트레이션 패턴 1.0
관련 문서
참고 자료

Microsoft Agent Framework는 AI 에이전트를 체계적으로 구축하고 운영하기 위한 Microsoft의 SDK다. “에이전트를 만드는 에이전트”와 “에이전트를 실행하는 에이전트”를 분리하는 두 레이어 아키텍처를 핵심 설계 원칙으로 삼으며, SKILL이라는 명세 파일로 에이전트의 도메인 지식과 동작 규칙을 버전 관리한다. Python과 .NET(C#)을 동등하게 지원한다.

핵심 개념: SKILL

SKILL은 에이전트가 해야 할 일, 사용할 도구, 따라야 할 컨벤션을 담은 구조화된 명세 파일이다. Coding Agent가 코드를 생성하기 전에 반드시 읽는 가이드로, 프레임워크·스타일·픽스처와 일치하는 아티팩트가 나오도록 보장한다. 일반적인 프롬프트보다 훨씬 정밀하게 동작을 제어할 수 있다.

두 레이어 아키텍처

┌────────────────────────────────┐
│  Layer 1: Coding Agent (빌드)  │  에이전트를 만드는 에이전트
│  SKILL → 코드 생성 → 검증     │  Microsoft Foundry에 배포
├────────────────────────────────┤
│  Layer 2: Runtime Agent (운영) │  실제로 비즈니스가 운영하는 에이전트
│  계획 → 도구 호출 → 메모리    │  사용자 채널로 출력 스트리밍
└────────────────────────────────┘

두 레이어를 분리하면 빌드 타임의 코드 품질 보장과 런타임의 실시간 추론이 섞이지 않아 유지보수성이 높아진다.

스킬 형태

Python에서는 세 가지 스킬 형태를 SkillsProvider 하나로 조합한다:

형태	적합한 상황
파일 기반 (`SKILL.md`)	저장소별 가이드·스크립트 버전 관리
인라인 코드	정식 패키지 전 임시 API 브리지
재사용 클래스	제품 기능으로 패키지 배포

2026년 7월 Microsoft는 Python용 Agent Skills API가 stable로 출시됐다고 발표했다. 파일 기반, 클래스 기반, 코드 정의 스킬을 모두 같은 provider에 연결할 수 있고, load_skill, read_skill_resource, run_skill_script 도구는 기본적으로 승인 대상이다. 운영 환경에서는 읽기 전용 스킬 로드는 자동 승인하되, 스크립트 실행은 sandbox와 감사 로그를 붙여 승인 대상으로 유지하는 구성이 실용적이다.

오케스트레이션 패턴 1.0

2026년 7월 기준 Python의 agent-framework-orchestrations 패키지가 1.0.0에 도달하면서 .NET과 Python 양쪽에서 orchestration layer가 안정화됐다. 순차(sequential), 동시(concurrent), group chat, handoff, magentic orchestration을 같은 workflow 기반으로 사용할 수 있다.

특히 magentic orchestration은 manager agent가 목표를 읽고, specialist agent에게 작업을 나누고, 진행이 멈추면 reset·replan하는 패턴이다. 직접 workflow graph를 모두 연결하지 않아도 MagenticBuilder로 manager, participants, round/stall/reset guardrail을 지정해 실행할 수 있다.

workflow = MagenticBuilder(
    participants=[researcher, coder],
    manager_agent=manager,
    max_round_count=10,
    max_stall_count=3,
    max_reset_count=2,
).build()

이 변화의 의미는 multi-agent coordination을 애플리케이션마다 새로 구현하지 않아도 된다는 데 있다. 단순 pipeline은 sequential/concurrent로, 명확한 routing은 handoff로, 유연한 specialist team은 magentic으로 나눠 선택할 수 있다.

참고 자료

Microsoft Agent Framework Blog — Microsoft 공식 블로그
Agent Framework’s Orchestration Patterns Reach 1.0 — Microsoft Agent Framework Blog (2026-07-08)
Agent Skills for Python Is Now Released — Microsoft Agent Framework Blog (2026-07)
microsoft/Webwright — Microsoft Research 브라우저 에이전트 (Agent Framework 연동 지원)

Like?

AI Sparkup