エージェントにコード インタープリター機能を追加する

ヒント

推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。

コード インタープリター機能を追加することで、Microsoft 365 Copilot の宣言型エージェントのユーザー エクスペリエンスを向上させることができます。 マニフェストリファレンスの機能要素とエージェントビルダーの機能セクションには、ユーザーの機能をロック解除するためのいくつかのオプションがあります。

コード インタープリターは、Python コードを介して複雑なタスクを解決するために設計された高度なツールです。 推論モデルを使用してコードを記述して実行し、ユーザーが複雑な数学の問題を解決したり、データを分析したり、視覚化を生成したりできるようにします。 コードが実行された後、コード インタープリターは生成された結果と関連コードを出力します。 また、シナリオに基づいてダウンロード可能な画像やファイルを生成し、変更や分析のための入力としてファイルを受け入れることもできます。

コード インタープリター機能は、Microsoft 365 Copilot ライセンスを持つユーザーと、従量制課金の使用が有効になっていない Copilot Chat ユーザーが使用できます。

注

コードインタプリタは、コンテキスト内エージェントに対してデフォルトで有効になっています。 この設定を変更するには、次のスクリーンショットに示すように、[設定] アイコンを選択し、必要に応じて [コード インタープリター] 設定を更新します。

Microsoft 365 Agents Toolkit でコード インタープリターを有効にする

Agents Toolkit と Visual Studio Code を使用してエージェントを作成していて、コード インタープリターを有効にする場合は、次の例に示すように、マニフェスト ファイルの capabilities プロパティに CodeInterpreter 値を追加します。

注

CodeInterpreter機能を追加するには、宣言型エージェント マニフェスト スキーマのバージョン 1.2 以降を使用している必要があります。

{
  "capabilities": [
    {
      "name": "CodeInterpreter"
    }
  ]
}

エージェント ビルダーでコード インタープリターを有効にする

Agent Builder では、コード インタープリタが常に有効になっています。 この機能は、すべてのエージェントに自動的に含まれています。

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

コード インタープリター機能は、推論モデルを使用して、宣言型エージェントがサンドボックス環境で Python コードを記述して実行できるようにします。 この機能により、ユーザーは複雑な数学の問題を解決したり、データを分析したり、視覚化を生成したりできます。 コードが実行された後、コード インタープリターは結果と生成されたコードを出力します。 また、シナリオに基づいてダウンロード可能な画像やその他のファイルを生成し、変更や分析のための入力としてファイルを受け入れることもできます。

コード インタープリターは、次の機能を提供します。

Copilot では、これらのタスクの実行時に生成されるコードのコピーおよびダウンロード可能なバージョンも提供できます。

グラフとチャートを作成する

ユーザーは、コード インタープリターを有効にしたエージェントを使用してグラフやチャートを作成できます。 たとえば、フィ ボナッチ数列の最初の 20 個の数値をグラフ化するというプロンプトに応答して、Copilot は次の折れ線グラフを生成します。

フィボナッチ数列の最初の 20 個の数値を示す折れ線グラフのスクリーンショット。

ユーザーが </> Code ボタンを選択すると、エージェントは対応する Python コードを提供します。

フィボナッチ数列の最初の 20 個の数値をグラフ化するための Python コードのスクリーンショット。

ユーザーは、データ ファイルをアップロードしてグラフやチャートを生成し、データを視覚化することもできます。 サポートされているファイル形式は、Word、Excel、PowerPoint、PDF、CSV/TSV、および TXT/UTF8 です。 たとえば、ユーザーは売上データを含む Excel ファイルをアップロードし、プロンプトを入力できます : アップロードした売上データの棒グラフと折れ線グラフを作成します。 エージェントは次の応答を返します。

サンプル売上データの横棒グラフ

サンプル販売データの折れ線グラフ

QR コードとデータの視覚化を作成する

コード インタープリターを有効にすると、ユーザーは QR コードやワード クラウドなどのさまざまなデータ視覚化を作成できます。 たとえば、 Microsoft の企業 Web サイトの QR コードを作成するというユーザー プロンプトに対して、エージェントは対応する URL と一致する QR コードの両方を提示します。

Copilot によって生成された Microsoft 用の QR コード

ワード クラウドの場合、プロンプト [ 上位のペットの名前のワード クラウドを作成する ] は、次の例に示すように、最も一般的な名前を含む画像を生成します。

ユーザー プロンプトに対する Word Cloud の応答

合成データの作成

ユーザーが操作するサンプルデータを必要とする場合、コードインタプリタを統合することで、さまざまな目的で合成データを作成できるようになります。 エージェントは、要求されたサンプル データを生成し、Word、Excel、PowerPoint、または PDF ファイルとして出力できます。 ユーザーは、生成されたファイルをエージェントの応答から直接ダウンロードできます。 プロンプトと応答の例を次に示します。

プロンプト:日付、金額、マーチャント、カテゴリを含む 10 の偽の金融取引のテーブルを作成します。

合成金融取引の表。

プロンプト:請求の問題に関する 20 件の合成カスタマー サポート チャット トランスクリプトを生成します。

総合的なカスタマー サポート チャットの表。

複雑な数学の問題を解く

エージェントにコード インタープリターを追加すると、次の例に示すように、ユーザーは複雑な数学の問題を解くようにエージェントにプロンプトを表示できます。

プロンプト:関数( f(x) = x^3 - 4x^2 + 6x - 2 )を( x = 0 )から( x = 3 )までの曲線下面積の積分を提供します。

曲線下面積の積分計算。

アップロードされた画像を変更する

コード インタープリターを統合すると、ユーザーはアップロードされた画像を変更することもできます。 この機能を持つエージェントは、画像にバナーとキャプションを追加し、カラー画像の白黒バージョンを生成できます。 (次の画像は Copilot によって生成されました。)

Copilot によって生成された 1934 年の Bentley 4 車の画像。

その画像を変更するには、ユーザーはプロンプト [添付画像の白黒バージョンをください] を入力できます。"1934 Bentley 4" というバナーと "Copilot が生成した画像" というキャプションを追加します。エージェントは、次の結果を提供します。

Copilot によって改造された 1934 年の Bentley 4 車の白黒画像。

ダウンロード可能なファイルを生成する

コード インタープリタは、ダウンロード可能なファイルを生成してホストできるため、エージェントはユーザーがエージェントが生成したファイルをダウンロードできるようにします。 コード インタープリターが出力ファイル (画像、グラフ、スプレッドシート、ドキュメントなど) を生成すると、Copilot は応答にダウンロード リンクを自動的に提示します。 ユーザーは、リンクを選択してファイルをローカルに保存できます。

この機能は、次のような多くのシナリオで役立ちます。

  • データのエクスポート: 計算されたデータまたは分析結果の Excel スプレッドシートを生成し、ダウンロードとして提供します。
  • レポート: 結果を要約した書式設定された PDF または Word ドキュメントを作成し、ダウンロードできるようにします。
  • 生成されたビジュアル: ダウンロード可能な画像ファイルとして、グラフ、QR コード、ワード クラウドを生成します。
  • 処理されたファイル: アップロードされた画像またはドキュメントに変更を適用し、結果をダウンロード可能なファイルとして返します。

次のプロンプトの例は、ファイル生成と自動ダウンロード リンク作成をトリガーします。

プロンプト:1から10までの九九表を含むスプレッドシートを作成し、Excelファイルを提供します。

エージェントは Excel ファイルを生成し、応答にダウンロード リンクを表示します。

注

コードインタプリタによって生成されたFilesは一時的にホストされ、アクティブなセッション中にのみダウンロードできます。 セッションが終了した後、Files は保持されません。