Microsoft Copilot Studio和提示生成器提示中的代码解释器允许制造商生成 AI 代理,
- 执行用于数据分析、处理Word、Excel、PowerPoint和 PDF 文件和可视化效果的Python代码
- 使用语言模型进行生成响应
此功能专为开发人员、业务分析师和低代码制造商定制。 代码生成和执行与Copilot Studio生态系统无缝集成,以创建功能强大的 AI 驱动解决方案。
开发人员应读取面向开发人员的 Code 解释器并查看 Code 解释器Power Apps组件框架(PCF)组件示例了解如何使用 Dataverse Predict 消息调用提示并处理返回的响应。
要求
Licensing:Microsoft Copilot Studio计费和许可。 代码生成和执行等同于文本和生成式 AI 工具(高级)功能。
支持的区域:适用于所有公有云。 主权云当前不受支持。
代码解释器功能
使用代码解释器的代理可以编写和运行高级任务的Python代码。 用例包括:
- Excel文件处理:在工作簿中创建、复制和更新Excel工作表、读取和应用单元格样式、跨单元格复制格式、跨单元格复制和更新公式等。
- Word和PowerPoint文件处理。
- PDF 文件处理:创建和复制 PDF 文件、读取表格和文本段落。
- Dataverse 表格数据的处理。
- 复杂的数学和统计计算。
- 数据分析、操作和可视化(例如,图表和图形)。
代码解释器将以下功能添加到提示:
- 支持在提示中将文件作为输出类型。
- 支持将Excel文件作为提示的输入和输出类型。
通过以下两种方式之一创建提示:
- 在 Power Apps:在 AI Hub 中使用 生成自己的提示选项。
- 在Copilot Studio中,将提示作为工具添加到代理或主题级别。
在 提示概述中了解有关提示的详细信息。
还可以在Copilot Studio的代理聊天中使用代码解释器。
在 Power Apps AI 中心启动新提示并打开代码解释器
可以在 Power Apps 中的 AI 中心启动新提示,并在提示设置中打开代码解释器。
转到 Power Apps。
在左窗格中选择 AI 中心 。
选择 提示。
选择“ 生成自己的提示”。
输入提示的名称。
在 “说明 ”部分中,选择三个点(...),然后选择 “设置”。
在 “设置”上,打开代码解释器。
关闭 “设置” 以返回到提示编辑器。
打开提示编辑器并打开代码解释器。 接下来, 为提示编写说明。
在代理中以工具的形式启动新提示并打开代码解释器
可以在 Copilot Studio 代理中以工具的形式启动新提示,并为该提示打开代码解释器。
在Copilot Studio中,转到您希望使用代码解释器的代理。
可以在代理级别或主题级别上,将新提示作为一种工具添加到代理中。
在代理级别添加提示:
转到 “工具” 页。
选择添加工具>Prompt。
在主题级别添加提示:
转到 “主题 ”页,选择要在其中添加提示的主题。
在主题中要添加提示的位置选择添加节点。
选择 添加工具>新提示。
此时会打开嵌入式提示生成器提示创作界面。
在信息栏上,选择三个点(...),然后选择“设置”。
在设置页上,选择启用代码解释器。
关闭 “设置” 以返回到提示编辑器。
打开提示编辑器并打开代码解释器。 接下来, 为提示编写说明。
为提示编写说明
接下来,可以编写提示说明,根据需要配置提示,然后保存以创建提示。
详细了解如何在 代码解释器提示示例中的提示中使用代码解释器。
提示中代码解释器的最佳实践
- 使用其他 AI 工具(如Copilot)来获取要启动的优化提示。
- 使用带有示例的精确提示(小样本提示)。
- 指定输出(例如,“返回为 JSON”或“Excel”或“PDF”)。
局限性
- 不支持分析在单个提示中上传的多个文件。
- 不支持在单个提示中返回多个文件输出。
- 系统上不支持在多个轮次中提出有关上传文件的问题。
- 要使用代码解释器,你需要在代理设置中配置你的代理使用用户认证。 例如,选择Direct Line和No authentication不能在使用代码解释器的方案中正常工作。
故障排除
如果在使用代码解释器时遇到错误,请尝试以下步骤:
- 确保授予所有必需的权限。 验证用户帐户和代理是否具有执行代码解释器提示所需的权限。
- 验证配置设置。 确认代码解释器已在提示设置中启用,并且代理已配置为使用用户身份验证。
- 有关详细信息,请参阅错误日志。 查看Copilot Studio或关联的 Power Platform 环境中的错误日志,以确定问题的根本原因并采取纠正措施。