共用方式為

使用程式碼解釋器產生和執行 Python 程式碼

Microsoft Copilot Studio 中的程式碼解譯器和提示產生器提示可讓製作者建置 AI 代理程式，以：

  • 執行 Python 代碼進行數據分析、處理 Word、Excel、PowerPoint 和 PDF 文件以及可視化
  • 使用語言模型進行生成式回應

此功能是專為開發人員、業務分析師和低程式碼製作者量身訂做。 程式碼產生和執行與 Copilot Studio 生態系統緊密整合，以建立功能強大的 AI 導向解決方案。

開發人員應閱讀 開發人員的程式碼解譯器 ，並檢閱 程式碼解譯器 Power Apps 元件架構 （PCF） 元件範例 ，以瞭解如何使用 Dataverse Predict 訊息來叫用提示並處理傳回的回應。

需求

程式碼解釋器功能概覽

程式碼解釋器可讓 Agent 撰寫和執行用於進階工作的 Python 程式碼。 使用案例包括：

  • Excel 檔案處理：在活頁簿中建立、複製和更新 Excel 工作表、讀取 StyleNames、套用 StyleNames、跨儲存格複製格式、跨儲存格複製和更新公式等等。
  • Word 和 PowerPoint 檔案處理。
  • PDF 檔案處理：建立和複製 PDF 檔案、讀取表格和文字段落。
  • Dataverse 資料表的數據處理。
  • 數學和統計的複雜計算。
  • 資料分析、操作和視覺效果呈現 (例如，圖表和圖形)。

程式碼解譯器會將下列功能新增至提示：

  • 在提示中支援檔案的輸出類型
  • 支援 Excel 檔案作為提示的輸入和輸出類型

您可以透過兩種方式建立提示：

  • 在 Power Apps 的 AI Hub 使用建立您自己的提示選項
  • 在 Agent 層級新增至 Copilot Studio 中 Agent 的提示工具中

如需提示的詳細資訊，請參閱 提示概觀。

您也可以在 Copilot Studio 的客服專員聊天中使用程式碼解譯器。

建立新的空白提示，並開啟提示的程式碼解譯器

首先，在 AI 中心 或 Copilot Studio 中建立新的空白提示。 然後，您在提示設定中開啟程式碼解譯器。

在 Power Apps AI Hub 中建立提示並開啟程式碼解譯器

您可以在 Power Apps 的 AI Hub 中建立新的空白提示，並在提示設定中開啟程式碼解譯器。 您可以查看如何撰寫和設定使用程式碼解譯器的提示的範例，請參閱 在提示範例中使用程式碼解譯器。

  1. 前往 Power Apps。

  2. 選取左窗格中的 AI Hub。

  3. 選取提示。

    在 AI Hub 中選擇提示的螢幕截圖。

  4. 選擇建立自己的提示。

    選取 [在 AI 中心建立您自己的提示] 的螢幕擷取畫面。

  5. 提供提示的名稱。

  6. 在 說明 區塊，選擇三個點（...），然後選擇 設定。

    如何開啟提示設定的螢幕截圖。

  7. 在 [設定 ] 頁面上，開啟程式碼解譯器。

  8. 關閉設定頁面以返回提示編輯器。

在已開啟程式碼解譯器的情況下建立空白提示。 接下來，您可以編寫提示說明並根據需要配置提示。

在代理程式中建立提示作為工具，並開啟程式碼解譯器

您可以在 Copilot Studio 的代理程式中建立新的空白提示作為工具，並為該提示開啟程式碼解譯器。 在本文後面，我們將向您展示如何編寫和配置使用程式碼解譯器的提示。

  1. 在 Copilot Studio 中，移至您要開啟程式碼解譯器的代理程式。

  2. 選取工具索引標籤，然後選取新增工具>新工具>提示。

    選擇提示工具的螢幕截圖。

    內嵌提示產生器提示撰寫介面會在 Copilot Studio 中開啟。

  3. 在資訊列中，選擇三個點（...），然後選擇 設定 。

    開啟提示設定截圖。

  4. 在設定頁面上，選擇啟用程式碼解譯器。

  5. 關閉設定頁面以返回提示編輯器。

在已開啟程式碼解譯器的情況下建立空白提示。 接下來，您可以編寫提示說明並根據需要配置提示。

在提示中使用程式碼解譯器的後續步驟

接下來，您可以編寫提示說明並根據需要配置提示。

如需如何在提示中使用程式碼解譯器的詳細範例，請參閱 程式碼解譯器提示範例。

程式碼解譯器提示的最佳做法

  • 使用其他 AI 工具 (例如 Copilot) 取得最佳化提示以開始操作。
  • 使用精確提示並附上範例 (少量提示)。
  • 指定輸出 (例如，"傳回為 JSON" 或 "Excel" 或 "PDF")。

局限性

  • 不支援分析在單一提示中上傳的多個檔案。
  • 不支援在單一提示中傳回多個檔案輸出。
  • 不支援在多個回合中詢問有關上傳檔案的問題。
  • 要使用 Code 直譯器，你需要在代理設定中設定你的代理程式使用使用者驗證。 例如，使用未啟用驗證的直線（Direct Line）在使用程式碼解譯器的情境下無法運作。
  • Last updated on