通过


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

Microsoft Copilot Studio和提示生成器提示中的代码解释器允许制造商生成 AI 代理,

  • 执行用于数据分析、处理Word、Excel、PowerPoint和 PDF 文件和可视化效果的Python代码
  • 使用语言模型进行生成响应

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

开发人员应读取面向开发人员的 Code 解释器并查看 Code 解释器Power Apps组件框架(PCF)组件示例了解如何使用 Dataverse Predict 消息调用提示并处理返回的响应。

要求

代码解释器功能

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

  • Excel文件处理:在工作簿中创建、复制和更新Excel工作表、读取和应用单元格样式、跨单元格复制格式、跨单元格复制和更新公式等。
  • Word和PowerPoint文件处理。
  • PDF 文件处理:创建和复制 PDF 文件、读取表格和文本段落。
  • Dataverse 表格数据的处理。
  • 复杂的数学和统计计算。
  • 数据分析、操作和可视化(例如,图表和图形)。

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

  • 支持在提示中将文件作为输出类型。
  • 支持将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. 关闭 “设置” 以返回到提示编辑器。

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

为提示编写说明

接下来,可以编写提示说明,根据需要配置提示,然后保存以创建提示。

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

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

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

局限性

  • 不支持分析在单个提示中上传的多个文件。
  • 不支持在单个提示中返回多个文件输出。
  • 系统上不支持在多个轮次中提出有关上传文件的问题。
  • 要使用代码解释器,你需要在代理设置中配置你的代理使用用户认证。 例如,选择Direct LineNo authentication不能在使用代码解释器的方案中正常工作。

故障排除

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

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