pac copilot

[アーティクル]
10/16/2024

コパイロットの管理に使用するツールとユーティリティ

コマンド

command	プロパティ
パックコパイロット作成	既存のテンプレートファイルを参照として使用し、新しいコパイロットを作成します。
PACコパイロット抽出テンプレート	環境に存在する既存のコパイロットからテンプレートファイルを抽出します。
PACコパイロット抜粋翻訳	1 つ以上のボットに対するローカライズされたコンテンツを含むファイルを抽出します。
PAC副操縦士リスト	現在の、またはターゲット Dataverse 環境に含まれるコパイロットのリスト。
pac copilotマージ翻訳	1 つ以上のボットに対するローカライズされたコンテンツを含むファイルをマージします。
PACコパイロットモデルリスト	現在の環境が含む AI Builder モデル。
PAC副操縦士モデル予測	AI モデルにテキストやプロンプトを送信します
PACコパイロットモデル準備フェッチ	AI 大規模言語モデル (LLM) から FetchXML ファイルを受け取り、現在の環境に対する実行の準備をします。
pac copilot公開	カスタム Copilot の公開
PAC副操縦士ステータス	現在の、またはターゲット Dataverse 環境で、指定されたコパイロットの展開状態をポーリングします。

pac copilot create

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

コパイロットの予測に必要なパラメーター

`--displayName`

新しい副操縦士の表示名

`--schemaName`

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

`--solution-s`

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

`--templateFileName`

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

コパイロット作成のオプションのパラメーター

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

コパイロット抽出テンプレートで使用する必須のパラメーター

`--bot-id`

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

`--templateFileName`

コパイロットテンプレートを書き込む先の yaml ファイルの場所。

コパイロット抽出テンプレートで使用するオプションのパラメーター

`--environment-env`

`--overwrite-o`

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

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

pac copilot extract-translation

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

例

このコマンドは、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

コパイロット抽出翻訳で使用するオプションのパラメーター

`--all-a`

サポートされているすべての言語のローカライズファイルを作成します。既定では、主言語のみが記述されます。

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

`--bot-id`

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

`--environment-env`

`--format`

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

`--outdir`

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

`--overwrite-o`

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

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

`--sourcedir-src`

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

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

コパイロットリストのオプションのパラメーター

`--environment-env`

pac copilot merge-translation

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

例

このコマンドは、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コマンドからのエラーを管理する方法について学びます

コパイロットマージ翻訳で使用するオプションのパラメーター

`--environment-env`

`--file-f`

翻訳を含むファイルのリスト。 Glob パターンがサポートされています。

`--solution-s`

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

`--sourcedir-src`

`--verbose`

データのインポート/エクスポート中にさらに多くの診断情報を出力する

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

`--whatif`

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

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

merge-translation エラー

上記の例に基づくと、コパイロットの更新に使用されるファイルにエラーが 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 モデル。

例

このコマンドは、すべての 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

コパイロットモデルリストのオプションのパラメーター

`--environment-env`

pac copilot model predict

AI モデルにテキストやプロンプトを送信します

コパイロットモデル予測で使用するオプションのパラメーター

`--environment-env`

`--model-id-id`

AI Builder モデル ID

`--model-name-n`

完全または部分的な AI モデル名

`--prompt-p`

AI モデルに送信するプロンプト

`--text-t`

AI モデルに送信するテキスト

pac copilot model prepare-fetch

AI 大規模言語モデル (LLM) から FetchXML ファイルを受け取り、現在の環境に対する実行の準備をします。

コパイロットモデル取り込み準備に必要なパラメーター

`--inputFile-i`

通常、AI LLM から提供される FetchXML ファイルを入力します。

`--outputFile-o`

現在の環境に対して実行可能な FetchXML ファイルを出力します。

コパイロットモデル取り込み準備のオプションのパラメーター

`--environment-env`

pac コパイロットの公開

カスタム Copilot の公開

コパイロット公開の必須パラメータ

`--bot-id`

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

コパイロット公開の任意パラメータ

`--environment-env`

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.

コパイロットの状態に必要なパラメーター

`--bot-id-id`

コパイロット (チャットボット) の ID。

コパイロットの状態のオプションのパラメーター

`--environment-env`

参照

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

次の方法で共有

pac copilot

コマンド

pac copilot create

コパイロットの予測に必要なパラメーター

--displayName

--schemaName

--solution-s

--templateFileName

コパイロット作成のオプションのパラメーター

--environment-env

pac copilot extract-template

例

コパイロット抽出テンプレートで使用する必須のパラメーター

--bot-id

--templateFileName

コパイロット抽出テンプレートで使用するオプションのパラメーター

--environment-env

--overwrite-o

pac copilot extract-translation

例

コパイロット抽出翻訳で使用するオプションのパラメーター

--all-a

--bot-id

--environment-env

--format

--outdir

--overwrite-o

--sourcedir-src

pac copilot list

例

コパイロット リストのオプションのパラメーター

--environment-env

pac copilot merge-translation

例

コパイロット マージ翻訳で使用するオプションのパラメーター

--environment-env

--file-f

--solution-s

--sourcedir-src

--verbose

--whatif

merge-translation エラー

pac copilot model list

例

コパイロット モデル リストのオプションのパラメーター

--environment-env

pac copilot model predict

コパイロット モデル予測で使用するオプションのパラメーター

--environment-env

--model-id-id

--model-name-n

--prompt-p

--text-t

pac copilot model prepare-fetch

コパイロット モデル取り込み準備に必要なパラメーター

--inputFile-i

--outputFile-o

コパイロット モデル取り込み準備のオプションのパラメーター

--environment-env

pac コパイロットの公開

コパイロット公開の必須パラメータ

--bot-id

コパイロット公開の任意パラメータ

--environment-env

pac copilot status

例

コパイロットの状態に必要なパラメーター

--bot-id-id

コパイロットの状態のオプションのパラメーター

--environment-env

参照

フィードバック

その他のリソース

`--displayName`

`--schemaName`

`--solution-s`

`--templateFileName`

`--environment-env`

`--bot-id`

`--templateFileName`

`--environment-env`

`--overwrite-o`

`--all-a`

`--bot-id`

`--environment-env`

`--format`

`--outdir`

`--overwrite-o`

`--sourcedir-src`

コパイロットリストのオプションのパラメーター

`--environment-env`

コパイロットマージ翻訳で使用するオプションのパラメーター

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

`--bot-id`

`--environment-env`

`--bot-id-id`

`--environment-env`