OfficeDev/microsoft-365-agents-toolkit

Microsoft 365 Agents Toolkit

무엇인가요 – Microsoft 365 Copilot, Microsoft Teams, Office 애드인용 에이전트 및 기타 확장 기능을 생성, 실행, 디버그, 배포하는 데 도움이 되는 개발자 도구 세트(Visual Studio Code 확장, Visual Studio 확장, CLI)입니다. 이 툴킷은 스텁 생성, 인증 헬퍼, 서버리스 함수 통합, CI/CD 템플릿을 통합하여 앱의 AI 기반 로직에 집중할 수 있도록 인프라 구축 작업을 최소화합니다.

핵심 구성 요소

패키지	역할
vscode-extension	Visual Studio Code 내에 워즈드, 핫리로드, 보안 터널링, 플레이그라운드를 추가하는 IDE 플러그인.
cli	동일한 기능의 명령줄 버전 – 키보드 중심 워크플로우 또는 CI 파이프라인에 유용.
sdk	클라이언트 사이드 및 서버 사이드 코드 양쪽에서 Microsoft 365 인증을 추상화하는 경량 라이브러리.
api	제3자 플러그인의 툴킷 확장을 가능하게 하는 타입 정의 및 계약.
fx-core	IDE와 CLI에서 공유되는 구현(프로젝트 수준 설정, 라이프사이클 관리 등).
function-extension	인증 지원이 포함된 Teams 앱에 자동으로 연결되는 Azure Functions 추가를 위한 헬퍼.
spec-parser	OpenAPI 사양에서 API 기반 메시지 확장 코드와 Adaptive Card 스텁을 생성합니다.

주요 기능

• Copilot 에이전트, Teams 챗봇, 탭, 메시지 확장, Office 애드인용 엔드투엔드 스텁 생성.
• Microsoft 365 리소스용 통합 인증(싱글사인온).
• 핫리로드 및 보안 터널링을 갖춘 풀스택 디버깅, 빠른 반복을 위한 "에이전트 플레이그라운드".
• Azure Functions를 통한 서버리스 백엔드, 내장된 인증 처리.
• CI/CD 지원 – 미리 구성된 GitHub Actions 및 Azure DevOps 파이프라인.
• 다국어 지원 – CLI/VS Code 확장으로 JavaScript/TypeScript, Visual Studio 확장으로 .NET.

일반적인 사용 사례

1. SharePoint, Outlook 또는 커스텀 API에서 데이터를 가져와 자연어 질의에 응답할 수 있는 Microsoft 365 Copilot 에이전트 구축.
2. Teams AI 라이브러리를 활용해 로컬에서 핫리로드로 실행 가능한 Teams 챗봇 생성.
3. OpenAPI 설명에서 자동으로 생성되는 커스텀 메시지 확장(예: Adaptive Card UI) 추가.
4. 봉쇄 코드 없이 Azure Functions를 사용해 Teams 앱의 서버리스 백엔드 배포.

시작하기

• VS Code: Marketplace에서 Microsoft 365 Agents Toolkit 확장을 설치하고 "새 프로젝트 만들기" 워즈드를 실행.
• Visual Studio: 해당 확장을 설치하고 .NET 에이전트용 프로젝트 템플릿을 사용.
• CLI: npm install -g @microsoft/m365agentstoolkit-cli 후 m365 init로 새 프로젝트 스텁 생성, m365 run으로 로컬 디버깅 시작, m365 deploy로 Azure에 배포.
• 자세한 문서는 https://aka.ms/teamsfx-docs 에서 확인 가능.

커뮤니티 및 지원

• 이슈 및 기능 요청: https://github.com/OfficeDev/TeamsFx/issues
• 질문: Stack Overflow 태그 teams-toolkit
• 직접 피드백: ttkfeedback@microsoft.com

라이선스 및 거버넌스

• 리포지토리는 Microsoft의 Modern Lifecycle Policy를 따르며, 외부 기여에는 기여자 라이선스 계약(CLA)이 포함됩니다. 기본적으로 텔레메트리가 수집되며, VS Code FAQ에서 옵트아웃 방법을 확인할 수 있습니다.

---

위 정보는 리포지토리의 README에서 직접 가져왔습니다.