pac copilot

副操縦管理用のツールとユーティリティ。

Commands

Command Description
pac copilot create 既存のテンプレート ファイルを参照として使用し、新しいコパイロットを作成します。
pac copilot extract-template 環境に存在する既存のコパイロットからテンプレート ファイルを抽出します。
pac copilot extract-translation 1 つ以上のボットに対するローカライズされたコンテンツを含むファイルを抽出します。
pac copilot init-skills Copilot スキル定義ファイルを現在のディレクトリに抽出します。
pac copilot list 現在の、またはターゲット Dataverse 環境に含まれるコパイロットのリスト。
pac copilot mcp ローカル MCP (モデル コンテキスト プロトコル) サーバーに関する情報。
pac copilot merge-translation 1 つ以上のボットに対するローカライズされたコンテンツを含むファイルをマージします。
pac copilot model list 現在の環境が含む AI Builder モデル。
pac copilot model predict AI モデルにテキストやプロンプトを送信します
pac copilot model prepare-fetch AI 大規模言語モデル (LLM) から FetchXML ファイルを受け取り、現在の環境に対する実行の準備をします。
pac copilot publish カスタム Copilot の公開
pac copilot quarantine 副操縦士の隔離状態。
pac copilot status 現在の、またはターゲット Dataverse 環境で、指定されたコパイロットの展開状態をポーリングします。

pac copilot create

既存のテンプレート ファイルを参照として使用し、新しいコパイロットを作成します。

に必要なパラメーター copilot create

--displayName

新しいコパイロットの表示名

--schemaName

新しいコパイロットのスキーマ名 (一意の名前)。

--solution -s

ソリューションの名前です。

--templateFileName

extract-template コマンドで抽出された、コパイロット テンプレートを含むソース yaml ファイル。

の省略可能なパラメーター copilot create

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

pac copilot extract-template

環境に存在する既存のコパイロットからテンプレート ファイルを抽出します。

Example

このコマンドは、環境内の既存のコパイロットからテンプレート ファイルを抽出します。

pac copilot extract-template `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --templateFileName NewTestCopilot.yaml

コマンドは、英語とドイツ語を使用するコパイロットに対して次のような出力を返します:

Connected as user@contoso.org

Loaded 34 components for bot 'New Test Copilot ' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

New Test Copilot -> C:\Users\user\NewTestCopilot.yaml

に必要なパラメーター copilot extract-template

--bot -id

コパイロット ID またはスキーマ名 (ボットの詳細で見つかった一意の名前、またはソリューション エクスプローラーのファイル名)。

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

1 つ以上のボットに対するローカライズされたコンテンツを含むファイルを抽出します。

Example

このコマンドは、1 つ以上のコパイロットのローカライズされたコンテンツを含むファイルを抽出します。

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

コパイロット ID またはスキーマ名 (ボットの詳細で見つかった一意の名前、またはソリューション エクスプローラーのファイル名)。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--format

ローカライズされたファイルを書くファイル形式 ("resx" または "json")。 既定は "resx" です。

--outdir

書き込む先の出力ディレクトリ。

--overwrite -o

既に存在する場合に、出力データ ファイルの上書きを許可します。

このパラメーターには値が必要ありません。 それはスイッチです。

--sourcedir -src

ソース ソリューション ディレクトリ。 指定すると、ボットを検索するときに接続された環境を無視し、代わりにソリューション フォルダー内のコンテンツを検索します。

pac copilot init-skills

Copilot スキル定義ファイルを現在のディレクトリに抽出します。

の省略可能なパラメーター copilot init-skills

--output -o

スキル ファイルの出力フォルダー。 Default: .github/skills

--skills -s

コピーするスキル名 (最上位レベルの名詞名) のコンマ区切りのリスト (管理者、認証など)。既定値: すべてのスキル。

pac copilot list

現在の、またはターゲット Dataverse 環境に含まれるコパイロットのリスト。

Example

このコマンドは、現在またはターゲットの Dataverse 環境にあるすべてのコパイロットをリストします。

pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

コマンドは、次のような出力を返します:

Name                           Bot ID                               Component State Is Managed Solution ID                          Status Code State Code
Ask Me Anything Copilot       584e012c-dc95-46d6-af5a-1263b6a44342 Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned
New Test Copilot               9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned

の省略可能なパラメーター copilot list

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

pac copilot mcp

ローカル MCP (モデル コンテキスト プロトコル) サーバーに関する情報。

Example

pac copilot mcp --run

の省略可能なパラメーター copilot mcp

--run -r

ローカル MCP (モデル コンテキスト プロトコル) サーバーを実行します。

このパラメーターには値が必要ありません。 それはスイッチです。

Remarks

組み込みの MCP サーバーで Power Platform CLI を使用する方法について説明します

pac copilot merge-translation

1 つ以上のボットに対するローカライズされたコンテンツを含むファイルをマージします。

Example

このコマンドは、1 つ以上のコパイロットのローカライズされたコンテンツを含むファイルをマージします。

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

コマンドは実行されませんが、想定される結果の詳細を出力します。

このパラメーターには値が必要ありません。 それはスイッチです。

merge-translation errors

上記の例に基づくと、コパイロットの更新に使用されるファイルにエラーが 1 つある場合、出力は次のようになります:

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 publish

カスタム Copilot の公開

に必要なパラメーター copilot publish

--bot -id

コパイロット ID またはスキーマ名 (ボットの詳細で見つかった一意の名前、またはソリューション エクスプローラーのファイル名)。

の省略可能なパラメーター copilot publish

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

pac copilot quarantine

副操縦士の隔離状態。

に必要なパラメーター copilot quarantine

--bot-id -id

隔離/解除の副操縦士のIDです。

の省略可能なパラメーター copilot quarantine

--environment -env

環境 (ID、組織 ID、URL、一意の名前、または名前の一部)。

--status -s

隔離ステータス値。 true=隔離、false=隔離解除。 既定値は true です。

このパラメーターには値が必要ありません。 それはスイッチです。

pac copilot status

現在の、またはターゲット Dataverse 環境で、指定されたコパイロットの展開状態をポーリングします。

Example

このコマンドは、現在またはターゲットの 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 にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

See also

Microsoft Power Platform CLI コマンド グループ
Microsoft Power Platform CLIの概要

  • Last updated on