你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

教程:在 Azure SRE 代理中使用代码解释器

在本教程中,将为 Azure SRE 代理启用代码解释器,并使用它分析 Azure 数据、生成可视化效果,以及直接从聊天提示创建可下载的文件。

注释

若要了解有关代码解释器及其解决的问题的详细信息,请参阅 代码解释器

本教程中,您将学习如何:

  • 通过代理设置启用代码解释器
  • 使用自然语言提示分析 Azure 资源数据
  • 从对话下载生成的文件
  • 创建可视化效果和 PDF 报表

估计时间:10 分钟

先决条件

在开始之前,请确保具有以下各项:

启用代码解释器

通过早期访问设置打开代码解释器。

  1. 打开 SRE 代理门户 并选择代理。
  2. 在左侧导航中选择 “设置 ”。
  3. 选择“基本信息”
  4. 查找 对功能的早期访问, 并将开关设置为 “开”。

小窍门

早期访问切换应显示为已启用(蓝色)。 代理现在有权访问代码解释器。

提出需要计算的问题

提交数据分析查询以触发代码解释器。

  1. 选择左上角的新聊天线程

  2. 在聊天输入中,键入需要数据分析的问题:

    Analyze the Azure resource groups in my subscription and create a summary
    table showing each resource group name and its region.
    
  3. 选择“ 发送 ”并观察代理的进程。

您的代理:

  • 查询 Azure 以获取资源组数据
  • 编写 Python 代码来处理结果
  • 在安全沙盒中执行代码
  • 返回格式化表

代码解释器分析资源组并显示格式化表的屏幕截图。

您应该看到代理的推理过程(例如,“阐明 Azure 访问需求”、“分析资源组”、“编写用于 markdown 表的代码”),后面是您资源组的格式化表。

下载生成的文件

滚动到代理响应底部,查找 CSV 文件的下载链接。

底部包含可下载 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 秒,具体取决于复杂性。 代理需要时间来编写代码、预配沙盒会话、执行和返回结果。 在重试之前等待完整响应。

早期访问开关未显示

验证你是否对代理拥有正确的权限。 至少需要对代理资源的 参与者 访问权限才能修改设置。

代码执行返回错误

代理通过重试更正的代码自动处理大多数错误。 如果错误仍然存在,请尝试以下作:

  • 将请求简化为较小的步骤。
  • 更具体地了解所需的输出格式。
  • 启动新的聊天线程以重置沙盒会话。

后续步骤