pac copilot

부조종사 관리를 위한 도구 및 유틸리티.

init, clone, pull및 pushpack 명령을 사용하면 Copilot Studio 에이전트를 디스크의 파일 집합으로 유지하고, 로컬로 편집하고, Dataverse 환경과 동기화할 수 있습니다.

일반적인 루프는 다음과 같습니다.

  1. 작업 영역을 시작합니다. 를 사용하여 새 에이전트를 스캐폴드하거나 기존 에이전트 pac copilot init를 다운로드합니다 pac copilot clone. 어느 쪽이든 다른 명령이 의존하는 동기화 메타데이터를 전달하는 로컬 작업 영역을 가져옵니다.
  2. 편집하기 전에 끌어오기. pac copilot pull 는 원격 변경 내용을 다운하고 로컬 파일에 병합하므로 현재 서버 상태에서 시작합니다.
  3. 완료되면 푸시합니다. pac copilot push 는 로컬 변경 내용을 다시 보냅니다. 그 동안 서버에서 동일한 항목이 변경된 경우 푸시가 중지되고 먼저 끌어오도록 요청합니다.
  4. 배포용 패키지입니다. pac copilot pack 를 사용하여 작업 영역을 배포할 수 있는 솔루션 .zip 으로 pac solution import바꿉니다.

한 단계로 pac copilot init --environment 아무것도 없는 에이전트에서 라이브 에이전트로 이동하려면 작업 영역을 스캐폴드, 팩, 가져오기 및 연결합니다. 개별 명령을 사용하면 루프의 각 부분을 자체적으로 구동할 수 있습니다.

Commands

Command Description
pac copilot clone Copilot Studio 에이전트를 로컬 작업 영역 디렉터리에 복제합니다.
pac copilot create 기존 템플릿 파일을 참조로 사용하여 새 부조종사 만들기
pac copilot delete 사용자 지정 Copilot 삭제합니다.
pac copilot extract-template 환경의 기존 부조종사에서 템플릿 파일을 추출합니다.
pac copilot extract-translation 하나 이상의 봇에 대해 지역화된 콘텐츠가 포함된 파일을 추출합니다.
pac copilot init 템플릿에서 새 Copilot Studio 에이전트 작업 영역을 만듭니다.
pac copilot list 현재 또는 대상 Dataverse 환경의 부조종사 목록입니다.
pac copilot mcp 로컬 MCP(모델 컨텍스트 프로토콜) 서버에 대한 정보입니다.
pac copilot merge-translation 하나 이상의 봇에 대해 지역화된 콘텐츠가 포함된 파일을 병합합니다.
pac copilot model list 현재 환경의 AI Builder 모델
pac copilot model predict AI 모델에 텍스트 또는 프롬프트 보내기
pac copilot model prepare-fetch LLM(AI 대규모 언어 모델)에서 FetchXML 파일을 가져와 현재 환경에 대한 실행을 준비합니다.
pac copilot pack Copilot Studio 에이전트 작업 영역을 솔루션 zip 파일로 패키지합니다.
pac copilot publish 사용자 지정 부조종사 게시
pac copilot pull Copilot Studio 원격 변경 내용을 끌어와 로컬 작업 영역과 병합합니다.
pac copilot push 로컬 작업 영역 변경 내용을 Copilot Studio 푸시합니다.
pac copilot quarantine 부조종사 요원의 격리 상태.
pac copilot status 현재 또는 대상 Dataverse 환경에서 지정된 부조종사 배포 상태를 폴링합니다.

pac copilot clone

Copilot Studio 에이전트를 로컬 작업 영역 디렉터리에 복제합니다.

pac copilot clone는 기존 Copilot Studio 에이전트를 로컬 작업 영역 디렉터리에 다운로드하고 해당 메타데이터 pac copilot pull 와 pac copilot push 함께 사용합니다. 에이전트의 파일은 표시 이름 이름을 따서 명명된 하위 폴더에 기록됩니다.

예시

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

에 대한 필수 매개 변수 copilot clone

--bot -id

코필로트 ID 또는 스키마 이름(솔루션 탐색기의 봇 세부 정보 또는 파일 이름에 있는 고유 이름)입니다.

에 대한 선택적 매개 변수 copilot clone

--component-collection -cc

복제할 구성 요소 컬렉션 ID입니다. 여러 횟수에 대해 반복합니다.

--display-name -dn

에이전트의 표시 이름입니다(폴더 이름 지정에 사용됨).

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--output-dir -od

복제 출력을 위한 루트 폴더입니다. 기본값은 현재 디렉터리입니다.

Remarks

  • --bot는 Copilot ID 또는 스키마 이름을 허용합니다. Copilot ID(GUID) 또는 에이전트의 스키마 이름을 전달합니다. 이 명령은 대상 환경에 대한 스키마 이름을 확인합니다.
  • 대상 하위 폴더는 비어 있어야 합니다. 복제는 에이전트의 (삭제됨) 표시 이름 --output-dir아래에 있는 이름을 따서 명명된 폴더에 씁니다. 해당 폴더에 파일이 이미 있는 경우 복제를 덮어쓰지 않고 중지합니다. 다른 폴더 이름을 선택하는 데 사용합니다 --display-name .
  • 구성 요소 컬렉션을 복제합니다. 구성 요소 컬렉션을 에이전트와 함께 가져오려면 세미콜론으로 구분된 하나 이상의 컬렉션 ID를 --component-collection전달합니다.
  • 복제하려면 인증된 프로필(pac auth create)이 필요하고, 생략할 때 활성 프로필의 조직 또는 조직에서 --environment환경을 확인합니다.

pac copilot create

기존 템플릿 파일을 참조로 사용하여 새 부조종사 만들기

에 대한 필수 매개 변수 copilot create

--displayName

새 부조종사 표시 이름

--schemaName

새 부조종사에 대한 스키마 이름(고유 이름)입니다.

--solution -s

솔루션의 이름입니다.

--templateFileName

extract-template 명령을 사용하여 추출된 부조종사 템플릿을 포함하는 원본 yaml 파일입니다.

에 대한 선택적 매개 변수 copilot create

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

pac copilot delete

사용자 지정 Copilot 삭제합니다.

에 대한 필수 매개 변수 copilot delete

--bot -id

코필로트 ID 또는 스키마 이름(솔루션 탐색기의 봇 세부 정보 또는 파일 이름에 있는 고유 이름)입니다.

에 대한 선택적 매개 변수 copilot delete

--confirm -y

부조종사 삭제를 확인하는 데 필요합니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

pac copilot extract-template

환경의 기존 부조종사에서 템플릿 파일을 추출합니다.

예시

이 명령은 환경의 기존 부조종사에서 템플릿 파일을 추출합니다.

pac copilot extract-template `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --templateFileName NewTestCopilot.yaml

이 명령은 영어 및 독일어 언어를 사용하는 부조종사에 대해 다음과 같은 출력을 반환합니다.

Connected as user@contoso.org

Loaded 34 components for bot 'New Test Copilot ' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

New Test Copilot -> C:\Users\user\NewTestCopilot.yaml

에 대한 필수 매개 변수 copilot extract-template

--bot -id

코필로트 ID 또는 스키마 이름(솔루션 탐색기의 봇 세부 정보 또는 파일 이름에 있는 고유 이름)입니다.

--templateFileName

부조종사 템플릿을 쓸 yaml 파일의 위치입니다.

에 대한 선택적 매개 변수 copilot extract-template

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--overwrite -o

출력 데이터 파일이 이미 있는 경우 덮어쓸 수 있습니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--templateName

이름이 지정되지 않은 경우 템플릿 이름 또는 'kickStartTemplate'입니다.

--templateVersion

X.X.X 형식의 템플릿 버전 또는 버전이 지정되지 않은 경우 1.0.0입니다.

pac copilot extract-translation

하나 이상의 봇에 대해 지역화된 콘텐츠가 포함된 파일을 추출합니다.

예시

이 명령은 하나 이상의 부조종사에 대해 지역화된 콘텐츠가 포함된 파일을 추출합니다.

pac copilot extract-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --all `
   --outdir . `
   --format json

이 명령은 다음과 같은 출력을 반환합니다.

Connected as user@contoso.org

Loaded 32 components for bot 'New Test Copilot' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

에 대한 선택적 매개 변수 copilot extract-translation

--all -a

지원되는 모든 언어에 대한 지역화 파일을 작성합니다. 기본적으로 기본 언어만 작성됩니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--bot -id

코필로트 ID 또는 스키마 이름(솔루션 탐색기의 봇 세부 정보 또는 파일 이름에 있는 고유 이름)입니다.

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--format

지역화된 파일을 쓸 파일 형식('resx' 또는 'json')입니다. 기본값은 'resx'입니다.

--outdir

쓸 출력 디렉터리입니다.

--overwrite -o

출력 데이터 파일이 이미 있는 경우 덮어쓸 수 있습니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--sourcedir -src

원본 솔루션 디렉터리입니다. 지정하면 봇을 찾을 때 연결된 환경을 무시하고 대신 솔루션 폴더에서 콘텐츠를 찾습니다.

pac copilot init

템플릿에서 새 Copilot Studio 에이전트 작업 영역을 만듭니다.

pac copilot init템플릿에서 새 Copilot Studio 에이전트 작업 영역을 스캐폴드합니다. 이 모드는 두 가지 모드 중 하나로 실행되며, 이 모드가 --environment 있으면 사용할 모드가 결정됩니다.

  • 로컬 스캐폴드 - 아니요 --environment. 템플릿 파일을 프로젝트 디렉터리에 쓰고 중지합니다. 이 명령은 Dataverse에서 아무것도 만들지 않으며 로그인이 필요하지 않습니다. 로컬로 작성하고 나중에 환경에 연결하려는 경우 이 모드를 사용합니다.
  • 부트스트랩 — --environment 제공됨. 파일을 스캐폴드하고, 솔루션에 패키지하고, 해당 솔루션을 환경으로 가져오고, 작업 영역을 새로 만든 에이전트에 연결합니다. 이 모드는 아무것도 없는 것에서 동기화할 수 있는 라이브 에이전트로의 1단계 경로이며 인증된 프로필이 필요합니다.

예제

작업 영역을 로컬로 스캐폴드합니다.

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

한 단계로 환경에서 라이브 에이전트를 스캐폴드하고 부트스트랩합니다.

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

CLI 작성(CliCopilot) 에이전트를 특정 폴더로 스캐폴드합니다.

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

에 대한 필수 매개 변수 copilot init

--name -n

에이전트 표시 이름입니다.

--publisher-prefix -pp

솔루션에 대한 사용자 지정 접두사를 Publisher.

에 대한 선택적 매개 변수 copilot init

--authoring-mode -am

스캐폴드할 에이전트 작성 셰이프입니다(기본값: '클래식'). 'cli-copilot'를 사용하여 CLI 작성 CliCopilot 에이전트를 스캐폴드합니다.

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--instructions -ins

에이전트 시스템 지침입니다.

--project-dir -pd

에이전트 작업 영역의 대상 디렉터리입니다. 기본값은 현재 디렉터리입니다.

--schema-name -sn

전체 에이전트 스키마 이름입니다. 기본 파생({publisher-prefix}_{sanitized-name})을 재정의합니다. 수정 없이 as-is 사용되었습니다.

--template -t

템플릿 프로필 이름(기본값, 최소). 기본값은 'default'입니다.

Remarks

  • 프로젝트 디렉터리가 비어 있어야 합니다. init 는 기존 파일을 스캐폴드하지 않으므로 새 폴더나 빈 폴더를 가리킵니 --project-dir 다.
  • 스키마 이름 파생입니다. 생략 --schema-name하면 에이전트 스키마 이름이 .로 {publisher-prefix}_{sanitized-name}빌드됩니다. 명시적으로 설정하려면 전달 --schema-name 합니다. 값은 as-is사용됩니다.
  • 부트스트랩은 두 작성 모드에서 모두 작동합니다. init --environment 기본 클래식 모드 및 --authoring-mode cli-copilot에 대한 라이브 에이전트를 한 단계로 부트스트랩합니다. CliCopilot 에이전트의 대안으로 로컬로 스캐폴드(아니요 --environment)한 다음 실행 pac copilot pack 한 pac solution import 후 직접 배포할 수 있습니다.
  • 부트스트랩은 서버 쪽 개체를 만듭니다. 부트스트랩 모드 init 에서 솔루션을 가져오고 대상 환경에서 에이전트를 만듭니다. 스키마 이름이 같은 에이전트가 이미 있는 init 경우 중지하고 기존 에이전트에 연결하도록 가리킵니 pac copilot clone 다.
  • 새로운 환경은 첫 번째 가져오기를 수락하는 속도가 느려질 수 있습니다. 새로 만든 환경은 준비하는 데 1~2분 정도 걸릴 수 있습니다. 초기 부트스트랩은 "이 조직에 대해 비동기 작업이 현재 비활성화되어 있습니다."로 실패할 수 있습니다. 잠시 기다렸다가 다시 실행합니다.
  • --template (default 또는 minimal)는 클래식 작성 모드에만 적용됩니다.

pac copilot list

현재 또는 대상 Dataverse 환경의 부조종사 목록입니다.

예시

이 명령은 현재 또는 대상 Dataverse 환경의 모든 부조종사 목록을 표시합니다.

pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

이 명령은 다음과 같은 출력을 반환합니다.

Name                           Bot ID                               Component State Is Managed Solution ID                          Status Code State Code
Ask Me Anything Copilot       584e012c-dc95-46d6-af5a-1263b6a44342 Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned
New Test Copilot               9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned

에 대한 선택적 매개 변수 copilot list

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

pac copilot mcp

로컬 MCP(모델 컨텍스트 프로토콜) 서버에 대한 정보입니다.

예시

pac copilot mcp --run

에 대한 선택적 매개 변수 copilot mcp

--run -r

로컬 MCP(모델 컨텍스트 프로토콜) 서버를 실행합니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

Remarks

기본 제공 MCP 서버에서 Power Platform CLI를 사용하는 방법 알아보기

pac copilot merge-translation

하나 이상의 봇에 대해 지역화된 콘텐츠가 포함된 파일을 병합합니다.

예시

이 명령은 하나 이상의 부조종사에 대해 지역화된 콘텐츠가 포함된 파일을 병합합니다.

pac copilot merge-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --file ms_store_newTestCopilot.de-DE.json `
   --solution SolutionName

이 명령은 독일어를 업데이트할 때 다음과 같은 출력을 반환합니다.

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 0 key(s) were missing, 0 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

merge-translation 명령에서 오류를 관리하는 방법에 대해 알아봅니다.

에 대한 선택적 매개 변수 copilot merge-translation

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--file -f

번역을 포함하는 파일 목록입니다. Glob 패턴이 지원됩니다.

--solution -s

솔루션의 이름입니다.

--sourcedir -src

원본 솔루션 디렉터리입니다. 지정하면 봇을 찾을 때 연결된 환경을 무시하고 대신 솔루션 폴더에서 콘텐츠를 찾습니다.

--verbose

데이터 가져오기/내보내기 중 추가 진단 정보 출력

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--whatif

명령을 실행하지 않지만 수행되는 작업에 대한 세부 정보를 출력합니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

병합 변환 오류

위의 예제에 따라 부조종사 업데이트에 사용되는 파일에 오류가 하나 있으면 출력은 다음과 같습니다.

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

플래그는 --verbose 오류에 대한 세부 정보를 추가합니다.

Connected as user@contoso.org

Missing translation key: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmond)'.DisplayName.

Unused translation: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmont)'.DisplayName, value: Redmond

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

pac copilot model list

현재 환경의 AI Builder 모델

예시

이 명령은 모든 AI Builder 모델을 나열합니다.

pac copilot model list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

이 명령은 다음과 같은 출력을 반환합니다.

Id                                   State    Name
32a9e265-1149-4155-af54-d2856d2b83f5 Active   Document Processing 2023/09/20, 12:21:40
2bcd7b94-50bc-4767-af4a-367c63fb5487 Inactive AI Classify
4e72b59a-17d6-451e-8657-89fbdec56d7a Inactive AI Extract
572f57a7-7a8f-49fc-adb4-331e02c509a6 Inactive AI Reply
b9b636cf-9748-47a7-b617-6df5f00f5151 Inactive AI Sentiment
c076eac8-f218-4feb-8ad1-7ee4fb039419 Inactive AI Summarize
a0440df3-2656-e911-8194-000d3a6cd5a5 Inactive BusinessCard model
62d1e848-5ca7-490a-94bf-79baabe85ef4 Inactive CategoryClassification model
4da7ec17-5c26-4fd2-9ddb-be4f7eda21a9 Inactive DataGenieEmailAddressValidation
51f4da11-5702-401d-b53a-9638744e8ac9 Inactive Document Layout Analysis Model
d1bb8d57-24ab-3b36-9592-bd792e153b79 Inactive DVCopilotQueryModel
3fbd4e5c-32bc-40fc-acce-59c2821cf113 Inactive Empty Dynamic Prompt
8c281981-c5d6-484f-bac7-4924ddd0b8ae Inactive EntityExtraction model
a1afa5d4-7a44-4c31-9cd2-e852a78431fa Inactive GptPromptEngineering model
2c444168-f8b1-4c6a-9313-2d9c03be6fea Inactive Id Scanning Model
77365cfa-7021-4cb7-a9b2-dc9823cde772 Inactive ImageDescription model
aef1bdd2-2a74-4f74-b4eb-9dfa22e35ded Inactive Invoice Model
5ed4d0fd-e9d4-4026-b09b-71f83ea90c60 Inactive Invoice Processing Model
c8425db7-c5a7-4226-b38e-c93a044c0fe1 Inactive KeyPhraseExtraction model
17a6f893-5b0b-4867-8fac-fb2eda9080b2 Inactive LanguageDetection model
046ab801-2756-e911-8194-000d3a6cd5a5 Inactive ObjectDetectionProposal model
892d3698-ba03-3d15-8e9e-843ca4ac5e7d Inactive PowerAppsAppCopilotModel
baa44529-bebe-49e6-837a-80bee63b0d2c Inactive Receipt Scanning Model
f1c549c2-a97e-47a5-b612-c5c2bab0f163 Inactive SentimentAnalysis model
7f8a7856-003a-3662-9871-0000d7674433 Inactive SimsModel
86419a67-205a-454f-b6fc-601394f2786d Inactive TextRecognition model
6225038a-8b5a-4913-bfd2-d8236f4102ba Inactive TextTranslation model
02e1fca3-232a-4f58-8c93-bdd8c9cd6de9 Inactive TextTranslationInternal model

에 대한 선택적 매개 변수 copilot model list

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

pac copilot model predict

AI 모델에 텍스트 또는 프롬프트 보내기

에 대한 선택적 매개 변수 copilot model predict

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--model-id -id

AI Builder 모델 ID

--model-name -n

전체 또는 부분 AI 모델 이름

--prompt -p

AI 모델로 보내라는 프롬프트

--text -t

AI 모델로 보낼 텍스트

pac copilot model prepare-fetch

LLM(AI 대규모 언어 모델)에서 FetchXML 파일을 가져와 현재 환경에 대한 실행을 준비합니다.

에 대한 필수 매개 변수 copilot model prepare-fetch

--inputFile -i

일반적으로 AI LLM에서 제공되는 입력 FetchXML 파일입니다.

--outputFile -o

현재 환경에 대해 실행할 준비가 된 FetchXML 파일을 출력합니다.

에 대한 선택적 매개 변수 copilot model prepare-fetch

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

pac copilot pack

Copilot Studio 에이전트 작업 영역을 솔루션 zip 파일로 패키지합니다.

pac copilot pack 를 사용하여 배포할 수 있는 Dataverse 솔루션 .zip 에 에이전트 작업 영역을 패키지합니다 pac solution import. 이는 사용자에 대해 실행되는 패키징 단계 pac copilot init --environment 의 독립 실행형 형태이므로 배포 가능한 솔루션을 별도의 단계(예: 빌드 파이프라인)로 생성할 수 있습니다. 클래식 및 CLI 작성(CliCopilot) 에이전트 작업 영역에서 모두 작동합니다.

예시

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

에 대한 필수 매개 변수 copilot pack

--publisher-prefix -pp

솔루션에 대한 사용자 지정 접두사를 Publisher.

에 대한 선택적 매개 변수 copilot pack

--output-path -op

솔루션 zip 파일의 출력 경로입니다. 기본값은 현재 디렉터리입니다.

--project-dir -pd

패키지할 에이전트 작업 영역 디렉터리입니다. 기본값은 현재 디렉터리입니다.

--solution-name -sn

솔루션 고유 이름입니다. 생략하면 에이전트 스키마 이름에서 파생됩니다.

Remarks

  • 로컬 작업입니다. Pack은 작업 영역을 읽고 솔루션을 .zip씁니다. 인증 및 환경이 필요하지 않으므로 빌드 파이프라인에서 실행해도 안전합니다.
  • 게시자 접두사는 유효해야 합니다. --publisher-prefix 는 올바른 형식의 사용자 지정 접두사이거나 아무 것도 작성하기 전에 팩이 중지되어야 합니다.
  • 솔루션 이름 및 출력입니다. 생략 --solution-name하면 솔루션의 고유 이름이 에이전트 스키마 이름에서 파생됩니다. .zip 설정--output-path하지 않는 한 현재 디렉터리에 기록됩니다.
  • 팩이 배포되지 않습니다. 솔루션을 생성하지만 가져오지 않습니다. pac solution import 에이전트를 배포한 다음 pac copilot clone 동기화 연결 작업 영역을 원하는 경우 에이전트를 배포합니다.

pac copilot publish

사용자 지정 부조종사 게시

에 대한 필수 매개 변수 copilot publish

--bot -id

코필로트 ID 또는 스키마 이름(솔루션 탐색기의 봇 세부 정보 또는 파일 이름에 있는 고유 이름)입니다.

에 대한 선택적 매개 변수 copilot publish

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

pac copilot pull

Copilot Studio 원격 변경 내용을 끌어와 로컬 작업 영역과 병합합니다.

이 pac copilot pull 명령은 에이전트의 현재 서버 상태를 가져오고 3방향 병합을 사용하여 로컬 작업 영역에 병합합니다. 이 프로세스를 통해 서버 쪽 편집과 손길이 닿지 않은 로컬 파일이 모두 그대로 유지됩니다. 편집을 시작하기 전에 실행한 다음 변경 내용을 푸시하기 전에 다시 실행합니다.

예시

작업 영역 폴더 내에서 명령을 실행합니다.

pac copilot pull

또는 디스크의 다른 작업 영역을 가리킵니다.

pac copilot pull --project-dir contoso-support

에 대한 선택적 매개 변수 copilot pull

--project-dir -pd

프로젝트 디렉터리의 경로입니다. 기본값은 현재 작업 디렉터리입니다.

Remarks

  • 동기화 작업 영역 내에서 실행합니다. 이 pull 명령은 또는 pac copilot init에서 만든 pac copilot clone 폴더에서만 작동합니다. 작업 영역의 동기화 메타데이터에서 대상 환경 및 에이전트를 읽으므로 인수가 없습니다 --environment . 다른 곳에서 실행하면 "작업 영역을 찾을 수 없음" 오류와 함께 실패합니다.
  • 로컬 파일에 씁니다. 끌어오기에서는 원격 변경 내용을 작업 영역에 병합하고 기술 파일을 다운로드합니다. 끌어당기기 전에 관심 있는 로컬 작업을 커밋하거나 백업합니다.
  • 를 사용하여 먼저 로그인합니다 pac auth create.

pac copilot push

로컬 작업 영역 변경 내용을 Copilot Studio 푸시합니다.

pac copilot push 는 로컬 작업 영역의 변경 내용을 Dataverse의 에이전트로 다시 보냅니다. 파일을 마지막으로 알려진 서버 상태와 비교하고, 기술 파일, 클라우드 흐름 및 연결 참조를 포함하여 변경된 내용만 업로드하고, 푸시한 내용을 보고합니다.

예시

작업 영역 폴더 내에서 실행합니다.

pac copilot push

또는 디스크의 다른 작업 영역을 가리킵니다.

pac copilot push --project-dir contoso-support

에 대한 선택적 매개 변수 copilot push

--project-dir -pd

프로젝트 디렉터리의 경로입니다. 기본값은 현재 작업 디렉터리입니다.

Remarks

  • 동기화 작업 영역 내에서 실행합니다. 예: pullpush 에서 만든 pac copilot clone 폴더에서만 작동합니다 pac copilot init. 작업 영역의 동기화 메타데이터에서 대상 환경을 읽습니다. 인수는 없습니다 --environment .
  • 충돌이 있는 경우 먼저 끌어오기. 동일한 항목이 로컬 및 서버에서 모두 변경된 경우 푸시가 중지되고 다시 시도하기 전에 실행 pac copilot pull 하도록 요청합니다. 이 프로세스는 사용자가 못한 서버 쪽 변경 내용을 자동으로 덮어쓰는 것을 방지합니다.
  • no-op로컬 변경 내용이 없습니다. 푸시에서 보낼 항목을 찾지 못하면 해당 내용이 보고되고 환경을 건드리지 않고 종료됩니다.
  • 푸시가 성공하면 대상 환경에서 라이브 에이전트가 변경됩니다 .
  • 를 사용하여 먼저 로그인합니다 pac auth create.

pac copilot quarantine

부조종사 요원의 격리 상태.

에 대한 필수 매개 변수 copilot quarantine

--bot-id -id

격리/해제 시 부조종사의 신분증.

에 대한 선택적 매개 변수 copilot quarantine

--environment -env

환경(ID, 조직 ID, URL, 고유 이름 또는 부분 이름).

--status -s

격리 상태 값. 참 = 격리, 거짓 = 격리 해제. 기본값은 true입니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

pac copilot status

현재 또는 대상 Dataverse 환경에서 지정된 부조종사 배포 상태를 폴링합니다.

예시

이 명령은 현재 또는 대상 Dataverse 환경에서 지정된 부조종사 배포 상태를 폴링합니다.

pac copilot status `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot-id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e

이 명령은 다음과 같은 출력을 반환합니다.

Connected as user@contoso.org
Connected to... Contoso Organization
Virtual Agent New Bot German with ID 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e has been provisioned.

에 대한 필수 매개 변수 copilot status

--bot-id -id

부조종사(챗봇)의 ID입니다.

에 대한 선택적 매개 변수 copilot status

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

동기화 명령에 대한 인증 및 환경

clone, pull, push및 명령은 모두 Dataverse 환경과 init --environment 통신하므로 인증 프로필이 필요합니다. 를 사용하여 먼저 로그인합니다 pac auth create.

  • clone, pull활성 push 프로필이 필요합니다. pac copilot init 전달 --environment하면 하나만 필요합니다. 전달하지 않으면 init 파일을 로컬로 스캐폴드하고 로그인할 필요가 없습니다.
  • pull 작업 push 영역의 동기화 메타데이터에서 대상 환경을 읽고 인수를 --environment 사용하지 않도록 합니다. clone 할 수 있습니다 init .
  • pac copilot pack 는 순전히 로컬입니다. 파일을 읽고 쓰기만 하므로 인증 및 환경이 필요하지 않습니다.

pull 에서 push 만든 clone 작업 영역 내에서만 작동합니다 init. 작업 영역을 만들 때 작성된 동기화 메타데이터는 통신할 에이전트 및 환경을 알려주므로 다른 위치에서 실행하면 "작업 영역을 찾을 수 없음" 오류로 인해 빠르게 실패합니다.

참고하십시오

Microsoft Power Platform CLI 명령 그룹
Microsoft Power Platform CLI 개요

  • Last updated on