Microsoft Copilot Studioおよびプロンプト ビルダープロンプトのコード インタープリターを使用すると、作成者は次の AI エージェントを構築できます。
- データ分析、Word、Excel、PowerPoint、PDF ファイルの処理、および視覚化のためにPython コードを実行する
- 生成応答に言語モデルを使用する
この機能は、開発者、ビジネス アナリスト、およびローコード作成者向けに調整されています。 コードの生成と実行は、強力な AI 駆動型ソリューションを作成するために、Copilot Studio エコシステムとシームレスに統合されます。
開発者は 、開発者向けのコード インタープリター を読み、 コード インタープリターの Power Apps Component Framework (PCF) コンポーネント サンプル を確認して、Dataverse Predict メッセージを使用してプロンプトを呼び出し、返された応答を処理する方法を理解する必要があります。
要件
Licensing: Microsoft Copilot Studioの課金とライセンス。 コードの生成と実行は 、テキストおよび生成型 AI ツール (Premium) 機能としてカウントされます。
サポートされているリージョン: すべてのパブリック クラウドで使用できます。 ソブリン クラウドは現在サポートされていません。
コード インタープリター機能
コード インタープリターを使用するエージェントは、高度なタスク用Pythonコードを記述して実行できます。 ユース ケースは以下のとおりです。
- Excelファイル処理: ブック内Excelワークシートの作成、コピー、更新、セル スタイルの読み取りと適用、セル間での書式のコピー、セル間での数式のコピーと更新などを行います。
- ファイル処理のWordとPowerPoint。
- PDF ファイル処理: PDF ファイルの作成とコピー、テーブルとテキスト段落の読み取り。
- データバース テーブルのデータ処理。
- 複雑な数学計算と統計計算。
- データの分析、操作、可視化（チャートやグラフなど）。
コード インタープリターは、次の機能をプロンプトに追加します。
- プロンプトでの出力の種類としてのファイルのサポート。
- プロンプトの入力および出力の種類としてExcel ファイルをサポートします。
次の 2 つの方法のいずれかでプロンプトを作成します。
- Power Apps: AI Hub の Build your own prompt オプションを使用します。
- [Copilot Studio: エージェントまたはトピック レベルでツールとしてプロンプトを追加します。
プロンプトの詳細については、「 プロンプトの概要」を参照してください。
また、Copilot Studio のエージェント チャットでコード インタープリターを使用することもできます。
Power Apps AI Hub で新しいプロンプトを開始し、コード インタープリターを有効にする
Power Appsで AI Hub で新しいプロンプトを開始し、プロンプト設定でコード インタープリターを有効にすることができます。
Power Apps に移動します。
左側のウィンドウで AI ハブ を選択します。
[プロンプト] を選択します。
[ 独自のプロンプトを作成する] を選択します。
プロンプトの名前を入力します。
[ 手順 ] セクションで、3 つのドット (...) を選択し、[ 設定] を選択します。
[設定] で、コード インタープリターを有効にします。
[設定] を閉じて、プロンプト エディターに戻ります。
プロンプト エディターが開き、コード インタープリターが有効になっています。 次に、 プロンプトの手順を記述します。
エージェント内でツールとして新しいプロンプトを開始し、コード インタープリターを有効にする
Copilot Studio のエージェント内でツールとして新しいプロンプトを開始し、そのプロンプトのコード インタープリターを有効にすることができます。
Copilot Studioで、コード インタープリターを使用するエージェントに移動します。
エージェント レベルまたはトピック レベルで、ツールとしてエージェントに新しいプロンプトを追加します。
エージェント レベルでプロンプトを追加します。
[ツール] ページに移動します。
[>] を選択します。
トピック レベルでプロンプトを追加します。
[トピック] ページに移動し、プロンプトを追加するトピックを選択します。
プロンプトを追加するトピック内の位置にある [ ノード の追加] を選択します。
[ツールの追加] を選択します>新しいプロンプト。
埋め込みプロンプト ビルダープロンプト作成インターフェイスが開きます。
情報バーで、3 つのドット (...) を選択し、[ 設定] を選択します。
[ 設定] ページで、[ コード インタープリターを有効にする] を選択します。
[設定] を閉じて、プロンプト エディターに戻ります。
プロンプト エディターが開き、コード インタープリターが有効になっています。 次に、 プロンプトの手順を記述します。
プロンプトの手順を書いてください
次に、プロンプトの指示を記述し、必要に応じてプロンプトを構成し、保存してプロンプトを作成できます。
コード インタープリター プロンプトの例で、プロンプトで コード インタープリターを使用する方法について説明します。
プロンプトでのコード インタープリターのベスト プラクティス
- Copilotなどの他の AI ツールを使用して、開始するように最適化されたプロンプトを取得します。
- 例を使った、正確なプロンプト（Few-shot Prompting）を使用します。
- 出力を指定します ("JSON として返す" や "Excel" や "PDF" など)。
制限事項
- 1 つのプロンプトでアップロードされた複数のファイルの分析はサポートされていません。
- 1 つのプロンプトで複数のファイル出力を返すことはできません。
- アップロードされたファイルについて複数のターンで質問することはサポートされていません。
- コードインタプリタを使うには、エージェントの設定でユーザー認証を使えるようにエージェントを設定する必要があります。 たとえば、Direct Line と 認証なしを使用すると、コード インタープリターを使用するシナリオでは機能しません。
Troubleshooting
コード インタープリターの使用時にエラーが発生した場合は、次の手順を試してください。
- 必要なすべてのアクセス許可が付与されていることを確認します。 ユーザー アカウントとエージェントに、コード インタープリター プロンプトを実行するために必要なアクセス許可があることを確認します。
- 構成の設定を確認します。 プロンプト設定でコード インタープリターが有効であること、およびエージェントがユーザー認証を使用するように構成されていることを確認します。
- 詳細については、エラー ログを参照してください。 Copilot Studio または関連する Power Platform 環境のエラー ログを確認して、問題の根本原因を特定し、是正措置を講じます。