다음을 통해 공유

에이전트 365 CLI config 명령 참조

중요합니다

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

에이전트 365 CLI 구성을 관리합니다. 에이전트 365 CLI 구성 설정을 관리하는 옵션을 제공합니다. 대화형으로 새 구성을 초기화하거나 현재 구성 설정을 표시할 수 있습니다.

필요한 최소 역할: 없음(로컬 구성)

문법

a365 config [command] [options]

Options

Option Description
-?, , -h--help 도움말 및 사용 정보 표시

config init

에이전트 365 CLI를 대화형으로 구성하거나 파일에서 가져옵니다.

a365 config init [options]

이 명령을 사용하여 대화형 프로세스를 통해 또는 기존 구성 파일에서 설정을 가져와 에이전트 365 CLI 구성을 설정합니다.

init 옵션

Option Description
-c, --configfile <configfile> 가져올 기존 구성 파일의 경로
-g, --global 현재 디렉터리 대신 AppData(전역 디렉터리)에서 구성 만들기
-?, , -h--help 도움말 및 사용 정보 표시

비고

이 config init 명령은 수동 입력을 최소화하는 대화형 마법사를 시작합니다.

  • Azure CLI 통합: 구독, 테넌트, 리소스 그룹, 앱 서비스 계획 및 지역을 자동으로 검색합니다.
  • 스마트 기본값: 에이전트 이름 및 타임스탬프(예 myagent-webapp-11140916: )에서 리소스 이름을 생성합니다. 저장하기 전에 이러한 이름을 사용자 지정할 수 있습니다.
  • Platform 검색: 배포 프로젝트 경로에서 프로젝트 형식(.NET, Node.js, Python)을 검색하고 지원되는 형식이 없으면 경고합니다.
  • 클라이언트 앱 유효성 검사: Entra 테넌트에 대해 클라이언트 앱 ID의 유효성을 검사하여 필요한 권한이 구성되고 관리자 동의가 부여되었는지 확인합니다. 마법사가 종료되기 전에 최대 세 번의 시도가 있습니다.

구성 청사진 사용 권한(선택 사항): 마법사에는 Teams 현재 상태 또는 OneDrive 파일과 같은 추가 외부 리소스에 대한 권한을 구성하는 선택적 단계가 포함되어 있습니다. 대부분의 에이전트는 이를 요구하지 않습니다. 을 사용하여 a365 config permissions초기 설치 후 권한을 구성할 수도 있습니다.

기존 구성 업데이트: 다시 실행 a365 config init 하면 현재 a365.config.json 가 기본값으로 로드됩니다. 각 프롬프트에서 Enter 키를 눌러 현재 값을 유지하거나 새 값을 입력하여 업데이트합니다.

config display

현재 에이전트 365 CLI 구성을 표시합니다.

a365 config display [options]

이 명령은 에이전트 365 CLI에 대한 현재 구성 설정을 표시하므로 현재 설정을 검토할 수 있습니다.

display 옵션

Option Description
-g, --generated 생성된 구성 표시(a365.generated.config.json)
-a, --all 정적 구성과 생성된 구성 모두 표시
-?, , -h--help 도움말 및 사용 정보 표시

구성 파일 구조

CLI는 다음 키 속성과 함께 JSON 구성 파일(a365.config.json)을 사용합니다.

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}
  • Last updated on