microsoft/OpenAIWorkshop

이것은 무엇인가요?

Microsoft의 AI 도구를 사용하여 AI 에이전트(단순한 채팅을 넘어 스스로 행동을 취할 수 있는 소프트웨어)를 설계, 구축 및 배포하는 방법을 배우기 위한 무료 오픈 소스 코드, 문서 및 샘플 시나리오 모음입니다. 이 자료는 자기 주도형 워크숍으로 구성되어 있어, 비즈니스 시나리오를 따라가며 샘플 코드를 시도하고 다양한 에이전트 설계를 실험해 볼 수 있습니다.

무엇을 할 수 있나요?

현실적인 비즈니스 문제를 해결하기 위한 AI 에이전트 설계 및 프로토타입 제작
다양한 에이전트 구성 비교 — 단일 에이전트, 여러 에이전트의 협업, 에이전트 간 작업 전달
완전한 시스템 구축 — 데이터베이스 및 백엔드 도구부터 에이전트 오케스트레이션, 웹 프론트엔드(React 또는 Streamlit)까지
엔터프라이즈급 보안을 갖춘 Azure 배포 (프라이빗 네트워크, 관리 ID, 자동화된 CI/CD)

주요 기술

Microsoft Agent Framework — 다중 에이전트의 오케스트레이션, 에이전트 간 작업 전달 및 체크포인트 처리 관리
MCP (Model Context Protocol) Server — 인증 및 역할 기반 액세스 제어를 통해 에이전트에 추가 도구(데이터베이스 액세스 등)를 제공하는 표준 방식
워크플로우 오케스트레이션 — "팬아웃/팬인" 패턴(병렬 작업 병합), 인간 승인 단계, 실시간 모니터링을 포함한 지속 가능한 작업 시스템. 사기 탐지 데모 포함
관측 가능성 — 에이전트의 동작, 호출된 도구, AI 모델 호출 방식에 대한 전체 추적 및 사전 구축된 Grafana 대시보드 제공
에이전트 평가 — 사용자 정의 지표 및 데이터 세트를 사용한 에이전트 성능 테스트
상태 지속성 — 대화 기록 및 에이전트 상태를 메모리 또는 CosmosDB에 저장
Infrastructure-as-code — 프로덕션 배포를 위한 Terraform/Bicep 템플릿
CI/CD 파이프라인 — 개발자별 환경 및 평가 게이트를 포함한 개발에서 프로덕션으로의 자동 승격

시작하는 방법

README에는 6단계 경로가 안내되어 있습니다:

설정 지침 검토
비즈니스 시나리오 및 에이전트 설계 읽기
다중 에이전트 패턴(단일, Magentic 오케스트레이션 또는 작업 전달) 선택
인간이 개입하는 지속 가능한 사기 탐지 워크플로우 시도
사용자 정의 전 시스템 아키텍처 연구
문제 해결을 위한 지원 가이드 활용

배포 옵션

문서화된 4가지 배포 방법:

Azure Developer CLI — 한 번의 명령어로 빠른 시작
수동 배포 — Terraform/Bicep을 사용하는 PowerShell
엔터프라이즈 보안 — VNet, 프라이빗 엔드포인트, 관리 ID
GitHub Actions CI/CD — OIDC 인증 포함

참고 사항

LICENSE 파일의 조건에 따라 라이선스가 부여됩니다
행동 강령 및 보안 지침이 포함되어 있습니다
Microsoft는 추가 참조를 위해 Agent Framework 프로젝트에 대한 링크를 명시하고 있습니다