你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
在本教程中,将为 Azure SRE 代理启用代码解释器,并使用它分析 Azure 数据、生成可视化效果,以及直接从聊天提示创建可下载的文件。
注释
若要了解有关代码解释器及其解决的问题的详细信息,请参阅 代码解释器。
本教程中,您将学习如何:
- 通过代理设置启用代码解释器
- 使用自然语言提示分析 Azure 资源数据
- 从对话下载生成的文件
- 创建可视化效果和 PDF 报表
估计时间:10 分钟
先决条件
在开始之前,请确保具有以下各项:
启用代码解释器
通过早期访问设置打开代码解释器。
- 打开 SRE 代理门户 并选择代理。
- 在左侧导航中选择 “设置 ”。
- 选择“基本信息”。
- 查找 对功能的早期访问, 并将开关设置为 “开”。
小窍门
早期访问切换应显示为已启用(蓝色)。 代理现在有权访问代码解释器。
提出需要计算的问题
提交数据分析查询以触发代码解释器。
选择左上角的新聊天线程。
在聊天输入中,键入需要数据分析的问题:
Analyze the Azure resource groups in my subscription and create a summary table showing each resource group name and its region.选择“ 发送 ”并观察代理的进程。
您的代理:
- 查询 Azure 以获取资源组数据
- 编写 Python 代码来处理结果
- 在安全沙盒中执行代码
- 返回格式化表
您应该看到代理的推理过程(例如,“阐明 Azure 访问需求”、“分析资源组”、“编写用于 markdown 表的代码”),后面是您资源组的格式化表。
下载生成的文件
滚动到代理响应底部,查找 CSV 文件的下载链接。
选择链接以下载 CSV 文件,并验证它是否包含资源组数据。 这确认代码解释器可以生成可在对话外部使用的文件。
生成可视化效果
请向代理索要图表。
Create a bar chart showing how many resource groups I have in each Azure region.
Include a title and axis labels.
智能代理编写 matplotlib 代码,执行该代码,并内嵌在对话中显示图表。 图像应内嵌显示在聊天中,展示按区域分布的资源组条形图。
创建 PDF 报表
要求代理创建格式化报表:
Create a PDF report titled "Azure Resource Group Summary" that includes:
- A summary of total resource groups and regions used
- The table of all resource groups and regions
- The bar chart from the previous step
Save it as resource-group-report.pdf
代理将数据、表和图表合并为格式化的 PDF,并返回下载链接。 下载该文件以验证该文件是否包含摘要、表和图表。 整个流程演示:从 Azure 数据到分析再到格式化报表。
故障排除
使用以下信息解决常见问题。
代理说“我只能协助 Microsoft Azure 相关主题”
代码解释器在 Azure SRE 任务的上下文中工作。 围绕 Azure 环境制定提示。 例如,尝试“分析 Azure 资源组中的部署频率”,而不是“计算 Fibonacci 序列”。
代码执行似乎很慢
代码执行通常需要 15 到 30 秒,具体取决于复杂性。 代理需要时间来编写代码、预配沙盒会话、执行和返回结果。 在重试之前等待完整响应。
早期访问开关未显示
验证你是否对代理拥有正确的权限。 至少需要对代理资源的 参与者 访问权限才能修改设置。
代码执行返回错误
代理通过重试更正的代码自动处理大多数错误。 如果错误仍然存在,请尝试以下作:
- 将请求简化为较小的步骤。
- 更具体地了解所需的输出格式。
- 启动新的聊天线程以重置沙盒会话。