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 브리지 |
| 재사용 클래스 | 제품 기능으로 패키지 배포 |
관련 문서
- agent-skills-tutorial-microsoft-agent-framework-python — 파일·코드·클래스 스킬을 SkillsProvider 하나로 결합하는 방법
- ms-agent-framework-tutorial-agents-that-build-agents — SKILL-first 설계로 에이전트가 에이전트를 만드는 두 레이어 아키텍처
참고 자료
- Microsoft Agent Framework Blog — Microsoft 공식 블로그
- microsoft/Webwright — Microsoft Research 브라우저 에이전트 (Agent Framework 연동 지원)