在提示詞中使用程式碼直譯器來產生並執行 Python 程式碼

Microsoft Copilot Studio 中的程式碼解譯器與提示構建器功能，讓開發者能打造具備以下功能的 AI 代理：

  • 執行 Python 程式碼進行資料分析、處理 Word、Excel、PowerPoint 及 PDF 檔案，以及視覺化
  • 使用語言模型進行生成式回應

此功能是專為開發人員、業務分析師和低程式碼製作者量身訂做。 程式碼生成與執行與 Copilot Studio 生態系統無縫整合，打造強大的 AI 驅動解決方案。

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

Requirements

程式碼直譯器功能

使用程式碼直譯器的代理程式可以撰寫並執行進階任務的 Python 程式碼。 使用案例包括：

  • Excel 檔案處理：建立、複製及更新 Excel 工作表，閱讀並套用儲存格樣式，跨儲存格複製格式，跨儲存格複製與更新公式，還有更多功能。
  • Word 和 PowerPoint 檔案處理。
  • PDF 檔案處理：建立並複製 PDF 檔案，閱讀表格與文字段落。
  • Dataverse 資料表的數據處理。
  • 數學和統計的複雜計算。
  • 資料分析、操作和視覺效果呈現 (例如，圖表和圖形)。

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

  • 支援在提示詞中將檔案作為輸出類型。
  • 支援 Excel 檔案作為提示輸入與輸出類型。

透過兩種方式之一創建提示：

  • Power Apps：在 AI Hub 中使用建立您自己的提示選項。
  • 在 Copilot Studio 中：將提示新增為代理或主題層級的工具。

在提示總 覽中了解更多關於提示的資訊。

你也可以在 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. 在代理中新增一則新的提示作為工具，無論是在代理層級或主題層級。

    • 在代理人層級新增提示：

      1. 前往 工具 頁面。

      2. 選擇 「新增工具>提示」。

    • 在主題層級新增一個提示：

      1. 到 主題頁面， 選擇你想加入提示的主題。

      2. 在你想新增提示詞的主題位置選擇 新增節點 。

      3. 選取 [新增工具>][新增提示]。

    內嵌提示建構器的提示編輯介面已開啟。

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

    開啟提示設定截圖。

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

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

提示詞編輯器開啟並開啟程式碼直譯器。 接著， 為你的提示寫下指示。

為你的提示語寫下指示

接著，你可以撰寫提示指令，根據需要設定提示，並儲存以建立提示詞。

在 程式碼解釋器提示範例中了解如何在提示中使用程式碼解釋器的資訊。

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

  • 使用其他 AI 工具如 Copilot 來獲得優化的啟動提示。
  • 使用精確提示並附上範例 (少量提示)。
  • 指定輸出（例如「以 JSON 回傳」、「Excel」或「PDF」）。

局限性

  • 不支援分析在單一提示中上傳的多個檔案。
  • 不支援在單一提示中傳回多個檔案輸出。
  • 不支援在多個回合中詢問有關上傳檔案的問題。
  • 要使用 Code 直譯器，你需要在代理設定中設定你的代理程式使用使用者驗證。 例如，使用 Direct Line 並選擇 No Authentication，對於使用程式碼直譯器的情境無法運作。

故障排除

如果使用程式碼直譯器時遇到錯誤，請嘗試以下步驟：

  1. 確保所有必要的權限都已核發。 確認使用者帳號與代理程式是否具備執行程式碼直譯提示的必要權限。
  2. 驗證組態設定。 確認提示音設定中啟用了程式碼直譯器，且你的代理程式是否設定為使用使用者認證。
  3. 請參閱錯誤日誌以獲得詳細資訊。 請檢視 Copilot Studio 或相關的 Power Platform 環境中的錯誤日誌，找出問題根源並採取矯正措施。
  • Last updated on