pac 부조종사

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

Commands

Command	Description
pac copilot create	기존 템플릿 파일을 참조로 사용하여 새 부조종사 만들기
pac copilot extract-template	환경의 기존 부조종사에서 템플릿 파일을 추출합니다.
pac copilot extract-translation	하나 이상의 봇에 대해 지역화된 콘텐츠가 포함된 파일을 추출합니다.
pac copilot list	현재 또는 대상 Dataverse 환경의 부조종사 목록입니다.
pac copilot mcp	로컬 MCP(모델 컨텍스트 프로토콜) 서버에 대한 정보입니다.
pac copilot merge-translation	하나 이상의 봇에 대해 지역화된 콘텐츠가 포함된 파일을 병합합니다.
pac copilot 모델 목록	현재 환경의 AI Builder 모델
pac 부조종사 모델 예측	AI 모델에 텍스트 또는 프롬프트 보내기
pac copilot model prepare-fetch	LLM(AI 대규모 언어 모델)에서 FetchXML 파일을 가져와 현재 환경에 대한 실행을 준비합니다.
pac copilot publish	사용자 지정 부조종사 게시
pac 부조종사 상태	현재 또는 대상 Dataverse 환경에서 지정된 부조종사 배포 상태를 폴링합니다.

pac copilot create

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

부조종사 만들기에 필요한 매개 변수

`--displayName`

새 부조종사 표시 이름

`--schemaName`

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

`--solution` `-s`

솔루션의 이름입니다.

`--templateFileName`

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

부조종사 만들기에 대한 선택적 매개 변수

`--environment` `-env`

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

pac copilot extract-template

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

Example

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

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

부조종사 추출 템플릿에 필요한 매개 변수

`--bot` `-id`

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

`--templateFileName`

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

부조종사 extract-template에 대한 선택적 매개 변수

`--environment` `-env`

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

`--overwrite` `-o`

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

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

`--templateName`

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

`--templateVersion`

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

pac copilot extract-translation

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

Example

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

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

부조종사 추출 변환에 대한 선택적 매개 변수

`--all` `-a`

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

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

`--bot` `-id`

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

`--environment` `-env`

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

`--format`

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

`--outdir`

쓸 출력 디렉터리입니다.

`--overwrite` `-o`

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

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

`--sourcedir` `-src`

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

pac copilot list

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

Example

이 명령은 현재 또는 대상 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

부조종사 목록에 대한 선택적 매개 변수

`--environment` `-env`

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

pac copilot mcp

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

부조종사 mcp에 대한 선택적 매개 변수

`--run` `-r`

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

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

pac copilot merge-translation

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

Example

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

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 명령에서 오류를 관리하는 방법에 대해 알아봅니다.

부조종사 병합 변환에 대한 선택적 매개 변수

`--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 모델 목록

현재 환경의 AI Builder 모델

Example

이 명령은 모든 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

부조종사 모델 목록에 대한 선택적 매개 변수

`--environment` `-env`

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