에이전트 365 CLI 참조는 Microsoft 365용 AI 에이전트를 빌드하고 관리하기 위한 포괄적인 명령줄 인터페이스입니다. 에이전트 365 CLI를 시작하는 방법에 대해 알아봅니다.
Global options
모든 명령은 다음과 같은 전역 옵션을 지원합니다.
-
--version: 버전 정보를 표시합니다. -
-?,-h--help: 도움말 및 사용 정보를 표시합니다.
Commands
다음 표에서는 사용 가능한 명령을 나열합니다.
Tip
각 명령에는 특정 역할 요구 사항이 있습니다. 각 명령을 실행하는 데 필요한 최소 역할은 개별 명령 참조 페이지를 참조하세요. 예를 들어 setup 명령에는 Azure 참가자 + Agent ID Developer 필요합니다.
글로벌 관리자는 OAuth2 권한 부여에만 필요합니다; 글로벌 관리자가 다른 사람일 때는 a365 setup all 그들이 완료해야 할 다음 단계를 출력합니다. S2S(서버간) 에이전트 신원 부여(--authmode s2s 또는 both)는 에이전트 ID 관리자 이상이 필요합니다.
| Command | Description |
|---|---|
cleanup |
ALL 리소스(청사진, 인스턴스 및 Azure)를 정리합니다. 세분화된 정리를 위해 하위 명령을 사용합니다. |
cleanup azure |
Azure 리소스를 제거합니다(App Service, App Service 계획). |
cleanup blueprint |
Entra ID 청사진 애플리케이션 및 서비스 주체를 제거합니다. |
cleanup instance |
Entra ID 에이전트 인스턴스 ID 및 사용자를 제거합니다. |
develop |
에이전트 개발을 위한 MCP 도구 서버를 관리합니다. |
develop add-mcp-servers |
현재 에이전트 구성에 MCP 서버를 추가합니다. |
develop add-permissions |
MCP 서버에 액세스하도록 사용자 지정 애플리케이션을 구성해야 하는 개발 시나리오의 Microsoft Entra 애플리케이션에 MCP 서버 API 권한을 추가합니다. |
develop get-token |
대화형 브라우저 인증을 사용하여 개발하는 동안 MCP 서버를 테스트하기 위한 전달자 토큰을 검색합니다. |
develop list-available |
카탈로그에서 사용할 수 있는 모든 MCP 서버를 나열합니다(설치할 수 있는 항목). |
develop list-configured |
로컬 ToolingManifest.json에서 현재 구성된 MCP 서버를 나열합니다. |
develop remove-mcp-servers |
현재 에이전트 구성에서 MCP 서버를 제거합니다. |
develop start-mock-tooling-server |
테스트 및 개발 목적으로 모의 도구 서버를 시작합니다. |
develop-mcp |
Dataverse 환경에서 MCP 서버를 관리합니다. |
develop-mcp approve |
MCP 서버를 승인합니다. |
develop-mcp block |
MCP 서버를 차단합니다. |
develop-mcp list-environments |
MCP 서버 관리에 사용할 수 있는 모든 Dataverse 환경을 나열합니다. |
develop-mcp list-servers |
특정 Dataverse 환경에서 MCP 서버를 나열합니다. |
develop-mcp package-mcp-server |
Microsoft 관리 센터에서 제출할 MCP 서버 패키지를 생성합니다. |
develop-mcp publish |
Dataverse 환경에 MCP 서버를 게시합니다. |
develop-mcp register-external-mcp-server |
Entra, 외부 OAuth, API 키, 또는 인증 없이 외부 MCP 서버를 등록하세요. |
develop-mcp unpublish |
Dataverse 환경에서 MCP 서버를 게시 취소합니다. |
logs |
CLI 진단 로그를 관리하세요.
logs 명령어는 Microsoft 지원팀과 안전하게 공유할 수 있는 가린 편집된 CLI 로그 파일을 내보내줍니다. |
logs export |
Microsoft 지원팀과 안전하게 공유할 수 있는 CLI 진단 로그 파일의 편집된 복사본을 내보내세요. JWT 토큰, 이메일 주소, GUID, OS 경로 사용자 이름을 삭제하고, 동일한 값을 일관된 별칭으로 대체하여 로그 상관관계를 유지합니다. |
publish |
manifest.json ID 값을 업데이트하고 Microsoft 365 관리 센터 업로드할 manifest.zip 패키지를 만듭니다. |
query-entra |
범위, 권한 및 동의 상태를 포함하여 에이전트 정보에 대한 Microsoft Entra ID 쿼리하는 옵션을 제공합니다. |
query-entra blueprint-scopes |
에이전트 청사진에 대해 구성된 범위 및 동의 상태를 나열합니다. |
query-entra instance-scopes |
에이전트 인스턴스에 대해 구성된 범위 및 동의 상태를 나열합니다. |
setup |
각 단계를 세부적으로 제어하여 에이전트 365 환경을 설정합니다. |
setup all |
모든 설정 단계를 수행하여 에이전트 365 환경 설정 |
setup blueprint |
에이전트 청사진(Entra ID 애플리케이션 등록)을 만듭니다. |
setup permissions |
OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다. |
setup permissions bot |
메시징 봇 API OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다. |
setup permissions copilotstudio |
Power Platform API를 통해 Copilot Studio 부조종사를 호출하도록 에이전트 청사진에 대한 OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다. |
setup permissions custom |
에이전트 작업에 필요한 표준 사용 권한을 초과하는 사용자 지정 API 권한을 에이전트 청사진에 적용합니다. |
setup permissions mcp |
MCP 서버 OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다. |
setup requirements |
에이전트 365 설정에 대한 필수 구성 요소의 유효성을 검사합니다. |