提示
受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。
可以通过添加代码解释器功能来增强智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 的声明性代理的用户体验。 清单参考中的 功能 元素 和代理生成器中的 功能 部分提供了多个选项,用于为用户解锁功能。
代码解释器是一种高级工具,旨在通过 Python 代码解决复杂任务。 它使用推理模型来编写和运行代码,使用户能够解决复杂的数学问题、分析数据、生成可视化等。 代码运行后,代码解释器将输出结果及其生成的相关代码。 还可以根据场景生成可下载的图像或文件,并接受文件作为输入进行修改和分析。
代码解释器功能适用于具有智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 许可证的用户和未启用按流量计费的 Copilot 对话助手用户。
注意
默认情况下,为上下文代理启用代码解释器。 若要更改此设置,请选择“设置”图标并根据需要更新“代码解释器”设置,如以下屏幕截图所示。
在 Microsoft 365 智能体工具包中启用代码解释器
如果使用 Agents Toolkit 和 Visual Studio Code 创建代理,并且想要启用代码解释器,请将值CodeInterpreter添加到清单文件中的 capabilities 属性,如以下示例所示。
注意
必须使用 版本 1.2 或更高版本的声明式代理清单架构来添加此功能 CodeInterpreter 。
{
"capabilities": [
{
"name": "CodeInterpreter"
}
]
}
在代理生成器中启用代码解释器
代码解释器在 代理生成器中始终处于启用状态。 所有代理都会自动包含此功能。
代码解释器功能示例
代码解释器功能使用推理模型允许声明性代理在沙盒环境中编写和运行 Python 代码。 此功能允许用户解决复杂的数学问题、分析数据、生成可视化效果等。 代码运行后,代码解释器会输出结果和生成的代码。 还可以根据场景生成可下载的图像和其他文件,并接受文件作为输入进行修改和分析。
代码解释器提供以下功能:
Copilot 还可以提供在运行这些任务时生成的代码的可复制和可下载版本。
创建图形和图表
用户可以雇用启用了代码解释器的代理来创建图形和图表。 例如,为了响应提示 “绘制斐波那契数列中的前 20 个数字”,Copilot 会生成以下折线图。
当用户选择 </> Code 该按钮时,代理会提供相应的 Python 代码。
用户还可以上传数据文件以生成图形和图表,以便他们可以可视化他们的数据。 支持的文件格式为 Word、Excel、PowerPoint、PDF、CSV/TSV 和 TXT/UTF8。 例如,用户可以上传包含销售数据的 Excel 文件,并输入提示: 为我上传的销售数据创建条形图和折线图。 代理返回以下响应。
创建 QR 码和数据可视化
启用代码解释器后,用户可以创建各种数据可视化,例如二维码和文字云。 例如,为了响应用户提示“ 为 Microsoft 公司网站创建 QR 码”,代理会同时显示相应的 URL 和匹配的 QR 码。
对于词云,提示“ 创建热门宠物名字的词云” 将生成包含最常见名字的图像,如以下示例所示。
创建合成数据
当用户需要使用示例数据时,通过集成代码解释器,您可以为各种目的创建合成数据。 代理可以生成请求的示例数据,然后将其输出为 Word、Excel、PowerPoint 或 PDF 文件。 用户可以直接从代理的响应中下载生成的文件。 以下是示例提示和响应。
提示:创建一个包含 10 个虚假金融交易的表格,包括日期、金额、商家和类别。
提示:生成 20 个有关账单问题的合成客户支持聊天脚本。
解决复杂的数学问题
当您向代理添加代码解释器时,用户可以提示您的代理解决复杂的数学问题,如以下示例所示。
提示:提供函数 ( f (x) = x^3 - 4x^2 + 6x - 2 ) 的曲线下面积的积分,从 ( x = 0 ) 到 ( x = 3 ) 。
修改已上传的图像
集成代码解释器还允许用户修改上传的图像。 具有此功能的代理可以向图像添加横幅和标题,并可以生成彩色图像的黑白版本。 (以下图像由 Copilot 生成。)
若要修改该图像,用户可以输入提示“为我提供附加图像的黑白版本”。添加显示“1934 宾利 4”的横幅和显示“Copilot 生成的图像”的描述文字。代理提供以下结果。
生成可下载文件
代码解释器可以生成和托管可下载的文件,使代理能够允许用户下载代理生成的文件。 当代码解释器) 生成图像、图表、电子表格或文档等输出文件 (时,Copilot 会自动在响应中提供下载链接。 用户可以选择链接在本地保存文件。
此功能在许多场景中都很有用,例如:
- 数据导出:生成包含计算数据或分析结果的 Excel 电子表格,并提供下载。
- 报告:创建一个格式化的 PDF 或 Word 文档,总结发现并使其可供下载。
- 生成的视觉对象:生成图表、QR 码或文字云作为可下载的图像文件。
- 已处理的文件:对上传的图像或文档进行修改,并将结果作为可下载文件返回。
以下示例提示触发文件生成和自动下载链接创建。
提示:创建一张包含数字 1 到 10 乘法表的电子表格,并将 Excel 文件提供给我。
代理生成 Excel 文件,并在响应中提供下载链接。
注意
代码解释器生成的 Files 是临时托管的,并且仅在活动会话期间可供下载。 会话结束后不会保留 Files。