---
name: microsoft-agent-framework
description: >
  Design enterprise-grade agent systems with Microsoft's agent framework
  patterns: role separation, workflow control, policy boundaries, and
  observability. Use when users need robust organizational agent workflows,
  governance, and maintainable multi-agent architecture.
allowed-tools: Bash Read Write Edit Grep Glob
metadata:
  tags: agentic-ai, microsoft, enterprise, governance, orchestration
  version: "1.0"
  source: microsoft/agent-framework
---

# Microsoft Agent Framework

## When to use this skill
- 조직/팀 단위로 유지되는 에이전트 시스템 설계가 필요할 때
- 책임분리, 거버넌스, 감사 가능한 실행로그가 필요할 때
- 단발성 데모가 아니라 운영/확장 가능한 구조가 필요할 때

## Instructions

### Step 1) 역할 분리 모델 확정
- Planner / Executor / Reviewer / Approver 역할을 분리
- 역할 간 입력/출력 계약(스키마) 먼저 정의
- 승인 단계(Approver)가 필요한 작업군을 선별

### Step 2) 제어흐름 정의
- 동기/비동기 경로 구분
- 실패 시 보상 트랜잭션 또는 롤백 전략 설정
- SLA(응답시간/재시도/중단조건) 명문화

### Step 3) 정책 경계 설정
- 데이터 접근 범위(읽기/쓰기/외부전송) 역할별 제한
- 민감정보 마스킹/로그 보존 정책 적용
- 자동 실행 범위와 인간 승인 범위를 분리

### Step 4) 운영 관측성 구축
- 단계별 trace id 부여
- 실패 원인 분류(정책,도구,모델,입력)
- 주기적 회귀 점검용 시나리오 유지

## Examples
- 요청: "부서 간 승인 흐름을 포함한 에이전트 운영체계를 만들고 싶다"
- 적용: Planner→Executor→Reviewer→Approver 파이프라인 구성
- 결과: 감사 가능한 승인 이력과 실패 복구 경로 확보

## Best practices
1. 역할 분리는 프롬프트 문체가 아니라 권한 경계 중심으로 한다.
2. 승인 없는 자동화는 저위험 작업으로 제한한다.
3. 관측성 없는 최적화는 금지하고, 로그 체계를 먼저 만든다.

## References
- https://github.com/microsoft/agent-framework