プロンプトでコード インタープリターを使用して、Pythonコードを生成して実行する

Note

本記事では 、標準ハーネスで駆動されるエージェントやエージェントフローで使用される機能について説明します。

Microsoft Copilot Studioのコードインタプリタとプロンプトビルダーのプロンプトを使うことで、メイカーは以下のAIエージェントを作成できます:

この機能は、開発者、ビジネス アナリスト、およびローコード作成者向けに調整されています。 コードの生成と実行は、強力な AI 駆動型ソリューションを作成するために、Copilot Studio エコシステムとシームレスに統合されます。

DataverseのPredictメッセージを使ってプロンプトを呼び出し、返答を処理する方法を学ぶには、開発者は『開発者向けコードインタプリター』を読み、コンポーネントフレームワーク(PCF)Power Appsコードインタプリタのコンポーネントサンプルをレビューしてください。

前提条件

コード インタープリター機能

コードインタプリタを使用するエージェントは、高度なタスクのためにPythonコードを書いて実行できます。 次のようなユース ケースがあります。

  • Excelファイル処理:ワークブック内のExcelワークシートを作成、コピー、更新します。 セルスタイルを読み、適用しましょう。 セル間でのフォーマットのコピー。 セル間で数式をコピー・更新するなど、他にも対応可能です。
  • ファイル処理のWordとPowerPoint。 Word文書の場合、エージェントは文書本文の標準的な段落や表からテキストを読み上げます。 「 エージェントがアップロードされた書類をどのように読むか」で詳しく学びましょう。
  • PDFファイル処理:PDFファイルの作成とコピー。 表やテキスト段落を読みましょう。
  • データバース テーブルのデータ処理。
  • 複雑な数学計算と統計計算。
  • データの分析、操作、可視化（チャートやグラフなど）。

コード インタープリターは、次の機能をプロンプトに追加します。

  • プロンプトでの出力の種類としてのファイルのサポート。
  • プロンプトの入力および出力の種類としてExcel ファイルをサポートします。

Note

Excelファイルの内容を検索するには、セマンティックサーチの代わりにコードインタプリタを使いましょう。 セマンティックサーチにはセルのインデックス付けに制限があります。

次の 2 つの方法のいずれかでプロンプトを作成します。

  • Power Apps: AI Hub の独自のプロンプトを作成するオプションを使用します。
  • [Copilot Studio: エージェントまたはトピック レベルでツールとしてプロンプトを追加します。

プロンプトの詳細については、「 プロンプトの概要」を参照してください。

また、Copilot Studio のエージェント チャットでコード インタープリターを使用することもできます。

Power Apps AI Hub で新しいプロンプトを開始し、コード インタープリターを有効にする

Power Appsで AI Hub で新しいプロンプトを開始し、プロンプト設定でコード インタープリターを有効にすることができます。

  1. Power Apps に移動します。

  2. 左側のウィンドウで AI ハブ を選択します。

  3. [プロンプト] を選択します。

    AI ハブでプロンプトを選択するスクリーンショット。

  4. [ 独自のプロンプトを作成する] を選択します。

    AI ハブで独自のプロンプトをビルドするを選択するスクリーンショット。

  5. プロンプトの名前を入力します。

  6. [ 手順 ] セクションで、3 つのドット (...) を選択し、[ 設定] を選択します。

    プロンプト設定を開く方法のスクリーンショット。

  7. [設定] で、コード インタープリターを有効にします。

  8. [設定] を閉じて、プロンプト エディターに戻ります。

プロンプト エディターが開き、コード インタープリターが有効になっています。 次に、 プロンプトの手順を記述します。

エージェント内でツールとして新しいプロンプトを開始し、コード インタープリターを有効にする

Copilot Studio のエージェント内でツールとして新しいプロンプトを開始し、そのプロンプトのコード インタープリターを有効にすることができます。

  1. Copilot Studioで、コード インタープリターを使用するエージェントに移動します。

  2. エージェント レベルまたはトピック レベルで、ツールとしてエージェントに新しいプロンプトを追加します。

    • エージェント レベルでプロンプトを追加します。

      1. [ツール] ページに移動します。

      2. [>] を選択します。

    • トピック レベルでプロンプトを追加します。

      1. [トピック] ページに移動し、プロンプトを追加するトピックを選択します。

      2. プロンプトを追加するトピック内の位置にある [ ノード の追加] を選択します。

      3. [ツールの追加] を選択します>新しいプロンプト。

    埋め込みプロンプト ビルダープロンプト作成インターフェイスが開きます。

  3. 情報バーで、3 つのドット (...) を選択し、[ 設定] を選択します。

    プロンプト設定を開くスクリーンショット。

  4. [ 設定] ページで、[ コード インタープリターを有効にする] を選択します。

  5. [設定] を閉じて、プロンプト エディターに戻ります。

プロンプト エディターが開き、コード インタープリターが有効になっています。 次に、 プロンプトの手順を記述します。

プロンプトの手順を書いてください

次に、プロンプトの指示を書き、必要に応じてプロンプトを設定し、保存してプロンプトを作成します。

コード インタープリター プロンプトの例で、プロンプトで コード インタープリターを使用する方法について説明します。

プロンプトでのコード インタープリターのベスト プラクティス

  • Copilotなどの他の AI ツールを使用して、開始するように最適化されたプロンプトを取得します。
  • 例を使った、正確なプロンプト (Few-shot Prompting) を使用します。
  • 出力を指定します ("JSON として返す" や "Excel" や "PDF" など)。

制限事項

Note

エージェントは、テキストボックス、シェイプ、WordArt、SmartArt、ヘッダーやフッター、埋め込みやリンクされたオブジェクトにのみ表示されるWord文書のテキストを読むことはできない場合があります。 エージェントがどのように アップロードされた書類を読み取るかについての詳細やヒントを学びましょう。

  • 1 つのプロンプトでアップロードされた複数のファイルの分析はサポートされていません。
  • 1 つのプロンプトで複数のファイル出力を返すことはできません。
  • アップロードされたファイルについて複数のターンで質問することはサポートされていません。
  • コードインタプリタを使うには、エージェントの設定でユーザー認証を使えるようにエージェントを設定する必要があります。 たとえば、Direct Line と 認証なしを使用すると、コード インタープリターを使用するシナリオでは機能しません。

Troubleshooting

コード インタープリターの使用時にエラーが発生した場合は、次の手順を試してください。

  1. 必要なすべてのアクセス許可が付与されていることを確認します。 ユーザー アカウントとエージェントに、コード インタープリター プロンプトを実行するために必要なアクセス許可があることを確認します。
  2. 構成の設定を確認します。 プロンプト設定でコード インタープリターが有効であること、およびエージェントがユーザー認証を使用するように構成されていることを確認します。
  3. 詳細については、エラー ログを参照してください。 Copilot Studio または関連する Power Platform 環境のエラー ログを確認して、問題の根本原因を特定し、是正措置を講じます。
  • 最終更新: