將代碼解譯器功能新增到您的代理程式

秘訣

推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。

您可以新增程式碼解譯器功能,以增強 Microsoft 365 Copilot 宣告式代理程式的使用者體驗。 資訊清單參考中的 capabilities 元素 ,以及 Agent Builder 中的 [功能 ] 區段,提供數個選項,供您為使用者解除鎖定功能。

程式碼解釋器是一種高級工具,旨在透過 Python 程式碼解決複雜的任務。 它使用推理模型來編寫和運行代碼,使用戶能夠解決複雜的數學問題、分析數據、生成可視化等。 程式碼執行之後,程式碼解譯器會輸出結果及其產生的相關程式碼。 它還可以根據場景生成可下載的圖像或文件,並接受文件作為修改和分析的輸入。

程式碼解譯器功能可供擁有 Microsoft 365 Copilot 授權的使用者,以及未啟用計量付費使用的 Copilot Chat 使用者使用。

注意

根據預設,內容內代理程式會啟用 [程式碼解譯器]。 若要變更此設定,請選取 [設定] 圖示,然後視需要更新 [程式碼解譯器] 設定,如下列螢幕擷取畫面所示。

在 Microsoft 365 Agents Toolkit 中啟用程式碼解譯器

如果您使用代理程式工具組和 Visual Studio Code 建立代理程式,並且想要啟用程式碼解譯器,請將值新增至CodeInterpreter資訊清單檔案中的 capabilities 屬性,如下列範例所示。

注意

您必須使用 1.2 版 或更新版本的宣告式代理程式資訊清單架構,才能新增 CodeInterpreter 此功能。

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

在 Agent Builder 中啟用程式碼解譯器

程式碼解譯器一律會在 Agent Builder 中啟用。 此功能會自動包含在所有代理程式中。

程式碼解譯器功能範例

程式碼解釋器功能使用推理模型來允許宣告式代理程式在沙箱化環境中撰寫和執行 Python 程式碼。 此功能可讓使用者解決複雜的數學問題、分析數據、產生視覺化等等。 程式碼執行後,程式碼解釋器會輸出結果和產生的程式碼。 它還可以根據場景生成可下載的圖像和其他文件,並接受文件作為修改和分析的輸入。

程式碼解譯器提供下列功能:

Copilot 也可以提供執行這些工作時所產生程式碼的可複製和可下載版本。

建立圖形和圖表

用戶可以使用啟用了代碼解釋器的代理來創建圖形和圖表。 例如,為了回應提示 繪製 斐波那契數列中的前 20 個數字,Copilot 會產生下列折線圖。

顯示斐波那契數列前 20 個數字的折線圖螢幕擷取畫面。

當使用者選取 </> Code 按鈕時,代理程式會提供對應的 Python 程式碼。

用於繪製斐波那契數列前 20 個數字的 Python 程式碼的螢幕擷取畫面。

用戶還可以上傳數據文件以生成圖形和圖表,以便他們可以可視化他們的數據。 支援的檔案格式為 Word、Excel、PowerPoint、PDF、CSV/TSV 和 TXT/UTF8。 例如,使用者可以上傳含有銷售資料的 Excel 檔案,然後輸入提示: 建立上傳的銷售資料的橫條圖和折線圖。 代理程式會傳回下列回應。

範例銷售資料的橫條圖

範例銷售資料的折線圖

建立 QR 代碼和資料視覺效果

啟用代碼解釋器後,用戶可以創建各種數據可視化,例如 QR 碼和詞雲。 例如,在回應使用者提示「 為 Microsoft 公司網站建立 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 年賓利 4 汽車影像。

若要修改該影像,使用者可以輸入提示 [提供我附加影像的黑白版本]。新增寫著「1934 Bentley 4」的橫幅和寫著「由 Copilot 產生的影像」的標題。代理程式會提供下列結果。

由 Copilot 修改的 1934 年 Bentley 4 汽車的黑白影像。

產生可下載的檔案

代碼解釋器可以產生和託管可下載的檔案,使您的代理程式能夠允許使用者下載代理程式產生的檔案。 當程式碼解譯器產生輸出檔案 (,例如影像、圖表、試算表或) 的文件時,Copilot 會自動在回應中顯示下載連結。 使用者可以選取連結以將檔案儲存在本機。

此功能在許多案例中都很實用,例如:

  • 資料匯出:產生計算資料或分析結果的 Excel 試算表,並提供下載。
  • 報告:建立格式化的 PDF 或 Word 文件,總結結果並可供下載。
  • 產生的視覺效果:產生圖表、QR 碼或文字雲作為可下載的影像檔案。
  • 已處理的檔案:將修改套用至上傳的影像或文件,並將結果傳回為可下載的檔案。

下列範例提示會觸發檔案產生和自動下載連結建立。

提示:建立包含數字 1 到 10 乘法表的試算表,並提供 Excel 檔案給我。

代理程式會產生 Excel 檔案,並在回應中顯示下載連結。

注意

程式碼解釋器產生的 Files 是暫時託管的,只能在作用中工作階段期間下載。 工作階段結束後不會保留 Files。