pac copilot

用于 copilot 管理的工具和实用工具。

使用 init、clone、pull和pushpack命令可将Copilot Studio代理保留为磁盘上的一组文件，在本地编辑，并将其与 Dataverse 环境同步。

典型的循环如下所示：

启动工作区。 使用或下载现有pac copilot clone代理来搭建全新的代理pac copilot init的基架。无论哪种方式，你都会获得一个包含其他命令所依赖的同步元数据的本地工作区。
在编辑之前拉取。 pac copilot pull 关闭远程更改并将其合并到本地文件中，以便从当前服务器状态开始。
完成后推送。 pac copilot push 将本地更改发送回。如果同时服务器上的同一项已更改，推送会停止并要求先拉取。
用于部署的包。 pac copilot pack 将工作区转换为 .zip 可以使用该解决方案进行部署 pac solution import的解决方案。

若要在单个步骤中从任何内容到实时代理， pac copilot init --environment 请创建基架、打包、导入和连接工作区。通过单个命令，可以自行驱动循环的每个部分。

Commands

Command	Description
pac copilot clone	将Copilot Studio代理克隆到本地工作区目录。
pac copilot create	使用现有模板文件作为引用创建新的 copilot。
pac copilot delete	删除自定义Copilot。
pac copilot extract-template	从环境中的现有 copilot 中提取模板文件。
pac copilot extract-translation	提取包含一个或多个机器人的本地化内容的文件。
pac copilot init	从模板创建新的Copilot Studio代理工作区。
pac copilot list	当前或目标 Dataverse 环境中的 copilot 列表。
pac copilot mcp	有关本地 MCP（模型上下文协议）服务器的信息。
pac copilot merge-translation	合并包含一个或多个机器人的本地化内容的文件。
pac copilot model list	当前环境中的 AI Builder 模型。
pac copilot model predict	向 AI 模型发送文本或提示
pac copilot model prepare-fetch	从 AI 大型语言模型（LLM）获取 FetchXML 文件，并准备针对当前环境执行该文件。
pac copilot pack	将Copilot Studio代理工作区打包到解决方案 zip 文件中。
pac copilot publish	发布自定义 Copilot
pac copilot pull	从Copilot Studio拉取远程更改，并与本地工作区合并。
pac copilot push	将本地工作区更改推送到Copilot Studio。
pac copilot quarantine	副驾驶特工处于隔离状态。
pac copilot status	在当前或目标 Dataverse 环境中轮询指定 copilot 的部署状态。

pac copilot clone

将Copilot Studio代理克隆到本地工作区目录。

pac copilot clone将现有Copilot Studio代理下载到本地工作区目录中，以及依赖的pac copilot push同步元数据pac copilot pull。代理的文件将写入以显示名称命名的子文件夹。

Example

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

所需的参数 copilot clone

`--bot` `-id`

Copilot 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 选择其他文件夹名称。
克隆组件集合。 若要将组件集合与代理一起关闭，请传递一 --component-collection个或多个集合 ID，并用分号分隔。
克隆需要经过身份验证的配置文件（pac auth create）并在省略活动配置文件时从活动配置文件的组织解析环境 --environment。

pac copilot create

使用现有模板文件作为引用创建新的 copilot。

所需的参数 copilot create

`--displayName`

新 copilot 的显示名称

`--schemaName`

新 copilot 的架构名称（唯一名称）。

`--solution` `-s`

解决方案的名称。

`--templateFileName`

包含使用 extract-template 命令提取的 copilot 模板的源 yaml 文件。

可选参数 copilot create

`--environment` `-env`

指定目标 Dataverse。该值可以是 Guid 或绝对 https URL。如果未指定，将使用为当前身份验证配置文件选择的活动组织。

pac copilot delete

删除自定义Copilot。

所需的参数 copilot delete

`--bot` `-id`

Copilot ID 或架构名称（在机器人详细信息中找到的唯一名称或解决方案资源管理器中的文件名）。

可选参数 copilot delete

`--confirm` `-y`

需要确认删除 copilot。

此参数不需要任何值。这是一个开关。

`--environment` `-env`

指定目标 Dataverse。该值可以是 Guid 或绝对 https URL。如果未指定，将使用为当前身份验证配置文件选择的活动组织。

pac copilot extract-template

从环境中的现有 copilot 中提取模板文件。

Example

此命令从环境中的现有 copilot 中提取模板文件。

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 ID 或架构名称（在机器人详细信息中找到的唯一名称或解决方案资源管理器中的文件名）。

`--templateFileName`

要向其写入 copil 模板的 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

提取包含一个或多个机器人的本地化内容的文件。

Example

此命令提取一个文件，其中包含一个或多个 copilot 的本地化内容。

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 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 中创建任何内容，不需要登录。若要在本地创作并稍后连接到环境，请使用此模式。
Bootstrap - --environment 提供。搭建文件基架，将它们打包到解决方案中，将解决方案导入环境，并将工作区连接到新创建的代理。此模式是从任何内容到实时同步就绪代理的一步路径，它需要经过身份验证的配置文件。

示例

在本地搭建工作区基架：

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`

要搭建基架的代理创作形状（默认值：“classic”）。使用“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使用。
Bootstrap 适用于两种创作模式。 init --environment在一个步骤中启动实时代理，用于默认经典模式和 .--authoring-mode cli-copilot 作为 CliCopilot 代理的替代方法，可以在本地搭建基架（否 --environment），然后运行 pac copilot pack 后 pac solution import 自行部署。
Bootstrap 创建服务器端对象。 在启动模式下， init 导入解决方案并在目标环境中创建代理。如果已存在具有相同架构名称的代理， init 请停止并指向你以 pac copilot clone 改为连接到现有代理。
接受第一个导入的全新环境可能很慢。 新建的环境可能需要一两分钟才能预热。早期启动可能会失败，并显示“当前已为此组织禁用异步操作”。请稍等片刻，再运行一次。
--template （default 或 minimal）仅适用于经典创作模式。

pac copilot list

当前或目标 Dataverse 环境中的 copilot 列表。

Example

此命令列出当前或目标 Dataverse 环境中的所有 copilot。

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（模型上下文协议）服务器的信息。

Example

pac copilot mcp --run

可选参数 copilot mcp

`--run` `-r`

运行本地 MCP（模型上下文协议）服务器。

此参数不需要任何值。这是一个开关。

Remarks

了解如何将 Power Platform CLI 与内置 MCP 服务器配合使用

pac copilot merge-translation

合并包含一个或多个机器人的本地化内容的文件。

Example

此命令合并包含一个或多个 copilot 的本地化内容的文件。

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`

包含翻译的文件列表。支持 Glob 模式。

`--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 模型。

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

可选参数 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

从 AI 大型语言模型（LLM）获取 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）代理工作区。

Example

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

这是一个本地操作。 包读取工作区并写入解决方案 .zip。它不需要身份验证，也不需要环境，因此可以安全地在生成管道中运行。
发布者前缀必须有效。 --publisher-prefix 必须是格式正确的自定义前缀，或包在编写任何内容之前停止。
解决方案名称和输出。 如果省略 --solution-name，则解决方案的唯一名称派生自代理架构名称。除非已设置--output-path，否则.zip会写入当前目录。
包不部署。 它生成解决方案，但不导入它。按照它 pac solution import 操作以部署代理，然后 pac copilot clone ，如果需要同步连接的工作区。

pac copilot publish

发布自定义 Copilot

所需的参数 copilot publish

`--bot` `-id`

Copilot ID 或架构名称（在机器人详细信息中找到的唯一名称或解决方案资源管理器中的文件名）。

可选参数 copilot publish

`--environment` `-env`

指定目标 Dataverse。该值可以是 Guid 或绝对 https URL。如果未指定，将使用为当前身份验证配置文件选择的活动组织。

pac copilot pull

从Copilot Studio拉取远程更改，并与本地工作区合并。

该 pac copilot pull 命令提取代理的当前服务器状态，并使用三向合并将其合并到本地工作区中。此过程可确保服务器端编辑和未更改的本地文件都保持不变。在开始编辑之前运行它，并在推送更改之前再次运行它。

Example

从工作区文件夹内部运行命令：

pac copilot pull

或者将其指向磁盘上其他地方的工作区：

pac copilot pull --project-dir contoso-support

可选参数 copilot pull

`--project-dir` `-pd`

Remarks

在同步工作区中运行它。 该 pull 命令仅适用于创建者 pac copilot clone 或 pac copilot init. 它从工作区的同步元数据中读取目标环境和代理，这就是为什么没有 --environment 参数。如果在任何其他位置运行它，它将失败，并出现“找不到工作区”错误。
它会写入本地文件。 将远程更改拉取到工作区并下载知识文件。在拉取之前提交或备份你关心的本地工作。
首先使用 pac auth create. 登录。

pac copilot push

将本地工作区更改推送到Copilot Studio。

pac copilot push 将本地工作区中的更改发送回 Dataverse 中的代理。它将文件与上次已知的服务器状态进行比较，仅上传更改的内容（包括知识文件、云流和连接引用）并报告推送的内容。

Example

从工作区文件夹内部运行它：

pac copilot push

或者将其指向磁盘上其他地方的工作区：

pac copilot push --project-dir contoso-support

可选参数 copilot push

`--project-dir` `-pd`

Remarks

在同步工作区中运行它。 同样 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`

副驾驶的身份证，用于隔离/解除隔离。

可选参数 copilot quarantine

`--environment` `-env`

环境（ID、组织 ID、URL、唯一名称或部分名称）。

`--status` `-s`

隔离状态值。 true = 隔离，false = 解除隔离。默认值为 true。

此参数不需要任何值。这是一个开关。

pac copilot status

在当前或目标 Dataverse 环境中轮询指定 copilot 的部署状态。

Example

此命令轮询当前或目标 Dataverse 环境中的指定 copilot 的部署状态。

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`

copilot （Chatbot）的 ID。

可选参数 copilot status

`--environment` `-env`

指定目标 Dataverse。该值可以是 Guid 或绝对 https URL。如果未指定，将使用为当前身份验证配置文件选择的活动组织。

同步命令的身份验证和环境

clone和pullpushinit --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创建的工作区内工作。创建工作区时写入的同步元数据是告知他们要与之通信的代理和环境，因此在其他任何位置运行它们会快速失败，并出现“找不到工作区”错误。

另见

Microsoft Power Platform CLI 命令组
 Microsoft Power Platform CLI 概述

反馈

此页面是否有帮助？

Last updated on 2026-07-14

pac copilot

Commands

pac copilot clone

Example

所需的参数 copilot clone

--bot -id

可选参数 copilot clone

--component-collection -cc

--display-name -dn

--environment -env

--output-dir -od

Remarks

pac copilot create

所需的参数 copilot create

--displayName

--schemaName

--solution -s

--templateFileName

可选参数 copilot create

--environment -env

pac copilot delete

所需的参数 copilot delete

--bot -id

可选参数 copilot delete

--confirm -y

--environment -env

pac copilot extract-template

Example

所需的参数 copilot extract-template

--bot -id

--templateFileName

可选参数 copilot extract-template

--environment -env

--overwrite -o

--templateName

--templateVersion

pac copilot extract-translation

Example

可选参数 copilot extract-translation

--all -a

--bot -id

--environment -env

--format

--outdir

--overwrite -o

--sourcedir -src

pac copilot init

示例

所需的参数 copilot init

--name -n

--publisher-prefix -pp

可选参数 copilot init

--authoring-mode -am

--environment -env

--instructions -ins

--project-dir -pd

--schema-name -sn

--template -t

Remarks

pac copilot list

Example

可选参数 copilot list

--environment -env

pac copilot mcp

Example

可选参数 copilot mcp

--run -r

Remarks

pac copilot merge-translation

Example

可选参数 copilot merge-translation

--environment -env

--file -f

--solution -s

--sourcedir -src

--verbose

--whatif

合并转换错误

pac copilot model list

Example

`--bot` `-id`

`--component-collection` `-cc`

`--display-name` `-dn`

`--environment` `-env`

`--output-dir` `-od`

`--displayName`

`--schemaName`

`--solution` `-s`

`--templateFileName`

`--environment` `-env`

`--bot` `-id`

`--confirm` `-y`

`--environment` `-env`

`--bot` `-id`

`--templateFileName`

`--environment` `-env`

`--overwrite` `-o`

`--templateName`

`--templateVersion`

`--all` `-a`

`--bot` `-id`

`--environment` `-env`

`--format`

`--outdir`

`--overwrite` `-o`

`--sourcedir` `-src`

`--name` `-n`

`--publisher-prefix` `-pp`

`--authoring-mode` `-am`

`--environment` `-env`

`--instructions` `-ins`

`--project-dir` `-pd`

`--schema-name` `-sn`

`--template` `-t`

`--environment` `-env`

`--run` `-r`

`--environment` `-env`

`--file` `-f`

`--solution` `-s`

`--sourcedir` `-src`

`--verbose`

`--whatif`

`--environment` `-env`

`--environment` `-env`

`--model-id` `-id`

`--model-name` `-n`

`--prompt` `-p`

`--text` `-t`

`--inputFile` `-i`

`--outputFile` `-o`

`--environment` `-env`

`--publisher-prefix` `-pp`

`--output-path` `-op`

`--project-dir` `-pd`

`--solution-name` `-sn`

`--bot` `-id`

`--environment` `-env`

`--project-dir` `-pd`

`--project-dir` `-pd`

`--bot-id` `-id`

`--environment` `-env`

`--status` `-s`

`--bot-id` `-id`

`--environment` `-env`