pac copilot
コパイロットの管理に使用するツールとユーティリティ
コマンド
| command | Description |
|---|---|
| pac copilot create | 既存のテンプレート ファイルを参照として使用し、新しいボットを作成します。 |
| pac copilot extract-template | 環境に存在する既存のボットからテンプレート ファイルを抽出します。 |
| pac copilot extract-translation | 1 つ以上のボットに対するローカライズされたコンテンツを含むファイルを抽出します。 |
| pac copilot list | 現在の、またはターゲット Dataverse 環境の仮想オペレーターの一覧です。 |
| 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 の公開 |
| pac copilot status | 現在の、またはターゲット 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
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
--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
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
--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
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
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
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
--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
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
pac copilot model predict
AI モデルにテキストやプロンプトを送信します
コパイロット モデル予測で使用するオプションのパラメーター
--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 ファイルを受け取り、現在の環境に対する実行の準備をします。
コパイロット モデル取り込み準備に必要なパラメーター
--inputFile
-i
通常、AI LLM から提供される FetchXML ファイルを入力します。
--outputFile
-o
現在の環境に対して実行可能な FetchXML ファイルを出力します。
コパイロット モデル取り込み準備のオプションのパラメーター
--environment
-env
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
pac コパイロットの公開
カスタム Copilot の公開
コパイロット公開の必須パラメータ
--bot
-id
チャットボット ID またはスキーマ名 (ボットの詳細で見つかった一意の名前、またはソリューション エクスプローラーのファイル名)。
コパイロット公開の任意パラメータ
--environment
-env
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
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
ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。
参照
Microsoft Power Platform CLI コマンド グループ
Microsoft Power Platform CLI の概要
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示