pac copilot

Копилотты басқаруға арналған құралдар мен утилиталар.

init, clone, pullpush, және pack командалар Copilot Studio агентін дискіде файлдар жиынтығы ретінде сақтап, оны жергілікті түрде өңдеп, Dataverse ортасымен синхрондауға мүмкіндік береді.

Типтік цикл былай көрінеді:

1. Жұмыс орнын ашыңыз. Жаңа агентті pac copilot initорнатыңыз немесе pac copilot cloneбар агентті жүктеп алыңыз . Қалай болғанда да, сіз басқа командаларға тәуелді синхрондау метадеректерін тасымалдайтын жергілікті жұмыс кеңістігін аласыз.
2. Өңдеу алдында тартыңыз. pac copilot pull Қашықтағы өзгерістерді төмендетіп, жергілікті файлдарыңызға біріктіреді, сондықтан сіз қазіргі сервер күйінен бастайсыз.
3. Бітірген соң итер. pac copilot push Жергілікті ақшаларыңды қайтарып жібереді. Егер серверде сол зат өзгерсе, push тоқтатып, алдымен тартып алуды сұрайды.
4. Орналастыруға арналған пакет. pac copilot pack жұмыс кеңістігін .zip , оны қолдануға pac solution importболатын шешімге айналдырады .

Ештеңеден тірі агентке бір қадамда жету үшін, pac copilot init --environment құрылыс алаңын орнатып, орайды, импорттап, жұмыс орнын қосады. Жеке командалар циклдің әр бөлігін жеке басқаруға мүмкіндік береді.

Пәрмендер

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

Copilot идентификаторы немесе схема атауы (Bot Details бөлімінде табылған бірегей атау немесе шешім жетектеушісіндегі файл атауы).

Қосымша параметрлер copilot clone

--component-collection -cc

Компоненттер жинағы ID-ден клонға ауыстырыңыз. Бірнеше рет қайталаңыз.

--display-name -dn

Агенттің көрсету атауы (қалта атауы үшін қолданылады).

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--output-dir -od

Клон шығару үшін root қалтасы. Әдепкі бойынша ағымдағы каталогқа орнатылады.

Ескертпелер

• --botCopilot ID немесе схема атауын қабылдайды. Copilot ID (GUID) немесе агенттің схема атауын беріңіз. Бұл команда мақсатты ортаға қарсы схема атауын шешеді.
• Мақсатты ішкі қалта бос болуы керек. Clone агенттің (тазартылған) көрсетілім атауының --output-dirатымен аталған қалтаға жазады. Егер сол қалтада файлдар болса, клон оларды қайта жазудың орнына тоқтатады. Басқа қалта атауын таңдау үшін қолданыңыз --display-name .
• Компоненттер жинақтарын клондау. Компонент жинақтарын агенттің жанында түсіру үшін, нүкте үтірлерімен бөлінген бір немесе бірнеше коллекция идентификаторын --component-collectionөткізіңіз.
• Clone аутентификацияланған профильді (pac auth create) талап етеді және белсенді профильдің ұйымынан немесе белсенді профильдің ұйымынан ортаны --environmentажыратады, егер оны алып тастасаңыз.

pac copilot create

Сілтеме ретінде бұрыннан бар үлгі файлын пайдаланып жаңа қосалқы пилотты жасайды.

Қажетті параметрлер copilot create

--displayName

Жаңаөзен оқиғасының аты-жөні

--schemaName

Жаңа зат есімнің атауы (зат есім).

--solution -s

Шешімнің атауы.

--templateFileName

Extract-template пәрмені арқылы шығарылған қосалқы пилот үлгісін қамтитын бастапқы yaml файлы.

Қосымша параметрлер copilot create

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac copilot delete

Custom Copilot-ты өшіріңіз.

Қажетті параметрлер copilot delete

--bot -id

Copilot идентификаторы немесе схема атауы (Bot Details бөлімінде табылған бірегей атау немесе шешім жетектеушісіндегі файл атауы).

Қосымша параметрлер copilot delete

--confirm -y

Екінші ұшқыштың өшірілгенін растау қажет.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--environment -env

Мақсатты деректерді анықтайды. Мән 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

Copilot идентификаторы немесе схема атауы (Bot Details бөлімінде табылған бірегей атау немесе шешім жетектеушісіндегі файл атауы).

--templateFileName

Қосалқы пилот үлгісін жазуға арналған yaml файлының орналасқан жері.

Қосымша параметрлер copilot extract-template

--environment -env

Мақсатты деректерді анықтайды. Мән 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

Copilot идентификаторы немесе схема атауы (Bot Details бөлімінде табылған бірегей атау немесе шешім жетектеушісіндегі файл атауы).

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--format

Локализацияланған файлдарды жазуға арналған файл пішімі, 'resx' немесе 'json'. Әдепкі - "Рефлексия".

--outdir

Жазуға болатын өнім каталогы.

--overwrite -o

Шығыс деректер файлы бар болса, қайта жазуға рұқсат етіңіз.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--sourcedir -src

Бастапқы шешім каталогы. Келтірілген кезде, боттарды іздеу кезінде қосылған ортаны елемейді және оның орнына шешім қалтасында мазмұнды іздейді.

pac copilot init

Шаблоннан жаңа Copilot Studio агент жұмыс кеңістігін жасаңыз.

pac copilot initШаблоннан жаңа Copilot Studio агенттік жұмыс кеңістігін құрады. Ол екі режимнің бірінде жұмыс істейді, және олардың --environment болуы қай режимді қолдану керектігін анықтайды:

• Жергілікті құрылыс — жоқ --environment. Шаблон файлдарын жоба каталогына жазып, тоқтайды. Бұл команда Dataverse-те ештеңе жасамайды және кіруді талап етпейді. Бұл режимді жергілікті түрде жазып, кейін ортаға қосылғыңыз келгенде қолданыңыз.
• Bootstrap — --environment жеткізілді. Файлдарды бекітіп, оларды шешімге орайды, сол шешімді ортаға импорттап, жұмыс кеңістігін жаңа құрылған агентке қосады. Бұл режим — ештеңеден тірі, синхрондауға дайын агентке дейінгі бір қадамдық жол, және ол аутентификацияланған профильді талап етеді.

Мысалдар

Scaffold — жергілікті жұмыс кеңістігі:

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

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--instructions -ins

Агент жүйесінің нұсқаулары.

--project-dir -pd

Агент жұмыс кеңістігіне арналған мақсат каталогы. Әдепкі бойынша ағымдағы каталогқа орнатылады.

--schema-name -sn

Толық агент схемасының аты. Әдепкі туынды ({publisher-prefix}_{sanitized-name}) ауыстырады. Өзгертусіз as-is қолданылған.

--template -t

Шаблон профилінің атауы (әдепкі, минималды). Әдепкі түрде 'әдепкі' деп аталады.

Ескертпелер

• Жоба анықтамалығы бос болуы керек. init Бар файлдардың үстінен жұмыс істемейді, сондықтан жаңа немесе бос қалтаға нұсқайды --project-dir .
• Схема атауының туындысы. Оны алып --schema-nameтастағанда, агент схемасының атауы .{publisher-prefix}_{sanitized-name} Pass --schema-name , оны анық орнатуға жіберіңіз; мән as-isқолданылады.
• Bootstrap екі авторлық режимде де жұмыс істейді. init --environment Әдепкі классикалық режим үшін --authoring-mode cli-copilotжәне . үшін бір қадамда тірі агентті жүктейді. CliCopilot агентіне балама ретінде, жергілікті scaffold (жоқ --environment), содан кейін іске pac copilot pack қосып pac solution import , өзіңіз орналастыруға болады.
• Bootstrap сервер жағында объектілер жасайды. Bootstrap режимінде init шешімді импорттап, агентті мақсатты ортада жасайды. Егер сол схема атауы бар агент бар болса, init ол тоқтап, қолданыстағы агентке қосылуды көрсетеді pac copilot clone .
• Жаңа орта алғашқы импортты қабылдауға баяу әсер етуі мүмкін. Жаңа жасалған орта жылынуға бір-екі минут қажет болуы мүмкін. Ерте жүктеу "Async операциялары осы ұйым үшін қазіргі уақытта өшірілген" деген жағдайда сәтсіз болуы мүмкін. Бір сәт күте тұр да, қайта іске қос.
• --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

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac copilot mcp

Жергілікті MCP (Model Context Protocol) сервері туралы ақпарат.

Мысал

pac copilot mcp --run

Қосымша параметрлер copilot mcp

--run -r

Жергілікті MCP (Model Context Protocol) серверін іске қосыңыз.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

Ескертпелер

Power Platform CLI-ді кіріктірілген MCP серверімен қалай қолдануды үйреніңіз

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.

Біріктіру-аударма пәрменінен қателерді басқару әдісі туралы біліңіз

Қосымша параметрлер copilot merge-translation

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--file -f

Аудармаларды қамтитын файлдар тізімі. Глоб үлгілері қолдау көрсетіледі.

--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 модельдерін тізімдейді.

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

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac copilot model predict

AI үлгісіне мәтін немесе сұрау жібереді

Қосымша параметрлер copilot model predict

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--model-id -id

AI Builder үлгісінің идентификаторы

--model-name -n

Толық немесе ішінара AI үлгісінің атауы

--prompt -p

AI моделіне жіберуді жылдам ету

--text -t

AI үлгісіне жіберілетін мәтін

pac copilot model prepare-fetch

FetchXML файлын AI Large Language Model-ден (LLM) алып, оны ағымдағы ортаға қарсы орындауға дайындайды.

Қажетті параметрлер copilot model prepare-fetch

--inputFile -i

Әдетте AI LLM-ден келетін FetchXML файлын енгізіңіз.

--outputFile -o

Қазіргі заманғы ортада іске қосылуға дайын FetchXML файлын шығарыңыз.

Қосымша параметрлер copilot model prepare-fetch

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac copilot pack

Copilot Studio агентінің жұмыс кеңістігін solution 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

Шешімнің бірегей атауы. Жоқ болса, агент схемасының атауынан алынған.

Ескертпелер

• Бұл жергілікті операция. Pack жұмыс кеңістігін оқып, шешім .zipжазады. Оған аутентификация да, орта да қажет емес, сондықтан оны құрастыру құбырында қауіпсіз іске қосуға болады.
• Баспагердің префиксі жарамды болуы керек. --publisher-prefix Жазбас бұрын жақсы жасалған баптау префиксі немесе pack stops болуы керек.
• Шешім атауы мен шығуы. Егер оны алып --solution-nameтастасаңыз, шешімнің ерекше атауы агент схемасының атауынан алынады. Ол .zip ағымдағы каталогқа жазылады, егер сіз .--output-path
• Топ орналастырылмайды. Ол шешімді шығарады, бірақ импорттамайды. Содан pac solution import кейін агентті орналастырыңыз, содан pac copilot clone кейін синхрондауға қосылған жұмыс кеңістігі керек болса.

pac copilot publish

Реттелетін қосалқы пилотты жариялау

Қажетті параметрлер copilot publish

--bot -id

Copilot идентификаторы немесе схема атауы (Bot Details бөлімінде табылған бірегей атау немесе шешім жетектеушісіндегі файл атауы).

Қосымша параметрлер copilot publish

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

pac copilot pull

Copilot Studio-дан қашықтағы өзгерістерді алып тастап, жергілікті жұмыс кеңістігімен біріктіріңіз.

Команда pac copilot pull агенттің ағымдағы сервер күйін алып, оны жергілікті жұмыс кеңістігіне үш жақты біріктіру арқылы біріктіреді. Бұл процесс сервер жағындағы өңдеулер мен қол тигізілмеген жергілікті файлдардың сақталуын қамтамасыз етеді. Өңдеуді бастамас бұрын іске қосып, өзгерістерді енгізбес бұрын қайта іске қосыңыз.

Мысал

Команданы workspace қалтасының ішінен іске қосыңыз:

pac copilot pull

Немесе дискінің басқа жұмыс кеңістігіне бағыттаңыз:

pac copilot pull --project-dir contoso-support

Қосымша параметрлер copilot pull

--project-dir -pd

Жоба каталогына жол. Әдепкі бойынша ағымдағы жұмыс директориясына орнатылады.

Ескертпелер

• Оны синхрондау жұмыс кеңістігінде іске қосыңыз. Бұл команда тек немесе pac copilot init. pac copilot clone арқылы жасалған қалтада ғана жұмыс істейді.pull Ол мақсатты ортаны және агентті жұмыс кеңістігінің синхрондау метадеректерінен оқиды, сондықтан ешқандай дау жоқ --environment . Егер оны басқа жерде іске қоссаңыз, "workspace not found" қатесі пайда болады.
• Ол сіздің жергілікті файлдарыңызға жазады. Pull қашықтағы өзгерістерді жұмыс кеңістігіне біріктіріп, білім файлдарын жүктейді. Өзіңізге маңызды жергілікті жұмысты міндетті түрде бекітіңіз немесе қолдау көрсетіңіз.
• Алдымен .pac auth create

pac copilot push

Жергілікті жұмыс кеңістігін Copilot Studio-ға енгізіңіз.

pac copilot push жергілікті жұмыс кеңістігіңіздегі өзгерістерді Dataverse-тегі агентке қайта жібереді. Ол сіздің файлдарыңызды соңғы белгілі сервер күйімен салыстырады, тек өзгергендерді жүктейді — оның ішінде білім файлдары, бұлттық ағындар және байланыс сілтемелері — және жібергенін хабарлайды.

Мысал

Оны workspace қалтасының ішінен іске қосыңыз:

pac copilot push

Немесе дискінің басқа жұмыс кеңістігіне бағыттаңыз:

pac copilot push --project-dir contoso-support

Қосымша параметрлер copilot push

--project-dir -pd

Жоба каталогына жол. Әдепкі бойынша ағымдағы жұмыс директориясына орнатылады.

Ескертпелер

• Оны синхрондау жұмыс кеңістігінде іске қосыңыз. Мысалы pull, , push тек pac copilot clone қалтада жұмыс істейді немесе pac copilot init. Ол мақсатты ортаны жұмыс кеңістігінің синхрондау метадеректерінен оқиды. Дау жоқ --environment .
• Қақтығыс болса, алдымен тарт. Егер бірдей элемент жергілікті және серверде өзгерсе, push тоқтатып, қайта тырыспас бұрын іске pac copilot pull қосуды сұрайды. Бұл процесс push-тың сервер жағындағы өзгерісті байқамаған түрде басып өтуден сақтайды.
• Жергілікті өзгерістердің болмауы no-op. Егер push жіберуге ештеңе таппаса, ол хабарласып, қоршаған ортаға қол тигізбей шығады.
• Сәтті итеру тірі агентті мақсатты ортада мутациялайды.
• Алдымен .pac auth create

pac copilot quarantine

Екінші ұшқыш агентінің карантин жағдайы.

Қажетті параметрлер copilot quarantine

--bot-id -id

Екінші ұшқыштың ID-ін карантин/карантиннен шығару.

Қосымша параметрлер copilot quarantine

--environment -env

Орта (идентификатор, ұйым идентификаторы, URL мекенжайы, бірегей атау немесе жартылай атау).

--status -s

Карантин мәртебесінің мәні. true = карантин, false = карантиннен шығару. Әдепкі бойынша 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

Қосалқы пилоттың идентификаторы (Chatbot).

Қосымша параметрлер copilot status

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

Синхрондау командалары үшін аутентификация және орта

clone, pull, pushжәне init --environment командалар Dataverse ортасымен байланысады, сондықтан оларға аутентификация профилі қажет. Алдымен .pac auth create

• clone, pull, және push белсенді профиль қажет. pac copilot init Тек өтіп --environmentкеткенде ғана керек; ол болмаса, init жергілікті файлдарды сақтайды және тіркелуді қажет етпейді.
• pull және push мақсатты ортаны жұмыс кеңістігінің синхрондау метадеректерінен оқиды, сонда олар аргумент қабылдамайды --environment . clone Және init жасаймын.
• pac copilot pack таза жергілікті. Ол тек файлдарды оқиды және жазады, сондықтан аутентификация мен орта қажет емес.

pull және push тек жұмыс кеңістігі clone ішінде немесе init. Жұмыс кеңістігі жасалғанда жазылған синхрондау метадеректері оларға қай агент пен ортамен сөйлесу керектігін айтады, сондықтан оларды басқа жерде іске қосу тез сәтсіздікке ұшырайды және "workspace not found" қатесі пайда болады.

Тағы қараңыз

Microsoft Power Platform CLI командалық топтары
Microsoft Power Platform CLI шолуы