pac copilot

副駕駛管理工具與工具。

這些 init、 clone、 pull、 push和 pack 指令讓你能將 Copilot Studio 代理當作磁碟上的一組檔案保存，並在本地編輯，並與 Dataverse 環境同步。

一個典型的迴圈如下：

開始一個工作空間。 用來架設一個全新的代理，或用下載一個現有代理pac copilot init。pac copilot clone 不管怎樣，你都會得到一個本地工作區，承載其他指令依賴的同步元資料。
編輯前請先拉取。 pac copilot pull 遠端變更會被下載並合併到本地檔案，這樣你就從目前伺服器狀態開始。
用力後再用力。 pac copilot push 會把你當地的變更回傳回去。如果同一物品在伺服器上有變動，推停會要求你先拉。
部署套件。 pac copilot pack將工作空間變成你可以部署的pac solution import解決方案.zip。

從無到有，一舉成為現場代理，搭 pac copilot init --environment 建支架、打包、匯入並連接工作區。這些指令讓你能獨立驅動迴圈的每個部分。

Commands

命令	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	從 AI 大型語言模型（LLM）取得 FetchXML 檔案，並準備針對目前環境執行。
pac copilot pack	將 Copilot Studio 代理工作區打包成解決方案壓縮檔。
pac copilot publish	發佈自訂 Copilot
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 pullpac 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 ID 或結構描述名稱（在 Bot 詳細資料中找到的唯一名稱或解決方案總管中的檔案名稱）。

可選參數 copilot clone

`--component-collection` `-cc`

要複製元件集合 ID。重複多次。

`--display-name` `-dn`

代理程式的顯示名稱（用於資料夾命名）。

`--environment` `-env`

指定目標 Dataverse。值可以是 Guid 或絕對 https URL。如果未指定，則會使用為目前驗證設定檔選取的作用中組織。

`--output-dir` `-od`

Remarks

--bot接受 Copilot ID 或 schema 名稱。 傳送 Copilot ID（GUID）或代理的架構名稱。該指令會根據目標環境解析結構名稱。
目的地子資料夾必須是空的。 克隆會寫入一個以代理（已消毒）顯示名稱命名的資料夾。--output-dir 如果該資料夾已經包含檔案，複製會停止而非覆蓋它們。用 --display-name 來選擇不同的資料夾名稱。
克隆元件集合。 要將元件集合與代理一起下移，請傳遞一個或多個集合 ID， --component-collection並以分號分隔。
克隆需要一個認證過的設定檔（pac auth create），並且在你省略時，會從或的主動設定檔組織中解析環境 --environment。

pac copilot create

使用現有的範本檔案作為參考建立新的副手。

所需參數 copilot create

`--displayName`

新副手的顯示名稱

`--schemaName`

新副手的結構描述名稱（唯一名稱）。

`--solution` `-s`

方案的名稱。

`--templateFileName`

來源 yaml 檔案，其中包含使用 extract-template 命令擷取的副手範本。

可選參數 copilot create

`--environment` `-env`

指定目標 Dataverse。值可以是 Guid 或絕對 https URL。如果未指定，則會使用為目前驗證設定檔選取的作用中組織。

pac copilot delete

刪除自訂的 Copilot。

所需參數 copilot delete

`--bot` `-id`

Copilot ID 或結構描述名稱（在 Bot 詳細資料中找到的唯一名稱或解決方案總管中的檔案名稱）。

可選參數 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`

Copilot ID 或結構描述名稱（在 Bot 詳細資料中找到的唯一名稱或解決方案總管中的檔案名稱）。

`--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`

Copilot ID 或結構描述名稱（在 Bot 詳細資料中找到的唯一名稱或解決方案總管中的檔案名稱）。

`--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 提供。將檔案架構起來，將它們打包成解決方案，將該解決方案匯入環境，並將工作空間連接到新建立的代理程式。此模式是從無到即時同步代理的一步路徑，且需要一個經過認證的設定檔。

Examples

在本地搭建工作區支架：

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`

代理作者的 shape to scaffold（預設為「經典」）。使用「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 packpac solution import再部署。
Bootstrap 建立伺服器端物件。 在引導模式中，匯 init 入解決方案並在目標環境中建立代理。如果已有同名架構的代理存在， 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（模型上下文協議）服務器的信息。

範例

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 模型識別碼

`--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 代理工作區打包成解決方案壓縮檔。

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`

解決方案壓縮檔的輸出路徑。預設為目前目錄。

`--project-dir` `-pd`

Agent workspace 目錄轉為 package。預設為目前目錄。

`--solution-name` `-sn`

解答：唯一的名字。若省略，則由代理架構名稱衍生。

Remarks

這是地方性的行動。 Pack 會讀取工作區並寫入解決方案 .zip。它不需要認證，也不需要環境，所以在建置管線中執行是安全的。
出版社前綴必須有效。 --publisher-prefix 必須是有良好設定的自訂前綴，或在寫任何東西前先用 pack stop。
解決方案名稱與輸出。 若省略 --solution-name，解決方案的唯一名稱將源自代理架構名稱。除非你設定 --output-path，否則是.zip寫入目前目錄的。
背包不會部署。 它產出了解決方案，但不會匯入。接著用 pac solution import 部署代理，然後 pac copilot clone 如果你想要一個同步連接的工作區。

pac copilot publish

發佈自訂 Copilot

所需參數 copilot publish

`--bot` `-id`

Copilot ID 或結構描述名稱（在 Bot 詳細資料中找到的唯一名稱或解決方案總管中的檔案名稱）。

可選參數 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`

Remarks

在同步工作區裡執行。 此 pull 指令僅能在由 pac copilot clone 或 pac copilot init建立的資料夾中運作。它會從工作區的同步元資料讀取目標環境和代理，這也是為什麼沒有 --environment 參數。如果你在其他地方執行，就會顯示「工作區找不到」錯誤。
它會寫入你的本地檔案。 Pull 會將遠端變更合併到工作區，並下載知識檔案。在拉之前，先承諾或備份你在意的本地工作。
請先用 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

在同步工作區裡執行。 像 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 環境中指定副手的部署狀態。

範例

此命令會輪詢目前或目標 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和 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建立的工作區中工作。建立工作區時寫入的同步元資料會告訴他們該與哪個代理和環境通訊，因此在其他地方執行時會很快出現「找不到工作區」錯誤。

參見

Microsoft Power Platform CLI 指令群組
 Microsoft Power Platform CLI 概述

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-07-14

pac copilot

Commands

pac copilot clone

範例

所需參數 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

範例

所需參數 copilot extract-template

--bot -id

--templateFileName

可選參數 copilot extract-template

--environment -env

--overwrite -o

--templateName

--templateVersion

pac copilot extract-translation

範例

可選參數 copilot extract-translation

--all -a

--bot -id

--environment -env

--format

--outdir

--overwrite -o

--sourcedir -src

pac copilot init

Examples

所需參數 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

範例

可選參數 copilot list

--environment -env

pac copilot mcp

範例

可選參數 copilot mcp

--run -r

Remarks

pac copilot merge-translation

範例

可選參數 copilot merge-translation

--environment -env

--file -f

--solution -s

--sourcedir -src

--verbose

--whatif

合併翻譯錯誤

pac copilot model list

範例

`--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`