将代码解释器功能添加到代理

可以通过添加代码解释器功能来增强智能 Microsoft 365 Copilot 副驾驶®声明性代理的用户体验。 清单参考中的 capabilities 元素和 智能 Microsoft 365 Copilot 副驾驶® 中的“功能”部分提供了多个选项来解锁用户的功能。

代码解释器是一种高级工具,旨在通过 Python 代码解决复杂任务。 它使用推理模型编写和运行代码,使用户能够解决复杂的数学问题、分析数据、生成可视化效果等。 代码运行后,代码解释器将输出结果及其生成的相关代码。 它还可以根据方案生成图像或文件,并接受文件作为修改和分析的输入。

具有智能 Microsoft 365 Copilot 副驾驶®许可证的用户和未启用按流量计费的Copilot 对话助手用户可以使用代码解释器功能。

注意

对启用了代码解释器的上下文中代理的支持因主机而异。

在 Microsoft 365 Agents Toolkit 中启用代码解释器

如果使用 Agents Toolkit 和 Visual Studio Code 创建代理并想要启用代码解释器,请将 值添加到CodeInterpreter清单文件中的 capabilities 属性,如以下示例所示。

注意

必须使用 1.2 版或更高版本的声明性代理清单架构才能添加 CodeInterpreter 功能。

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

在 智能 Microsoft 365 Copilot 副驾驶® 中启用代码解释器

如果使用 智能 Microsoft 365 Copilot 副驾驶®创建代理并想要启用代码解释器,请打开“配置”选项卡,然后在“功能”下,选择“创建文档、图表和代码”旁边的切换开关。

智能 Microsoft 365 Copilot 副驾驶® 代理生成器中的“功能”部分的屏幕截图

代码解释器功能示例

代码解释器功能使用推理模型允许声明性代理在沙盒环境中编写和运行 Python 代码。 此功能允许用户解决复杂的数学问题、分析数据、生成可视化效果等。 代码运行后,代码解释器将输出结果和生成的代码。 它还可以根据方案生成图像和其他文件,并接受文件作为修改和分析的输入。

将代码解释器添加到代理可为用户提供广泛的功能,包括:

Copilot 还可以提供运行这些任务时生成的代码的可复制和可下载版本。

创建图形和图表

用户可以使用启用了代码解释器的代理来创建图形和图表。 例如,为了响应提示 Graph Fibonacci 序列中的前 20 个数字,Copilot 生成以下折线图。

显示 Fibonacci 序列的前 20 个数字的折线图的屏幕截图。

当用户选择按钮时 </> Code ,代理将提供相应的 Python 代码。

用于绘制 Fibonacci 序列的前 20 个数字的 Python 代码的屏幕截图。

用户还可以上传数据文件以生成图形和图表,以便可视化其数据。 支持的文件格式为 Word、Excel、PowerPoint、PDF、CSV/TSV 和 TXT/UTF8。 例如,用户可以上传包含销售数据的 Excel 文件,并输入提示: 创建我上传的销售数据的条形图和折线图。 代理返回以下响应。

示例销售数据的条形图

示例销售数据的折线图

创建 QR 码和数据可视化效果

启用代码解释器后,用户可以创建各种数据可视化效果,例如 QR 码和字云。 例如,在响应用户提示 为Microsoft的公司网站创建 QR 码时,代理会显示相应的 URL 和匹配的 QR 码。

Copilot 生成的Microsoft的 QR 码

对于单词云,提示 “创建顶级宠物名称的单词云 ”会生成包含最常见名称的图像,如以下示例所示。

对用户提示Word云响应

创建合成数据

当用户需要使用示例数据时,通过集成代码解释器,可以创建用于各种目的的合成数据。 代理可以生成请求的示例数据,然后将其输出为Word、Excel、PowerPoint 或 PDF 文件。 下面是示例提示和响应。

提示:创建包含 10 个虚假金融交易的表,包括日期、金额、商家和类别。

综合财务交易表。

提示:生成有关计费问题的 20 个综合客户支持聊天脚本。

综合客户支持聊天表。

解决复杂的数学问题

向代理添加代码解释器时,用户可以提示代理解决复杂的数学问题,如以下示例所示。

Prompt:为函数 ( f (x (x) = x^3 - 4x^2 + 6x - 2 ) 提供曲线下 ( x = 0 ) 到 ( x = 3 ) 的函数的整数。

曲线下面积的整型计算。

修改上传的图像

集成代码解释器还允许用户修改上传的图像。 具有此功能的代理可以将横幅和标题添加到图像,并且可以生成彩色图像的黑白版本。 (下图由 Copilot.)

图片由科皮洛一辆1934年本特利4汽车生成。

若要修改该图像,用户可以输入提示“为我提供附加图像的黑白版本”。添加一个标有“1934 Bentley 4”的横幅和一个描述文字,上面写着“图片由科皮洛特生成”。代理提供以下结果。

1934年宾利4汽车的黑白图像,由科皮洛修改。