Microsoft Copilot Studio と AI Builder プロンプトのコード インタープリターを使用すると、作成者は次の AI エージェントを構築できます。
- データ分析、Word、Excel、PowerPoint、PDF ファイルの処理、視覚化のための Python コードの実行
- 生成応答に言語モデルを使用する
この機能は、開発者、ビジネス アナリスト、およびローコード作成者向けに調整されています。 コードの生成と実行は、Copilot Studio エコシステムとシームレスに統合され、強力な AI 駆動型ソリューションを作成します。
開発者は 、開発者向けのコード インタープリター を読み、 コード インタープリターの Power Apps Component Framework (PCF) コンポーネント サンプル を確認して、Dataverse Predict メッセージを使用してプロンプトを呼び出し、返された応答を処理する方法を理解する必要があります。
Requirements
ライセンス: Microsoft Copilot Studio の課金とライセンス。 コードの生成と実行は 、テキストおよび生成型 AI ツール (Premium) 機能としてカウントされます。
サポートされているリージョン: すべてのパブリック クラウドで使用できます。 ソブリン クラウドは現在サポートされていません。
コード インタープリター機能の概要
コード インタープリターを使用すると、エージェントは高度なタスク用の Python コードを記述して実行できます。 ユース ケースは次のとおりです。
- Excel ファイル処理: ブック内の Excel ワークシートの作成、コピー、更新、StyleName の読み取り、StyleName の適用、セル間での書式のコピー、セル間での数式のコピーと更新などを行います。
- Word および PowerPoint のファイル処理。
- PDF ファイル処理: PDF ファイル、読み取りテーブル、およびテキスト段落を作成およびコピーします。
- データバース テーブルのデータ処理。
- 複雑な数学計算と統計計算。
- データ分析、操作、視覚化 (グラフやグラフなど)。
コード インタープリターは、次の機能をプロンプトに追加します。
- プロンプトでの出力の種類としてのファイルのサポート
- プロンプトの入力と出力の種類としての Excel ファイルのサポート
プロンプトは、次の 2 つの方法で作成できます。
- Power Apps の AI ハブで 独自のプロンプトを作成 するオプションを使用する
- エージェント レベルで Copilot Studio のエージェントに追加されたプロンプト ツール内
プロンプトの詳細については、「 プロンプトの概要」を参照してください。
また、Copilot Studio のエージェント チャットでコード インタープリターを使用することもできます。
Power Platform 管理センターで環境のコード インタープリターを有効にする
コード インタープリターを使用する場合は、まず、Power Platform 管理センターで環境のコード インタープリターを有効にする必要があります。
Important
テナント管理者は、Power Platform 管理センターを使用してコード インタープリターを有効にする必要があります。 この設定は 環境設定ごとに 設定され、既定では [オフ ] として構成されます。 Power Platform 管理センターで設定を有効にすると、エージェントとプロンプトでコード インタープリターを有効にすることができます。 セットアップの残りの部分に進む前に、必ずこの手順を実行してください。
環境のコード インタープリターを有効にするには:
Power Platform 管理センターで、 Copilot に移動し、[ 設定] を選択します。
[Copilot Studio] セクションまでスクロールし、Copilot Studio で [コードの生成と実行] を選択します。 環境の一覧が表示されたウィンドウが開きます。
環境を選択し、[ 追加] を選択します。 ウィンドウが開きます。
[ オン] を選択して、Copilot Studio でコードの生成と実行を有効にします。
保存 を選択します。
新しい空のプロンプトを作成し、プロンプトのコード インタープリターを有効にする
まず、AI Hub または Copilot Studio で新しい空のプロンプトを作成します。 次に、プロンプト設定でコード インタープリターを有効にします。
Power Apps AI Hub でプロンプトを作成し、コード インタープリターを有効にする
Power Apps の AI Hub で新しい空のプロンプトを作成し、プロンプト設定でコード インタープリターを有効にすることができます。 コード インタープリターを使用するプロンプトを記述および構成する方法の例については、「 プロンプトの例でコード インタープリターを使用する」を参照してください。
Important
開始する前に、 Power Platform 管理センターの環境でコード インタープリターが既に有効になっていることを確認してください。
Power Apps に移動します。
左側のウィンドウで AI ハブ を選択します。
[プロンプト] を選択します。
[ 独自のプロンプトを作成する] を選択します。
プロンプトの名前を指定します。
[手順] セクションで、...> を選択します。設定。
[ 設定] ページで、コード インタープリターを有効にします。
設定ページを閉じて、プロンプト エディターに戻ります。
コード インタープリターが有効になっている空のプロンプトが作成されます。 次に、プロンプトの指示を記述し、必要に応じてプロンプトを構成できます。
エージェント内にツールとしてプロンプトを作成し、コード インタープリターを有効にする
Copilot Studio のエージェント内にツールとして新しい空のプロンプトを作成し、そのプロンプトのコード インタープリターを有効にすることができます。 この記事の後半では、コード インタープリターを使用するプロンプトを記述して構成する方法について説明します。
Important
開始する前に、 Power Platform 管理センターの環境でコード インタープリターが既に有効になっていることを確認してください。
Copilot Studio で、コード インタープリターを有効にするエージェントに移動します。
[ ツール ] タブを選択し、[ ツールの追加>新しいツール>Prompt] を選択します。
埋め込まれた AI Builder プロンプト作成インターフェイスが Copilot Studio で開きます。
...> を選択します情報バーの設定。
[ 設定] ページで、[ コード インタープリターを有効にする] を選択します。
設定ページを閉じて、プロンプト エディターに戻ります。
コード インタープリターが有効になっている空のプロンプトが作成されます。
プロンプトでコード インタープリターを使用する次の手順
次に、プロンプトの指示を記述し、必要に応じてプロンプトを構成できます。
プロンプトでコード インタープリターを使用する方法の詳細な例については、「 コード インタープリター プロンプトの例」を参照してください。
プロンプトでのコード インタープリターのベスト プラクティス
- Copilot などの他の AI ツールを使用して、開始するように最適化されたプロンプトを取得します。
- 例で正確なプロンプトを使用します (少数のプロンプト)。
- 出力を指定します ("JSON として返す" や "Excel" や "PDF" など)。
エージェント チャットでコード インタープリターを使用する (プレビュー)
この機能は パブリック プレビュー 段階であり、変更される可能性があります。
また、Copilot Studio のエージェント レベルでコード インタープリターを有効にし、エージェントがコードを実行するために必要なプロンプト命令を使用してエージェント チャットでトリガーすることもできます。
エージェント設定でコード インタープリターを有効にする
Important
開始する前に、 Power Platform 管理センターの環境でコード インタープリターが既に有効になっていることを確認してください。
エージェントに移動し 、[設定] を選択します。
[ 生成 AI ] ページで、 コード インタープリターを有効にします。
設定を保存し、設定ページを閉じてエージェントに戻ります。
エージェント チャットでプロンプトを使用してコード インタープリターをトリガーする
エージェントのテストチャットに次の指示を入力してください。
1. You are given: - An Excel file with thousands of procurement transactions, including vendor name, invoice amount, PO number, and transaction date. 2. Your tasks: - Process the Excel file to identify: - Transactions over $10,000 with missing or blank PO numbers. - Flag transactions that meet either of the following criteria: - High-value transaction with missing PO. - For each flagged transaction: - Highlight the row in red. - Add a comment explaining the issue (for example, "PO Missing"). 3. Generate a summary report listing: - Total flagged transactions. - Vendor names involved. - Reasons for flagging. 4. Return: - The updated Excel file with highlights and comments. - A summary of updates made in text.調達トランザクションをチャットへの入力として含む Excel ファイルをアップロードします。 エージェント チャットを使用して、必要に応じて調達トランザクションを含むサンプル Excel ファイルを生成できます。
数秒後に、更新された Excel ファイルと共に、エージェントの応答として概要出力がテキストで表示されます。 ファイルをダウンロードして確認できます。
制限事項
- 1 つのプロンプトでアップロードされた複数のファイルの分析はサポートされていません。
- 1 つのプロンプトで複数のファイル出力を返すことはできません。
- アップロードされたファイルについて複数のターンで質問することはサポートされていません。