NuGet
Downloads
Build Status
License
.NET
Contributors
참고:
이 오픈 소스 프로젝트에 기여하려면 이 README의 정보를 사용하세요. 프로젝트에서 이 CLI를 사용하는 방법에 대해서는 Microsoft Agent 365 CLI 문서를 참조하세요.
Microsoft Agent 365 DevTools CLI는 Microsoft Agent 365 애플리케이션의 개발, 배포 및 관리를 간소화하도록 설계된 커맨드라인 인터페이스(CLI) 도구입니다. 이 CLI는 구성 관리, Azure 리소스 프로비저닝, MCP (Model Context Protocol) 서버 통합, 그리고 에이전트 배포 워크플로우를 위한 포괄적인 도구를 제공합니다.
기능
Microsoft Agent 365 DevTools CLI는 Agent 365 개발자의 여정 전반에 걸쳐 사용될 수 있습니다. 이 CLI는 다음 명령들을 제공합니다:
- develop: 에이전트 개발을 위한 MCP 도구 서버 관리
- develop-mcp: Dataverse 환경에서 MCP 서버 관리
- setup: Azure 리소스를 생성하고, 권한을 구성하며, 배포를 위해 에이전트 청사진(blueprint)을 등록하여 Agent 365 환경 설정
- publish: 에이전트 매니페스트 ID를 업데이트하고 Microsoft 365 관리 센터에 업로드할 매니페스트 패키징. 업로드 후 Teams를 통해 에이전트를 고용하여 온보딩을 완료합니다.
- logs: Microsoft 지원팀과 공유하기 안전한 편집된 CLI 진단 로그 내보내기
- query-entra: 에이전트 정보(범위, 권한, 동의 상태)에 대해 Microsoft Entra ID 조회
- cleanup: 모든 리소스(청사진, 인스턴스, 기타 Azure 리소스) 정리
Please help improve the Microsoft Agent 365 SDK and CLI by taking our survey: Agent365 SDK Integration Feedback Survey
현재 프로젝트 상태 (Current Project State)
이 프로젝트는 현재 활발하게 개발 중입니다. 커뮤니티의 피드백을 바탕으로 CLI가 적극적으로 개발되고 개선되고 있습니다.
설치 (Installation)
필수 조건 (Prerequisites)
시스템 요구 사항 (System Requirements):
- .NET 8.0 이상: CLI는 .NET 8.0 런타임 또는 그 이후 버전(예: .NET 9, 10)을 필요로 합니다. **.NET 다운로드
Entra ID 앱 등록 (App Registration):
Agent365 CLI를 사용하기 전에, 특정 Microsoft Graph API 권한이 부여된 사용자 지정 Entra ID 앱 등록을 생성해야 합니다:
- 사용자 지정 클라이언트 앱 등록: Entra ID 테넌트에서 앱을 생성합니다.
- 필수 권한 (Required Permissions): 코드베이스의
AuthenticationConstants.RequiredClientAppPermissions에 정의된 대로 위임된(delegated) 권한(Application이 아님)을 구성해야 합니다.
- 관리자 동의 (Admin Consent): 모든 권한에 대해 관리자 동의를 부여합니다.
⚠️ 중요: 위임된(Delegated) 권한(사용자가 로그인하고, CLI가 사용자를 대신하여 작동함)을 사용하고, Application 권한(백그라운드 서비스용)은 사용하지 마십시오.
📖 상세 설정 가이드 (Detailed Setup Guide): Custom Client App Registration
이것이 필요한 이유: CLI는 테넌트 내에서 Agent Identity Blueprints를 생성하고 관리하기 위해 높은 수준의 권한(elevated permissions)이 필요합니다. 사용자는 어떤 권한을 부여할지 통제권을 유지하며, 앱은 테넌트의 보안 경계 내에 머무릅니다.
CLI 설치 (Install the CLI)
NuGet에서 (Production):
dotnet tool install -g Microsoft.Agents.A365.DevTools.Cli --prerelease
문서 (Documentation)
CLI 및 필수 조건에 대해 더 자세히 알고 싶다면:
사용 방법 및 명령어 참조:
지원 (Support)
문제, 질문 또는 피드백이 있으시면 다음을 참고해 주세요:
기여 (Contributing)
본 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여에는 사용자가 본인의 기여물에 대한 권리를 가지고 있으며 실제로 우리에게 해당 권리를 부여한다는 내용의 기여자 라이선스 계약(Contributor License Agreement, CLA) 동의가 필요합니다. 자세한 내용은 https://cla.opensource.microsoft.com을 방문해 주십시오.
풀 리퀘스트(pull request)를 제출할 때, CLA 봇이 사용자가 CLA를 제공해야 하는지 자동으로 판단하고 PR에 적절하게 표시합니다 (예: 상태 확인, 댓글). 단순히 봇이 제공하는 지침을 따라주시면 됩니다. 이 CLA는 우리 CLA를 사용하는 모든 저장소에서 단 한 번만 진행하시면 됩니다.
본 프로젝트는 Microsoft Open Source Code of Conduct를 채택했습니다. 더 많은 정보는 Code of Conduct FAQ를 참고하거나, 추가 질문이나 의견이 있으시면 [email protected]으로 문의해 주십시오.
유용한 링크 (Useful Links)
Microsoft Agent 365 SDK와 함께 CLI 사용하기
추가 자료 (Additional Resources)
상표권 (Trademarks)
Microsoft, Windows, Microsoft Azure 및/또는 문서에 언급된 기타 Microsoft 제품 및 서비스는 미국 및/또는 다른 국가에서 Microsoft의 상표 또는 등록 상표일 수 있습니다. 본 프로젝트의 라이선스는 귀하에게 모든 Microsoft 이름, 로고 또는 상표를 사용할 권리를 부여하지 않습니다. Microsoft의 일반적인 상표 가이드라인은 http://go.microsoft.com/fwlink/?LinkID=254653에서 확인할 수 있습니다.
라이선스
Copyright (c) Microsoft Corporation. All rights reserved.
MIT License에 따라 라이선스가 부여됩니다 - 자세한 내용은 [LICENSE] 파일을 참조하십시오.
