Бележка
Достъпът до тази страница изисква удостоверяване. Можете да опитате да влезете или да промените директориите.
Достъпът до тази страница изисква удостоверяване. Можете да опитате да промените директориите.
Инструменти и помощни програми за управление на копилота.
Командите init, clone, pull, pushи pack ви позволяват да запазите агент на Copilot Studio като набор от файлове на диска, да го редактирате локално и да го синхронизирате със среда на Dataverse.
Типичен цикъл изглежда така:
- Стартиране на работна област. Скафайте чисто нов агент с
pac copilot initили изтеглете съществуващ такъв сpac copilot clone. И в двата случая получавате локална работна област, която носи метаданните за синхронизиране, от които зависят другите команди. - Издърпайте, преди да редактирате.
pac copilot pullпремахва отдалечените промени и ги обединява във вашите локални файлове, така че започвате от текущото състояние на сървъра. - Натисни, когато си готов.
pac copilot pushизпраща вашите локални промени обратно. Ако междувременно същият елемент се е променил на сървъра, натиснете стопове и първо ви подканва да издърпате. - Пакет за разполагане.
pac copilot packпревръща работна област в решение.zip, което можете да разположите сpac solution import.
За да преминете от нищо към агент на живо в една стъпка, pac copilot init --environment скеле, пакети, импортирания и свързва работната област вместо вас. Отделните команди ви позволяват да управлявате всяка част от цикъла самостоятелно.
Команди
| Command | Описание |
|---|---|
| pac copilot clone | Клонирайте агент на Copilot Studio в локална директория на работна област. |
| pac copilot create | Създава ново копие, като използва съществуващ файл на шаблон като препратка. |
| pac copilot delete | Изтриване на Copilot по избор. |
| pac copilot extract-template | Извлича файл на шаблон от съществуващ copilot в среда. |
| pac copilot extract-translation | Извлича файл, съдържащ локализирано съдържание за един или повече ботове. |
| pac copilot init | Създайте нова работна област на агент на Copilot Studio от шаблон. |
| pac copilot list | Списък на копилотите в текущата или целевата среда на Dataverse. |
| pac copilot mcp | Информация за локалния MCP (Model Context Protocol) сървър. |
| pac copilot merge-translation | Обединяване на файлове, съдържащи локализирано съдържание за един или повече ботове. |
| pac copilot model list | Модели на AI Builder в текущата среда. |
| pac copilot model predict | Изпраща текст или подкана към AI модел |
| pac copilot model prepare-fetch | Взема fetchXML файла от AI Large Language Model (LLM) и го подготвя за изпълнение спрямо текущата среда. |
| 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 | Запитване на състоянието на разполагане на зададено copilot в текущата или целевата среда на Dataverse. |
pac copilot clone
Клонирайте агент на Copilot Studio в локална директория на работна област.
pac copilot cloneизтегля съществуващ агент на Copilot Studio в локална директория на работна област, заедно с метаданните за синхронизиране, които и pac copilot push на които pac copilot pull разчитате. Файловете на агента се записват в подпапка, кръстена на показваното му име.
Пример
pac copilot clone `
--bot 11111111-1111-1111-1111-111111111111 `
--environment 22222222-2222-2222-2222-222222222222 `
--output-dir contoso-support
Задължителни параметри за copilot clone
--bot
-id
ИД на Copilot или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).
Незадължителни параметри за copilot clone
--component-collection
-cc
ИД на колекция от компоненти за клониране. Повторете за няколко.
--display-name
-dn
Показвано име на агента (използва се за именуване на папки).
--environment
-env
Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.
--output-dir
-od
Главна папка за изход от клонирано копие. По подразбиране е текущата директория.
Забележки
-
--botприема ИД на Copilot или име на схема. Подайте или ИД на Copilot (GUID), или името на схемата на агента. Командата преобразува име на схема в целевата среда. - Подпапката местоназначение трябва да е празна. Клонираното копие записва в папка, кръстена на показваното име на агента (дезинфекцирано) под
--output-dir. Ако тази папка вече съдържа файлове, клонирано копие спира, вместо да ги презаписва. Използвайте--display-name, за да изберете друго име на папка. - Колекции от компоненти за клониране. За да пренесете колекции от компоненти заедно с агента, подайте един или повече ИД на колекция с , разделени с
--component-collectionточка и запетая. - Клонираното копие изисква удостоверен профил (
pac auth create) и коригира средата от--environmentили от организацията на активния профил, когато го пропуснете.
pac copilot create
Създава ново копие, като използва съществуващ файл на шаблон като препратка.
Задължителни параметри за copilot create
--displayName
Показваното име на новата копилот
--schemaName
Името на схемата (уникално име) на новия копилот.
--solution
-s
Име на решението.
--templateFileName
Изходен yaml файл, съдържащ copilot шаблона, извлечен с командата extract-template.
Незадължителни параметри за copilot create
--environment
-env
Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.
pac copilot delete
Изтриване на Copilot по избор.
Задължителни параметри за copilot delete
--bot
-id
ИД на Copilot или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).
Незадължителни параметри за copilot delete
--confirm
-y
Задължително, за да потвърдите изтриването на copilot.
Този параметър не изисква стойност. Това е превключвател.
--environment
-env
Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.
pac copilot extract-template
Извлича файл на шаблон от съществуващ copilot в среда.
Пример
Тази команда извлича файл на шаблон от съществуващ копилот в среда.
pac copilot extract-template `
--environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
--bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
--templateFileName NewTestCopilot.yaml
Командата връща резултата като следния за copilot с използване на английски и немски езици:
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 или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).
--templateFileName
Местоположение на файла yaml за записване на шаблона за copilot.
Незадължителни параметри за 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
ИД на Copilot или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).
--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 и не изисква влизане. Използвайте този режим, когато искате да създадете локално и да се свържете към среда по-късно. -
Bootstrap –
--environmentпредоставена. Разгъва файловете, пакетира ги в решение, импортира това решение в средата и свързва работната област с новосъздадения агент. Този режим е пътят от една стъпка от нищо към агент, готов за синхронизиране, и изисква удостоверен профил.
Примери
Локално разгъване на работна област:
pac copilot init `
--name "Contoso Support Agent" `
--publisher-prefix contoso
Scaffold and bootstrap a live agent in an environment in a single step:
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", за да разгъвате агент на CliCopilot с автор CliCopilot.
--environment
-env
Указва целевия Dataverse. Стойността може да бъде 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}. Преминете--schema-name, за да я зададете изрично; стойността се използва as-is. - Bootstrap работи и за двата режима на авториране.
init --environmentbootstraps агент на живо в една стъпка за класическия режим по подразбиране и за--authoring-mode cli-copilot. Като алтернатива на агент на CliCopilot, можете да косите локално (не--environment), след което да изпълнитеpac copilot pack, последвано отpac solution importсамостоятелното му разполагане. - Bootstrap създава обекти от страната на сървъра. В режим
initна bootstrap импортира решение и създава агента в целевата среда. Ако агент със същото име на схема вече съществува,initспира и ви насочва къмpac copilot cloneсвързване със съществуващия агент вместо това. - Чисто нова среда може да бъде бавна за приемане на първото импортиране. На новосъздадената среда може да отнеме една-две минути, за да се затопли. Ранно стартиране може да е неуспешно с "Асинхронните операции в момента са забранени за тази организация." Изчакайте малко и го изпълнете отново.
-
--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 (Model Context Protocol) сървър.
Пример
pac copilot mcp --run
Незадължителни параметри за copilot mcp
--run
-r
Изпълнете локалния MCP (Model Context Protocol) сървър.
Този параметър не изисква стойност. Това е превключвател.
Забележки
Научете как да използвате CLI за Power Platform с вграден 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
Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.
--file
-f
Списъкът с файлове, които съдържат преводи. Глоб моделите се поддържат.
--solution
-s
Име на решението.
--sourcedir
-src
Директория на изходно решение. Когато е зададено, ще игнорира свързаната среда, когато търси ботове, а вместо това ще търси съдържание в папката на решението.
--verbose
Извеждане на повече диагностична информация по време на импортиране/експортиране на данни
Този параметър не изисква стойност. Това е превключвател.
--whatif
Не изпълнява командата, но извежда подробностите за това, което ще се случи.
Този параметър не изисква стойност. Това е превключвател.
грешки при обединяване и превод
Въз основа на примера по-горе, ако съществува една грешка във файла, използван за актуализиране на copilot, резултатът изглежда така:
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
--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
Input FetchXML файл, който обикновено идва от AI LLM.
--outputFile
-o
Изходен FetchXML файл, който е готов за изпълнение спрямо текущата среда.
Незадължителни параметри за copilot model prepare-fetch
--environment
-env
Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.
pac copilot pack
Пакетиране на работна област на агент на Copilot Studio в zip файл на решение.
pac copilot pack пакетиране на работна област на агент в решение .zip на Dataverse, което можете да разположите с 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
Уникално име на решение. Ако е пропуснато, извлечено от името на схемата на агента.
Забележки
- Това е локална операция. Пакетът прочита работната област и записва решение
.zip. Не се нуждае от удостоверяване и няма среда, така че е безопасно да се изпълнява в конвейер на компилация. - Префиксът на издателя трябва да е валиден.
--publisher-prefixтрябва да бъде добре оформен префикс за персонализиране или пакет спира, преди да напишете нещо. - Име и изход на решението. Ако изпуснете
--solution-name, уникалното име на решението се извлича от името на схемата на агента. Се.zipзаписва в текущата директория, освен ако не зададете--output-path. - Пакетът не се разполага. То създава решението, но не го импортира. Следвайте го с
pac solution import, за да разположите агента, след коетоpac copilot clone, ако искате за него работна област, свързана със синхронизиране.
pac copilot publish
Публикуване на колона по избор
Задължителни параметри за copilot publish
--bot
-id
ИД на Copilot или име на схема (уникално име, намерено в подробности за бота или име на файл в прозореца на решения).
Незадължителни параметри за copilot publish
--environment
-env
Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.
pac copilot pull
Извличайте отдалечени промени от Copilot Studio и обединявайте с локалната работна област.
Командата pac copilot pull извлича текущото състояние на сървъра на агента и го обединява във вашата локална работна област с помощта на тристранно обединяване. Този процес гарантира, че редакциите от страна на сървъра и вашите недокоснати локални файлове остават непроменени. Изпълнете го, преди да започнете да редактирате, и го изпълнете отново, преди да натиснете промените.
Пример
Изпълнете командата от папката на работната област:
pac copilot pull
Или го насочете към работна област на друго място на диска:
pac copilot pull --project-dir contoso-support
Незадължителни параметри за copilot pull
--project-dir
-pd
Път до директорията на проекта. По подразбиране е текущата работна директория.
Забележки
- Изпълнете го в работна област за синхронизиране. Командата
pullработи само в папка, създадена отpac copilot cloneилиpac copilot init. Той прочита целевата среда и агента от метаданните за синхронизиране на работната област, затова няма--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
Път до директорията на проекта. По подразбиране е текущата работна директория.
Забележки
- Изпълнете го в работна област за синхронизиране. Like
pullработиpushсамо в папка, създадена отpac copilot cloneилиpac copilot init. Той прочита целевата среда от метаданните за синхронизиране на работната област. Няма--environmentаргументи. - Първо, ако има конфликт. Ако един и същ елемент се е променил както локално, така и на сървъра, натиснете спирания и ви подканва да изпълните,
pac copilot pullпреди да опитате отново. Този процес запазва натискане от мълчаливо презаписване на промяна от страна на сървъра, която не сте видели. - Няма локални промени, no-op. Ако натискането не намери нищо за изпращане, то съобщава, че и излиза, без да докосва средата.
- Успешното натискане мутира агента на живо в целевата среда.
- Първо влезте с
pac auth create.
pac copilot quarantine
Карантинен статус на агента на втория пилот.
Задължителни параметри за copilot quarantine
--bot-id
-id
ID-то на втория пилот за карантина/премахване на карантината.
Незадължителни параметри за copilot quarantine
--environment
-env
Среда (ИД, ИД на организация, URL адрес, уникално име или частично име).
--status
-s
Стойност на карантинния статус. true = карантина, false = unquarantine. По подразбиране е true.
Този параметър не изисква стойност. Това е превключвател.
pac copilot status
Запитване на състоянието на разполагане на зададено copilot в текущата или целевата среда на Dataverse.
Пример
Тази команда посочва състоянието на разполагане на зададено copilot в текущата или целевата среда на 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
Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.
Удостоверяване и среда за командите за синхронизиране
cloneВсички , pull, pushи init --environment командите говорят със средата на Dataverse, така че те се нуждаят от профил за удостоверяване. Първо влезте с pac auth create.
-
cloneиpullpushизисква активен профил.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 общ преглед