pac copilot

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

init、clone、pull、push、packのコマンドを使用すると、Copilot Studio エージェントをディスク上の一連のファイルとして保持し、ローカルで編集し、Dataverse 環境と同期できます。

一般的なループは次のようになります。

  1. ワークスペースを開始します。 pac copilot initを使用して新しいエージェントをスキャフォールディングするか、pac copilot cloneを使用して既存のエージェントをダウンロードします。 どちらの方法でも、他のコマンドが依存する同期メタデータを含むローカル ワークスペースを取得します。
  2. 編集する前にプルします。 pac copilot pull では、リモートの変更がダウンし、ローカル ファイルにマージされるため、現在のサーバーの状態から開始します。
  3. 完了したらプッシュします。 pac copilot push はローカルの変更を送信します。 その間に同じ項目がサーバーで変更された場合、プッシュは停止し、最初にプルするように求められます。
  4. デプロイ用のパッケージ。 pac copilot packは、pac solution importを使用してデプロイできる.zipワークスペースをソリューションに変換します。

1 つの手順で何も実行されないエージェントからライブ エージェントに移動するには、ワークスペースのスキャフォールディング、パック、インポート、接続を 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 1 つ以上のボットに対するローカライズされたコンテンツを含むファイルを抽出します。
pac copilot init テンプレートから新しい Copilot Studio エージェント ワークスペースを作成します。
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 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 環境で、指定されたコパイロットの展開状態をポーリングします。

pac copilot clone

Copilot Studio エージェントをローカル ワークスペース ディレクトリに複製します。

pac copilot cloneは、既存のCopilot Studio エージェントをローカル ワークスペース ディレクトリにダウンロードし、pac copilot pullして依存pac copilot push同期メタデータと共にダウンロードします。 エージェントのファイルは、表示名の後に名前が付けられたサブフォルダーに書き込まれます。

Example

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

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

--bot -id

コパイロット 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を持つ 1 つ以上のコレクション ID を渡します。
  • 複製には、認証されたプロファイル (pac auth create) が必要であり、 --environmentまたはアクティブなプロファイルの組織から、それを省略すると環境が解決されます。

pac copilot create

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

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

--displayName

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

--schemaName

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

--solution -s

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

--templateFileName

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

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

--environment -env

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

pac copilot delete

カスタム Copilotを削除します。

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

--bot -id

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

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

--confirm -y

副操縦士の削除を確認するために必要です。

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

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

テンプレートから新しい Copilot Studio エージェント ワークスペースを作成します。

pac copilot initは、テンプレートから新しいCopilot Studio エージェント ワークスペースをスキャフォールディングします。 2 つのモードのいずれかで実行され、 --environment の存在によって、使用するモードが決まる。

  • ローカル スキャフォールディング — --environmentなし。 テンプレート ファイルをプロジェクト ディレクトリに書き込み、停止します。 このコマンドは Dataverse で何も作成せず、サインインを必要としません。 このモードは、ローカルで作成し、後で環境に接続する場合に使用します。
  • ブートストラップ — --environment 提供されます。 ファイルをスキャフォールディングし、ソリューションにパッケージ化し、そのソリューションを環境にインポートして、ワークスペースを新しく作成されたエージェントに接続します。 このモードは、何もない状態からライブの同期対応エージェントへの 1 ステップ パスであり、認証されたプロファイルが必要です。

Examples

ワークスペースをローカルにスキャフォールディングする:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

1 つの手順で環境でライブ エージェントをスキャフォールディングしてブートストラップします。

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使用されます。
  • ブートストラップは、両方のオーサリング モードで機能します。 init --environment は、既定のクラシック モードと --authoring-mode cli-copilotの 1 つの手順でライブ エージェントをブートストラップします。 CliCopilot エージェントの代わりに、ローカルでスキャフォールディング ( --environmentなし) してから、 pac copilot pack 実行してから、 pac solution import を実行して自分でデプロイできます。
  • ブートストラップは、サーバー側のオブジェクトを作成します。 ブートストラップ モードでは、 init ソリューションをインポートし、ターゲット環境にエージェントを作成します。 同じスキーマ名のエージェントが既に存在する場合、 init は停止し、代わりに既存のエージェントに接続する pac copilot clone を指定します。
  • 新しい環境では、最初のインポートを受け入れるのに時間がかかる場合があります。 新しく作成された環境では、ウォームアップに 1 ~ 2 分かかる場合があります。 初期ブートストラップは、"この組織では非同期操作が現在無効になっています" で失敗する可能性があります。しばらく待ってから、もう一度実行してください。
  • --template (default または minimal) は、クラシック オーサリング モードにのみ適用されます。

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 エラー

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

Copilot Studio エージェント ワークスペースをソリューション zip ファイルにパッケージ化します。

pac copilot pack pac solution importを使用してデプロイできる Dataverse ソリューション .zipにエージェント ワークスペースをパッケージ化します。 これはパッケージ化ステップのスタンドアロン形式 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

  • これはローカル操作です。 Pack はワークスペースを読み取り、ソリューション .zipを書き込みます。 認証も環境も必要ないため、ビルド パイプラインで安全に実行できます。
  • パブリッシャー プレフィックスは有効である必要があります。 --publisher-prefix は、整形式のカスタマイズ プレフィックスである必要があります。または、何かを書き込む前にパックが停止します。
  • ソリューション名と出力。 --solution-nameを省略した場合、ソリューションの一意の名前はエージェント スキーマ名から派生します。 --output-pathを設定しない限り、.zipは現在のディレクトリに書き込まれます。
  • パックは展開されません。 ソリューションは生成されますが、インポートされません。 pac solution importに従ってエージェントをデプロイし、同期接続されたワークスペースが必要な場合はpac copilot cloneします。

pac copilot publish

カスタム Copilot の公開

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

--bot -id

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

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

--environment -env

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

pac copilot pull

Copilot Studioからリモート変更をプルし、ローカル ワークスペースとマージします。

pac copilot pull コマンドは、エージェントの現在のサーバー状態をフェッチし、3 方向マージを使用してローカル ワークスペースにマージします。 このプロセスにより、サーバー側の編集と、変更されていないローカル ファイルの両方がそのまま維持されます。 編集を開始する前に実行し、変更をプッシュする前にもう一度実行してください。

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

隔離/解除の副操縦士の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 にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

同期コマンドの認証と環境

clone、pull、push、init --environmentのコマンドはすべて Dataverse 環境と通信するため、認証プロファイルが必要です。 pac auth createを使用して最初にサインインします。

  • clone、 pull、および push にはアクティブなプロファイルが必要です。 pac copilot init --environment渡す場合にのみ 1 つ必要です。この場合、initはファイルをローカルにスキャフォールディングし、サインインは必要ありません。
  • pull ワークスペースの同期メタデータからターゲット環境を読み取 push 、 --environment 引数を受け取りません。 clone と init します。
  • pac copilot pack は純粋にローカルです。 ファイルの読み取りと書き込みのみが行われます。そのため、認証も環境も必要ありません。

pull pushは、cloneまたはinitによって作成されたワークスペース内でのみ機能します。 ワークスペースの作成時に書き込まれる同期メタデータは、どのエージェントと環境に通信するかを指示するため、他の場所で実行すると、"ワークスペースが見つかりません" というエラーで高速に失敗します。

こちらも参照ください

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

  • Last updated on