可以通过添加代码解释器功能来增强智能 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 副驾驶®创建代理并想要启用代码解释器，请打开“配置”选项卡，然后在“功能”下，选择“创建文档、图表和代码”旁边的切换开关。
代码解释器功能示例
代码解释器功能使用推理模型允许声明性代理在沙盒环境中编写和运行 Python 代码。 此功能允许用户解决复杂的数学问题、分析数据、生成可视化效果等。 代码运行后，代码解释器将输出结果和生成的代码。 它还可以根据方案生成可下载的图像和其他文件，并接受文件作为修改和分析的输入。
将代码解释器添加到代理可为用户提供广泛的功能，包括：
Copilot 还可以提供运行这些任务时生成的代码的可复制和可下载版本。
创建图形和图表
用户可以使用启用了代码解释器的代理来创建图形和图表。 例如，为了响应提示 Graph Fibonacci 序列中的前 20 个数字，Copilot 生成以下折线图。
当用户选择按钮时 </> Code ，代理将提供相应的 Python 代码。
用户还可以上传数据文件以生成图形和图表，以便可视化其数据。 支持的文件格式为 Word、Excel、PowerPoint、PDF、CSV/TSV 和 TXT/UTF8。 例如，用户可以上传包含销售数据的 Excel 文件，并输入提示： 创建我上传的销售数据的条形图和折线图。 代理返回以下响应。
创建 QR 码和数据可视化效果
启用代码解释器后，用户可以创建各种数据可视化效果，例如 QR 码和字云。 例如，在响应用户提示 为Microsoft的公司网站创建 QR 码时，代理会显示相应的 URL 和匹配的 QR 码。
对于单词云，提示 “创建顶级宠物名称的单词云 ”会生成包含最常见名称的图像，如以下示例所示。
创建合成数据
当用户需要使用示例数据时，通过集成代码解释器，可以创建用于各种目的的合成数据。 代理可以生成请求的示例数据，然后将其输出为Word、Excel、PowerPoint 或 PDF 文件。 用户可以直接从代理的响应下载生成的文件。 下面是示例提示和响应。
提示：创建包含 10 个虚假金融交易的表，包括日期、金额、商家和类别。
提示：生成有关计费问题的 20 个综合客户支持聊天脚本。
解决复杂的数学问题
向代理添加代码解释器时，用户可以提示代理解决复杂的数学问题，如以下示例所示。
Prompt：为函数 ( f (x (x) = x^3 - 4x^2 + 6x - 2 ) 提供曲线下 ( x = 0 ) 到 ( x = 3 ) 的函数的整数。
修改上传的图像
集成代码解释器还允许用户修改上传的图像。 具有此功能的代理可以将横幅和标题添加到图像，并且可以生成彩色图像的黑白版本。 (下图由 Copilot.)
若要修改该图像，用户可以输入提示“为我提供附加图像的黑白版本”。添加一个标有“1934 Bentley 4”的横幅和一个描述文字，上面写着“图片由科皮洛特生成”。代理提供以下结果。
生成可下载的文件
代码解释器可以生成和托管可下载的文件，使代理能够允许用户下载代理生成的文件。 当代码解释器生成 (输出文件（如图像、图表、电子表格或) 文档）时，Copilot 会在响应中自动显示下载链接。 用户可以选择链接在本地保存文件。
此功能在很多情况下都很有用，例如：
- 数据导出：生成包含计算数据或分析结果的 Excel 电子表格，并将其作为下载提供。
- 报表：创建带格式的 PDF 或Word文档，以汇总发现结果并使其可供下载。
- 生成的视觉对象：生成图表、QR 码或 word cloud 作为可下载的图像文件。
- 已处理的文件：对上传的图像或文档应用修改，并将结果作为可下载文件返回。
以下示例提示触发文件生成和自动下载链接创建。
提示：创建包含数字 1 到 10 的乘法表的电子表格，并提供 Excel 文件。
代理生成 Excel 文件并在响应中显示下载链接。
注意
代码解释器生成的Files暂时托管，仅在活动会话期间可供下载。 会话结束后，不会保留Files。