에이전트 365 CLI
중요합니다
Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.
구성된 Azure App Service 에이전트 365 애플리케이션 이진 파일을 배포하고 에이전트 365 도구 권한을 업데이트합니다. deploy 명령은 에이전트 365 배포를 만드는 옵션을 제공합니다. 이 명령을 사용하여 Azure 인프라에 애플리케이션 이진 파일을 배포하고 에이전트 365 도구 권한을 부여합니다.
이 명령을 사용하는 방법에 대한 자세한 내용은
문법
a365 deploy [command] [options]
Options
| Option | Description |
|---|---|
-c, --config <config> |
구성 파일의 경로(기본값: a365.config.json) |
-v, --verbose |
자세한 정보 로깅 사용 |
--dry-run |
실행하지 않고 수행할 작업 표시 |
--inspect |
배포 전에 일시 중지하여 게시 폴더 및 ZIP 콘텐츠 검사 |
--restart |
빌드를 건너뛰고 기존 게시 폴더 압축에서 시작(수동 변경 후 빠른 반복) |
-?, , -h--help |
도움말 및 사용 정보 표시 |
비고
하위 명령 없이 실행 a365 deploy 은 2단계 배포를 실행합니다.
- 파서 1 - 애플리케이션 이진 파일: 애플리케이션을 빌드하고 Azure App Service 배포합니다.
-
2단계 - MCP 권한: 필요한 범위를 읽고
toolingManifest.json필요한 권한으로 에이전트 청사진을 업데이트합니다.
두 단계 모두 에서도 --dry-run실행됩니다. 시험 실행 출력은 레이블이 지정된 두 섹션으로 나뉘므로 각 단계가 수행할 작업을 검토할 수 있습니다.
실행 전 검사
배포하기 전에 CLI는 다음의 유효성을 검사합니다.
-
Azure 인증 및 구독: Azure CLI 세션 및 구독이 유효해야 합니다. 그렇지 않은 경우 오류와 함께 배포가 중지됩니다. 및 .를 사용하여
az login --tenant <TENANT_ID>az account set --subscription <SUBSCRIPTION_ID>수정합니다. -
Azure App Service 존재: 배포가 진행되기 전에 대상 웹앱이 있어야 합니다. 앱을 찾을 수 없으면 실행
a365 setup하거나 수정webAppName하고resourceGroup.a365.config.json
Configuration
CLI는 다음 두 구성 파일에서 읽습니다.
-
a365.config.json- 프로젝트 구성(사용자 유지 관리)입니다. -
a365.generated.config.json— 설치 명령에 의해 생성된 동적 상태입니다.
MCP 도구 범위는 배포 프로젝트 디렉터리에서 toolingManifest.json 읽습니다.
또한 CLI는 구성 및 상태의 전역 복사본을 다음 위치에서 저장합니다.
-
Windows:
%LocalAppData%\Microsoft.Agents.A365.DevTools.Cli -
Linux/macOS:
~/.config/a365
플래그 동작
--restart: 빌드 단계를 건너뛰고 기존 publish/ 폴더 압축에서 직접 시작합니다. 없는 경우 publish/ 배포가 실패합니다. 먼저 전체 배포(제외 --restart)를 실행하여 폴더를 생성합니다 publish/ .
--inspect: 폴더 및 생성된 ZIP 파일을 검사 publish/ 할 수 있도록 업로드 단계 전에 일시 중지합니다. 앱 단계에서만 사용할 수 있습니다.
--dry-run: 변경하지 않고 발생하는 모든 항목을 인쇄합니다. 실행 a365 deploy 시(2단계) 출력은 다음으로 나뉩니다.
- 1부 - 애플리케이션 이진 파일 배포
- 2부 - 에이전트 365 도구 권한 배포/업데이트
deploy app
설치 중에 만든 Azure Web App에 에이전트 코드를 배포합니다.
a365 deploy app [options]
구성된 Azure App Service Microsoft 에이전트 365 애플리케이션 이진 파일을 배포합니다. 이 명령은 Azure 구성된 Azure App Service에 애플리케이션 이진 파일을 배포합니다.
app 옵션
| Option | Description |
|---|---|
-c, --config <config> |
구성 파일의 경로(기본값: a365.config.json) |
-v, --verbose |
자세한 정보 로깅 사용 |
--dry-run |
실행하지 않고 수행할 작업 표시 |
--inspect |
배포 전에 일시 중지하여 게시 폴더 및 ZIP 콘텐츠 검사 |
--restart |
빌드를 건너뛰고 기존 게시 폴더 압축에서 시작(수동 변경 후 빠른 반복) |
-?, , -h--help |
도움말 및 사용 정보 표시 |
deploy mcp
에이전트 청사진에 대한 MCP 서버 권한을 업데이트합니다.
a365 deploy mcp [options]
mcp 옵션
| Option | Description |
|---|---|
-c, --config <config> |
구성 파일 경로(기본값: a365.config.json) |
-v, --verbose |
자세한 정보 로깅 사용 |
--dry-run |
실행하지 않고 수행할 작업 표시 |
-?, , -h--help |
도움말 및 사용 정보 표시 |
사용 현황 정보
기존 에이전트 청사진에 대한 MCP 서버 범위 및 권한을 업데이트합니다. 이 명령은 에이전트 365 도구에 대한 권한을 에이전트 청사진에 추가합니다.
에이전트 코드에서 MCP 서버를 추가하거나 수정하는 경우 이 명령을 사용하여 에이전트 청사진에 대한 권한을 업데이트합니다.
이 명령은:
- 코드에서 MCP 서버 구성을 읽습니다.
- 필요한 권한으로 에이전트 청사진을 업데이트합니다.
- MCP 서버에 필요한 API 권한을 부여합니다.
권한 업데이트는 다음 순서로 적용됩니다.
- OAuth2 권한 부여(청사진 서비스 주체 → MCP 플랫폼)
- 상속 가능한 권한(에이전트 청사진 → MCP 리소스)
- 관리자 동의(에이전트 ID → MCP 플랫폼)
사용 deploy mcp시기:
- 에이전트에 새 MCP 서버를 추가한 후
- MCP 서버 구성을 변경한 후
- 에이전트가 MCP 도구에 액세스할 수 없는 경우
다음을 실행할 deploy mcp필요가 없습니다.
- 초기 배포 시. 설치하는 동안 자동으로 처리됩니다.
- MCP 변경 없이 에이전트 논리만 변경하는 경우
- 도구에 영향을 주지 않는 일상적인 코드 업데이트 후.
비고
a365 deploy mcp 만 권한을 업데이트 - 그것은 당신의 코드를 배포하지 않습니다. 코드가 변경된 경우 먼저 실행 a365 deploy app 합니다.
Troubleshooting
다음 섹션을 사용하여 명령의 잠재적인 문제를 해결합니다 deploy .
Azure 또는 잘못된 구독에 로그인되지 않음
az login --tenant <TENANT_ID> 및 az account set --subscription <SUBSCRIPTION_ID>을 실행합니다.
웹앱을 찾을 수 없음
실행되었는지 확인 a365 setup 하거나 webAppNameresourceGroupa365.config.json.
권한 업데이트 실패
- 확인
AgentBlueprintId,AgenticAppId및 환경이 설정됩니다a365.config.json. - 계정에 서비스 주체 및 부여를 관리할 권한이 있는지 확인합니다.
-
toolingManifest.json배포 프로젝트 디렉터리에 있고 유효한 범위가 포함되어 있는지 확인합니다.
--restart 실패
폴더를 생성하지 않고 --restart 전체 배포를 실행한 publish/ 다음 후속 반복에 사용합니다 --restart .
로그
CLI 로그 파일은 다음 위치에서 저장됩니다.
-
Windows:
%LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\ -
Linux/macOS:
~/.config/a365/logs/
최신 배포 로그 파일의 마지막 80줄을 보려면 Windows Get-Content 또는 Linux/macOS의 tail 사용합니다.
# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80
# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log
런타임 애플리케이션 로그의 경우 Azure Portal에서 Log Stream을 사용하여 App Service의 stdout/stderr를 만듭니다.