Microsoft Copilot Studio のコード インタプリターおよびプロンプト ビルダーのプロンプトを活用することで、作成者は次のような AI エージェントを構築できます:
- データ分析、Word、Excel、PowerPoint、PDFファイルの処理、可視化のための Python コードを実行する
- 生成応答に言語モデルを使用する
この機能は、開発者、ビジネス アナリスト、およびローコード作成者向けに調整されています。 コードの生成と実行は、Copilot Studio エコシステムとシームレスに統合され、強力な AI 主導のソリューションを作成します。
開発者は、開発者向けコード インタプリターを読み、コード インタプリター「Power Apps Component Framework (PCF)」コンポーネントのサンプルをレビューして、Dataverse Predict メッセージを使用してプロンプトを呼び出し、返された応答を処理する方法を理解する必要があります。
必要条件
ライセンス: Microsoft Copilot Studio の請求とライセンス。 コードの生成と実行は、テキストおよび生成 AI ツール (Premium) 機能としてカウントされます。
サポートされているリージョン: すべてのパブリック クラウドで利用可能。 Sovereign Cloud は現在サポートされていません。
コード インタプリターの機能
コード インタプリターを使用するエージェントは、高度なタスクのために Python コードを記述、実行することができます。 次のようなユース ケースがあります。
- Excel ファイルの処理: ワークブック内の Excel ワークシートの作成、コピー、更新、セルのスタイルの読み取りと適用、セル間の書式のコピー、セル間の数式のコピーと更新などを行います。
- Word と PowerPoint ファイルの処理。
- PDF ファイルの処理: PDF ファイルの作成やコピー、表やテキスト段落の読み取り。
- Dataverse のテーブル データ処理。
- 複雑な数学的および統計的計算。
- データの分析、加工、可視化 (図表やグラフなど)。
コード インタプリターは、プロンプトに以下の機能を追加します:
- プロンプトの出力タイプとしてファイルをサポート
- プロンプトの入力および出力形式として、Excel ファイルに対応しました。
プロンプトの作成方法は、以下の 2 つの方法のいずれかで行います:
- Power Apps: AI Hub の独自のプロンプトを作成するオプションを使用します。
- 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 を使用しても機能しません。
トラブルシューティング
コード インタプリタの使用時にエラーが発生した場合は、以下の手順を試してください。
- 必要なすべての権限が付与されていることを確認します。 ユーザー アカウントとエージェントに、コード インタプリターのプロンプトを実行するために必要な権限があることを確認してください。
- 構成の設定を確認します。 プロンプトの設定でコード インタプリターが有効になっていること、およびエージェントがユーザー認証を使用するように構成されていることを確認してください。
- 詳細については、エラーログを参照してください。 Copilot Studio または関連する Power Platform 環境のエラー ログをレビューし、問題の根本原因を特定して、是正措置を講じてください。