에이전트 365 CLI setup 명령 참조

중요합니다

Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.

각 단계를 세부적으로 제어하여 에이전트 365 환경을 설정합니다. 이 명령은 에이전트 365 청사진에 대한 초기 설정 워크플로를 관리합니다.

미엄 역할 필요: Azure 기여자 + 글로벌 관리자

문법

a365 setup [command] [options]

Options

Option	Description
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

권장 실행 순서

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

또는 모든 단계를 한 번에 실행합니다.

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

에이전트 365 설정에 대한 필수 구성 요소의 유효성을 검사합니다. 모듈식 요구 사항 검사를 실행하고 발견한 문제에 대한 지침을 제공합니다.

a365 setup requirements [options]

이 명령은 다음 단계를 실행합니다.

• 에이전트 365 설정에 필요한 모든 필수 구성 요소를 확인합니다.
• 자세한 해결 지침으로 문제를 보고합니다.
• 일부 검사가 실패하더라도 모든 요구 사항을 계속 확인합니다.
• 마지막에 있는 모든 검사에 대한 요약을 제공합니다.

requirements 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	모든 검사에 대한 자세한 출력을 표시합니다.
--category <category>	Azure, Authentication 또는 Configuration 같은 특정 범주에 대해서만 검사를 실행합니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

setup infrastructure

Azure 인프라를 만듭니다.

미엄 필수 권한: Azure 구독 기여자 또는 소유자

a365 setup infrastructure [options]

infrastructure 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	자세한 출력을 표시합니다.
--dry-run	실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

setup blueprint

에이전트 청사진(Entra ID 애플리케이션 등록)을 만듭니다.

최소 필수 권한: 에이전트 ID 개발자 역할

a365 setup blueprint [options]

blueprint 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	자세한 출력을 표시합니다.
--dry-run	실행하지 않고 수행할 작업을 표시합니다.
--no-endpoint	메시징 엔드포인트를 등록하지 마세요(청사진만 해당).
--endpoint-only	메시징 엔드포인트만 등록합니다. 기존 청사진이 필요합니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

setup permissions

OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다.

최소 필수 권한: 전역 관리자

a365 setup permissions [command] [options]

Options

Option	Description
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

하위 명령

하위 명령	Description
mcp	MCP 서버 OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다.
bot	메시징 봇 API OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다.
custom	에이전트 작업에 필요한 표준 사용 권한을 초과하는 사용자 지정 API 권한을 에이전트 청사진에 적용합니다.
copilotstudio	Power Platform API를 통해 Copilot Studio 부조종사를 호출하도록 에이전트 청사진에 대한 OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다.

setup permissions mcp

MCP 서버 OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다.

최소 필수 권한: 전역 관리자

a365 setup permissions mcp [options]

이 명령은:

• 에 지정된 값을 ToolingManifest.json 읽습니다 deploymentProjectPatha365.config.json.
• 각 MCP 서버 범위에 대한 OAuth2 위임된 권한 부여를 에이전트 청사진에 부여합니다.
• 에이전트 인스턴스가 MCP 도구에 액세스할 수 있도록 상속 가능한 권한을 구성합니다.
• idempotent이며 여러 번 실행해도 안전합니다.

중요합니다

• 이 명령을 실행하기 전에 실행 a365 config display 하여 업데이트deploymentProjectPath된 항목이 ToolingManifest.json 포함된 프로젝트 폴더를 가리키는지 확인합니다. 개발자가 다른 컴퓨터에 MCP 서버를 추가하는 경우 먼저 업데이트 ToolingManifest.json 된 서버를 전역 관리자와 공유합니다. 올바른 ToolingManifest.json 권한 없이 실행해도 청사진에 새 MCP 서버 권한이 추가되지는 않습니다.
• 개발자가 실행 한 후 이 명령을 실행합니다 a365 develop add-mcp-servers. 매니페스트에 MCP 서버를 추가하고 청사진에 권한을 부여하는 단계는 두 가지입니다. 이 명령이 완료되면 MCP 서버 권한이 에이전트 청사진에 표시됩니다.

permissions mcp 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	자세한 출력을 표시합니다.
--dry-run	실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

setup permissions bot

메시징 봇 API OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다.

최소 필수 권한: 전역 관리자

필수 구성 요소: 청사진 및 MCP 권한(먼저 실행 a365 setup permissions mcp )

Next 단계: 에이전트 배포(Azure 호스팅하는 경우 a365 deploy 실행)

a365 setup permissions bot [options]

permissions bot 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	자세한 출력을 표시합니다.
--dry-run	실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

setup permissions custom

에이전트 작업에 필요한 표준 사용 권한을 초과하는 사용자 지정 API 권한을 에이전트 청사진에 적용합니다. 이 명령을 사용하면 에이전트에 프레즌스, 파일 및 채팅과 같은 추가 Microsoft Graph 범위 또는 조직의 Entra ID 테넌트에 등록된 사용자 지정 API에 대한 액세스 권한을 부여합니다.

최소 필수 권한: 전역 관리자

필수 구성 요소: 먼저 실행 a365 setup blueprint 합니다. 이 명령을 실행하기 a365.config.json 전에 사용하여 a365 config permissions 사용자 지정 권한을 추가합니다.

a365 setup permissions custom [options]

이 명령은:

• 구성된 각 리소스에 대한 관리자 동의를 사용하여 OAuth2 위임된 권한 부여를 구성합니다.
• 에이전트 사용자가 청사진에서 액세스를 상속할 수 있도록 상속 가능한 권한을 설정합니다.
• 새 권한을 추가하고 구성에서 삭제된 모든 권한을 제거하여 Microsoft Entra 현재 구성과 조정합니다.
• idempotent이며 여러 번 실행해도 안전합니다.

permissions custom 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	자세한 출력을 표시합니다.
--dry-run	실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

사용자 지정 권한 구성

이 명령을 실행하기 전에 구성에 사용자 지정 권한을 추가하는 데 사용합니다 a365 config permissions .

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

리소스 이름은 설치 중에 Azure 자동으로 확인됩니다. 구성에서 지정할 필요가 없습니다.

사용자 지정 권한 제거

구성 및 Microsoft Entra 모두에서 사용자 지정 권한을 제거하려면 다음을 수행합니다.

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

setup all 통합

구성에 사용자 지정 권한이 포함되어 있으면 자동으로 a365 setup all 구성됩니다. 전체 설정 순서는 다음과 같습니다.

1. 인프라
2. 청사진
3. MCP 권한
4. Bot API 권한
5. 사용자 지정 청사진 권한(구성된 경우)
6. 메시지 끝점

setup permissions copilotstudio

Power Platform API를 통해 Copilot Studio 부조종사를 호출하도록 에이전트 청사진에 대한 OAuth2 권한 부여 및 상속 가능한 권한을 구성합니다.

최소 필수 권한: 전역 관리자

필수 구성 요소: 먼저 실행 a365 setup blueprint 합니다.

a365 setup permissions copilotstudio [options]

이 명령은:

• Power Platform API 서비스 주체가 테넌트에 있는지 확인합니다.
• 범위를 사용하여 청사진에서 Power Platform API로 OAuth2 권한 부여를 CopilotStudio.Copilots.Invoke 만듭니다.
• 에이전트 인스턴스가 Copilot Studio 부조종사를 호출할 수 있도록 상속 가능한 권한을 설정합니다.

permissions copilotstudio 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	자세한 출력을 표시합니다.
--dry-run	실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.

에이전트가 런타임에 Copilot Studio 부조종사를 호출하거나 CopilotStudio 권한이 필요한 Power Platform API를 호출해야 하는 경우 이 명령을 사용합니다.

setup all

모든 설정 단계를 수행하여 에이전트 365 환경 설정

a365 setup all [options]

전체 에이전트 365 설치 프로그램을 실행하며 모든 단계를 순서대로 실행합니다.

포함: 인프라, 청사진, 사용 권한 및 엔드포인트.

최소 필수 권한 (전역 관리자에게 이러한 모든 권한이 있음):

• Azure 구독 기여자(인프라 및 엔드포인트용)
• 에이전트 ID 개발자 역할(청사진 만들기용)
• 전역 관리자(권한 부여 및 관리자 동의)

setup all 옵션

Option	Description
-c, --config <config>	구성 파일 경로입니다. 기본값은 a365.config.json입니다.
-v, --verbose	자세한 출력을 표시합니다.
--dry-run	실행하지 않고 수행할 작업을 표시합니다.
--skip-infrastructure	Azure 인프라 만들기를 건너뜁니다(인프라가 이미 있는 경우 사용). 이 옵션은 청사진, 사용 권한 및 엔드포인트를 계속 만듭니다.
--skip-requirements	요구 사항 유효성 검사 건너뛰기 주의해서 사용: 필수 구성 요소가 충족되지 않으면 설정이 실패할 수 있습니다.
-?, , -h--help	도움말 및 사용 정보를 표시합니다.