在提示中使用代码解释器生成和执行Python代码

注释

本文介绍了由 标准线束驱动的代理或代理流中使用的功能。

通过使用 Microsoft Copilot Studio 中的代码解释器和提示生成器中的提示,创建者可以构建能够执行以下操作的 AI 代理:

  • 执行Python代码进行数据分析、处理Word、Excel、PowerPoint和PDF文件及可视化。 了解 Word 文档内容限制,请参阅“代理如何阅读上传文件”。
  • 使用语言模型进行生成反应。

此功能专为开发人员、业务分析师和低代码制造商定制。 代码生成和执行与 Copilot Studio 生态系统无缝集成,以创建功能强大的 AI 驱动解决方案。

为了学习如何使用DataversePredict消息调用提示和处理返回的响应,开发者应阅读《开发者代码解释器》并查看代码解释器Power Apps组件框架(PCF)组件示例。

先决条件

代码解释器功能

使用代码解释器的代理可以编写并运行 Python 代码以完成高级任务。 用例包括:

  • Excel文件处理:在工作簿中创建、复制并更新Excel工作表。 读取并应用单元格样式。 在单元格之间复制格式。 复制和更新各个单元格的公式,还有更多功能。
  • Word 和 PowerPoint 文件处理。 对于 Word 文档,代理会从文档正文中的标准段落和表格中读取文本。 了解更多内容,请参阅 “代理人如何阅读上传的文件”。
  • PDF文件处理:创建并复制PDF文件。 阅读表格和文本段落。
  • Dataverse 表格数据的处理。
  • 复杂的数学和统计计算。
  • 数据分析、操作和可视化(例如,图表和图形)。

代码解释器将以下功能添加到提示:

  • 支持在提示中将文件作为输出类型。
  • 支持将Excel文件作为提示的输入和输出类型。

注释

要搜索 Excel 文件内容,请使用代码解释器代替语义搜索。 语义搜索在单元格索引方面存在局限性。

通过以下两种方式之一创建提示:

  • 在 Power Apps:在 AI Hub 中使用 生成自己的提示选项。
  • 在Copilot Studio中,将提示作为工具添加到代理或主题级别。

在 提示概述中了解有关提示的详细信息。

也可以在 Copilot Studio 中的代理聊天中使用代码解释器。

在 Power Apps AI 中心启动新提示并打开代码解释器

可以在 Power Apps 中的 AI 中心启动新提示,并在提示设置中打开代码解释器。

  1. 转到 Power Apps。

  2. 在左窗格中选择 AI 中心 。

  3. 选择 提示。

    AI 中心中选择提示的截图

  4. 选择“ 生成自己的提示”。

    在 AI 中心选择“生成自己的提示”的屏幕截图。

  5. 输入提示的名称。

  6. 在 “说明 ”部分中,选择三个点(...),然后选择 “设置”。

    如何打开提示设置的屏幕截图。

  7. 在 “设置”上,打开代码解释器。

  8. 关闭 “设置” 以返回到提示编辑器。

打开提示编辑器并打开代码解释器。 接下来, 为提示编写说明。

在代理中以工具的形式启动新提示并打开代码解释器

可以在 Copilot Studio 代理中以工具的形式启动新提示,并为该提示打开代码解释器。

  1. 在Copilot Studio中,转到您希望使用代码解释器的代理。

  2. 在智能体级别或主题级别,将新提示作为工具添加到智能体中。

    • 在代理级别添加提示:

      1. 转到 “工具” 页。

      2. 选择添加工具>Prompt。

    • 在主题级别添加提示:

      1. 转到 “主题 ”页,选择要在其中添加提示的主题。

      2. 在主题中要添加提示的位置选择添加节点。

      3. 选择 添加工具>新提示。

    此时会打开嵌入式提示生成器提示创作界面。

  3. 在信息栏上,选择三个点(...),然后选择“设置”。

    打开提示设置的屏幕截图。

  4. 在设置页上,选择启用代码解释器。

  5. 关闭 “设置” 以返回到提示编辑器。

打开提示编辑器并打开代码解释器。 接下来, 为提示编写说明。

为提示编写说明

接下来,写提示指令,按需配置提示,然后保存创建提示词。

详细了解如何在 代码解释器提示示例中的提示中使用代码解释器。

提示中代码解释器的最佳实践

  • 使用 Copilot 等其他 AI 工具获取优化提示以启动。
  • 使用带有示例的精确提示(小样本提示)。
  • 指定输出(例如,“返回为 JSON”或“Excel”或“PDF”)。

局限性

注释

代理可能无法读取仅出现在文本框、形状、WordArt、SmartArt、页眉和页脚、嵌入对象或链接对象中的 Word 文档文本。 了解代理人 如何解读上传文件的详细信息和技巧。

  • 不支持分析在单个提示中上传的多个文件。
  • 不支持在单个提示中返回多个文件输出。
  • 系统上不支持在多个轮次中提出有关上传文件的问题。
  • 要使用代码解释器,你需要在代理设置中配置你的代理使用用户认证。 例如,在启用代码解释器的场景中,选择无身份验证的 Direct Line 将无法正常工作。

Troubleshooting

如果在使用代码解释器时遇到错误,请尝试以下步骤:

  1. 确保授予所有必需的权限。 验证用户帐户和代理是否具有执行代码解释器提示所需的权限。
  2. 验证配置设置。 确认代码解释器已在提示设置中启用,并且代理已配置为使用用户身份验证。
  3. 有关详细信息,请参阅错误日志。 查看 Copilot Studio 或关联的 Power Platform 环境中的错误日志,以确定问题的根本原因并采取纠正措施。