コードインタープリタを使用してPythonコードを生成・実行する – Microsoft Copilot Studio

Microsoft Copilot StudioとAI Builderのプロンプトを利用することで、開発者やビジネスアナリストはAIエージェントを構築できます。この機能では、Pythonコードを実行し、Word、Excel、PowerPoint、PDFファイルのデータ処理や視覚化が可能です。また、言語モデルを用いて生成的な応答も行えます。プロンプトの生成と実行はCopilot Studioエコシステムと統合されており、強力なAI駆動のソリューションが作成できます。設定はPower Platform管理センターで行う必要があります。

Microsoft Copilot Studioにおけるコード解釈機能の活用

Microsoft Copilot Studio と AI Builder のプロンプトによるコードインタープリタの機能は、開発者、ビジネスアナリスト、低コード開発者向けに設計されており、次のようなAIエージェントを構築することができます:

  • Pythonコードを実行してデータ分析、Word、Excel、PowerPoint、PDFファイルの処理、ビジュアライゼーションを行う。
  • 言語モデルを利用して生成的な応答を行う。

この機能は、非常に強力でAI駆動のソリューションを創出するために、Copilot Studioエコシステムとシームレスに統合されています。

開発者は、こちらのリンクを参照して、DataverseのPredictメッセージを使用してプロンプトを呼び出し、返された応答を処理する方法を理解することができます。また、こちらのリンクでCode interpreter Power Apps コンポーネントのサンプルを確認することもできます。

要件

コードインタープリタの機能概要

コードインタープリタは、エージェントが高度なタスクを実行するためにPythonコードを記述及び実行できるようにします。使用例には以下のものが含まれます:

  • Excelファイルの処理:ワークブック内のExcelワークシートの作成、コピー、更新、StyleNamesの読み取り、適用、セル間の書式コピー、数式のコピーと更新など。
  • WordとPowerPointファイルの処理。
  • PDFファイルの処理:PDFファイルの作成とコピー、テーブルやテキスト段落の読み取り。
  • Dataverseテーブルデータの処理。
  • 複雑な数学的および統計的計算。
  • データの分析、操作、および視覚化(たとえば、チャートやグラフの作成)。

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

  • プロンプトにファイルを出力タイプとしてサポート。
  • プロンプトにExcelファイルを入力および出力タイプとしてサポート。

プロンプトは次の2つの方法で作成できます:

  1. Power AppsのAI Hubの「Build your own prompt」オプションを使用。
  2. Copilot Studio内のエージェントレベルで追加されたプロンプトツールを使用。

プロンプトの詳細については、こちらのリンクを参照してください。

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

Power Platform管理センターでのコードインタープリタの有効化

コードインタープリタを使用するすべての機能について、最初にPower Platform管理センターでエンバイロメントの設定を有効にする必要があります。

重要

テナント管理者は、Power Platform管理センターを使用してコードインタープリタを有効にする必要があります。この設定は環境ごとの設定であり、デフォルトではオフに設定されています。この設定をPower Platform管理センターで有効にした後、エージェントやプロンプトでコードインタープリタを有効にできます。残りの設定を進める前に、このステップを確実に実行してください。

環境でのコードインタープリタを有効にする手順:

  1. Power Platform管理センターにアクセスし、Copilotを選択し、次にSettingsを選択します。
  2. Copilot Studioセクションまでスクロールし、Copilot Studioでのコード生成と実行を選択します。環境のリストが表示されます。
  3. 環境を選択し、Addを選択します。パネルが開きます。
  4. Onを選択して、Copilot Studioでのコード生成と実行を有効にします。
  5. Saveを選択します。

新たな空のプロンプトの作成とコードインタープリタの有効化

最初に、AI HubまたはCopilot Studioで新たな空のプロンプトを作成し、次にプロンプト設定でコードインタープリタを有効にします。

AI Hubでのプロンプトの作成とコードインタープリタの有効化

AI Hubで新しい空のプロンプトを作成し、プロンプト設定でコードインタープリタを有効にできます。プロンプトの記述と構成に関する例については、こちらのリンクを参照してください。

  1. Power Appsにアクセスします。
  2. 左ペインでAI Hubを選択します。
  3. Promptsを選択します。
  4. Build your own promptを選択します。
  5. プロンプトの名前を入力します。
  6. Instructionsセクションで、 > Settingsを選択します。
  7. 設定ページでコードインタープリタを有効にします。
  8. 設定ページを閉じて、プロンプトエディタに戻ります。

空のプロンプトが作成され、コードインタープリタが有効になります。次に、プロンプトの指示を書き、必要に応じてプロンプトを構成できます。

エージェントにツールとしてのプロンプトを作成し、コードインタープリタを有効化

Copilot Studio内のエージェントに新しい空のプロンプトをツールとして作成し、そのプロンプトに対してコードインタープリタを有効にできます。

手順は次のとおりです:

  1. Copilot Studioにアクセスし、コードインタープリタを有効にしたいエージェントを選択します。
  2. Toolsタブを選択し、Add a tool > New tool > Promptを選択します。
  3. 情報バーで > Settingsを選択します。
  4. 設定ページで、Enable code interpreterを選択します。
  5. 設定ページを閉じて、プロンプトエディタに戻ります。

空のプロンプトが作成され、コードインタープリタが有効になります。

プロンプトでのコードインタープリタの次のステップ

次に、プロンプトの指示を書き、必要に応じて構成を行います。プロンプトでのコードインタープリタの使用に関する詳細な例については、こちらのリンクを参照してください。

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

  • 他のAIツールを使用して、最適なプロンプトから始めます。
  • 具体的なプロンプトと例を使用します(few-shot prompting)。
  • 出力を指定します(例:「JSONとして返す」、「Excel」、「PDF」など)。

エージェントチャットでのコードインタープリタの使用

この機能はパブリックプレビューであり、変更される可能性があります。Copilot Studioでエージェントレベルでコードインタープリタを有効にし、プロンプト指示を使用してエージェントチャットでそれをトリガーできます。

エージェント設定でのコードインタープリタの有効化

  1. エージェントにアクセスし、Settingsを選択します。
  2. Generative AIページでCode interpreterを有効にします。
  3. 設定をSaveして、設定ページを閉じてエージェントに戻ります。

エージェントチャットでプロンプトによるコードインタープリタのトリガー

  1. Test your agentチャットに次の指示を入力します:

plaintext

  1. 次の内容が与えられます:

    • 取引先名、請求額、PO番号、取引日を含む、数千件の調達取引が含まれるExcelファイル。
  2. あなたのタスク:

    • Excelファイルを処理して、以下を特定します:
      • PO番号が欠如しているか空白の高額取引($10,000以上)。
      • 以下のいずれかの基準を満たした取引にフラグを付けます:
        • POの欠如と共にの高額取引。
      • 各フラグ付き取引について:
        • 行を赤でハイライトします。
        • 問題を説明するコメントを追加します(例:”PO Missing”)。
  3. サマリー報告を生成します:

    • フラグ付き取引の総数。
    • 関与した取引先名。
    • フラグ付け理由。
  4. 返すもの:

    • ハイライトとコメントのある更新されたExcelファイル。
    • 行った更新のテキストによるサマリー。
  5. チャットに調達取引のExcelファイルをアップロードします。必要に応じて、サンプルのExcelファイルを生成するためにエージェントチャットを使用できます。

  6. 数秒後、エージェントの応答としてテキストのサマリー出力と更新されたExcelファイルが表示されるはずです。ファイルをダウンロードして確認できます。

制限事項

  • 単一のプロンプトでアップロードされた複数ファイルの分析はサポートされていません。
  • 単一のプロンプトで複数のファイル出力を返すことはサポートされていません。
  • アップロードされたファイルに関する質問を複数のターンで行うことはサポートされていません。

このように、Microsoft Copilot Studioにおけるコードインタープリタは、AIエージェントの機能を大幅に拡張し、さまざまなタスクの自動化と効率化を可能にします。開発者やビジネスアナリストは、この新しい機能を活用して、より効果的なソリューションを構築できます。

————-

Use code interpreter to generate and execute Python code – Microsoft Copilot Studio

Source link

Summary of Code Interpreter in Microsoft Copilot Studio

Overview
The Code Interpreter feature in Microsoft Copilot Studio enables makers to build advanced AI agents that can process and analyze data using Python code. This functionality is designed for developers, business analysts, and low-code makers and seamlessly integrates into the Copilot Studio ecosystem.

Key Capabilities

  1. Data Analysis and File Processing:

    • Execute Python code for complex data analysis.
    • Process files: Excel, Word, PowerPoint, and PDF.
    • Perform operations like creating, updating, and copying worksheets, and analyzing PDF tables and text.
    • Handle Dataverse table data, and conduct complex mathematical computations and visualizations.
  2. Prompts:

    • Code interpreter extends prompts by allowing file types as outputs and supporting Excel files for input and outputs.
    • Two ways to create prompts:
      • AI Hub’s “Build your own prompt” option.
      • Adding prompts at the agent level in Copilot Studio.
  3. Activation Requirements:

    • Code interpreter must be enabled in the Power Platform admin center on a per-environment basis.

Creating and Using Prompts

  • Prompts can be created as empty and configured to use the code interpreter.
  • Developers can also default enable the code interpreter for their agents in Copilot Studio.

Interactions in Agent Chat

  • Code interpreter functionality is available in agent chat, allowing users to give commands for data processing and receive outputs directly.

Best Practices for Using Code Interpreter in Prompts:

  • Utilize other AI tools for optimized prompting.
  • Use precise, example-based prompts.
  • Clearly specify output formats.

Limitations

  • Cannot analyze multiple files in one prompt.
  • Cannot return multiple file outputs in one prompt.
  • No multi-turn interactions for file questions are supported.

Conclusion

Overall, the Code Interpreter in Microsoft Copilot Studio enhances capabilities for creating AI-driven solutions that execute Python for data analysis and file processing. It is essential for users to understand setup requirements and best practices for optimal use.

関連記事