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

教程：在 Azure SRE 代理中创建技能

在本教程中，你将创建一个自定义技能，用于向代理添加领域知识和任务剧本。 技能是代理在相关时自动加载的模块化功能，例如对特定服务进行故障排除或运行诊断过程。

本教程中，您将学习如何：

  • 在子代理生成器中创建技能
  • 在 SKILL.md 中编写技能说明
  • 添加支持文件和工具
  • 在聊天或操场中测试技能
  • 编辑现有技能

估计时间：10 分钟

小窍门

技能和知识文档协同工作。 技能教会智能体如何进行某些操作（流程、Playbook、分步说明）。 知识文档教授代理所需的知识（参考数据、体系结构文档、运行手册）。 还可以将参考文档作为支持文件直接附加到技能。 有关知识上传流，请参阅 “上传知识文档”。

先决条件

在开始之前，请确保满足以下先决条件：

打开子代理构建器，在其中创建和管理技能。

  1. 打开 SRE 代理门户。
  2. 选择你的代理。
  3. 在左侧导航中选择 生成器 。
  4. 选择 子代理生成器。

开始创建技能

从工具栏启动技能创建过程。

  1. 选择工具栏中的 “创建 ”下拉列表。
  2. 选择 “技能”。

技能创建对话框以两列布局打开。 一侧是窗体字段，另一侧是代码编辑器，显示 SKILL.md。

输入名称和说明

提供一个名称和说明，帮助代理决定何时使用此技能。

领域 示例值
名称 high-cpu-troubleshooting
说明 “容器应用上高 CPU 警报的故障排除过程。 检查上游依赖项、连接池以及最近的部署。

在所有技能中，名称必须是唯一的。 说明显示在技能列表中，并帮助代理决定何时使用此技能。

小窍门

选择描述文本旁边的 “编辑” 以切换到编辑模式。 完成后选择保存。

编写技能说明

中心编辑器显示 SKILL.md，其中包含技能的说明。 该文件以默认模板开头。

---
name:
description:
---

<!-- Add your skill instructions here -->

YAML 前置数据（name，description，tools）与左侧的表单字段保持同步。 在首页下方用 Markdown 写下说明：

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

添加支持文件

一侧的 “文件” 部分显示文件浏览器。 除了默认值 SKILL.md，还可以添加引用数据、模板和示例查询。

  • 选择 新文件 图标以添加文件。
  • 选择 新文件夹 图标，将文件组织到目录中。
  • 将文件夹拖放到放置区域，或选择 “上传文件夹 ”链接以上传整个文件夹结构。

在浏览器中选择任何文件，在代码编辑器中对其进行编辑。 编辑器支持 Markdown、JSON、YAML、KQL、Python 和 shell 脚本的语法突出显示。

选择工具

可选地附加技能在执行期间使用的工具。

  1. 在工具部分中选择选择工具。
  2. 浏览或搜索工具。 按类型（自定义工具、MCP 工具）进行筛选或按名称搜索。
  3. 检查此技能所需的工具（例如， kusto_query 或 azure_resource_health）。
  4. 关闭面板。

所选工具显示为可移动标签。 激活技能时，这些工具是动态可用的。

注释

当技能被激活时，添加到技能中的工具会动态可用。 为了更一致的行为，请直接在子代理上配置工具。

若要创建自定义工具，请参阅 创建 Kusto 工具 或 创建 Python 工具。 有关工具的详细信息，请参阅 “工具”。

创建技能

选择 “创建” 以保存技能。

技能显示在子代理生成器的“ 技能 ”选项卡中。 代理现在可以在遇到相关情况时自动使用该技能。

测试技能

默认情况下，主代理可以使用技能，因此你可以直接在聊天中测试它们，而无需先创建子代理。

在新聊天中进行测试

使用新的聊天会话来验证代理是否激活您的技能。

  1. 在边栏中选择 “新建聊天线程 ”。
  2. 键入一个可触发您技能的命令提示。 例如：“我们发现容器应用的 CPU 使用率很高，能否请您调查一下？”
  3. 验证代理激活技能，并遵循您定义的程序。

在游乐场测试

在操场上，通过子智能体来测试技能。

  1. 创建子代理 并向其分配此技能。
  2. 在子代理生成器工具栏上，选择“测试环境”视图切换。
  3. 选择子代理，键入测试提示，并验证它是否正确使用技能。

有关详细信息，请参阅 代理操场。

编辑技能

可以修改现有技能以更新其说明、工具或支持文件。

  1. 在“ 技能 ”选项卡中，选择技能名称或选择它，然后选择 “编辑”。

  2. 此时将打开“编辑”对话框，并预填充所有当前值。 更改所需的字段：

    要更改的内容 在哪里更新
    代理使用时 说明 和 SKILL.md 说明
    要遵循哪些过程 编辑器中的SKILL.md内容
    哪些工具可用 工具> 选择工具
    参考数据 文件> 添加、编辑或删除文件

  3. 选择“保存”。

编写有效技能的提示

使用以下准则创建代理可以有效使用的技能。

  • 具体说明何时使用它。 代理阅读描述和说明以决定相关性。
  • 包括分步过程。 编号步骤为代理人提供明确的剧本。
  • 指定预期的输出。 告知代理结果应采用的格式。
  • 添加引用数据。 上传查询模板、配置基线或已知良好的值作为支持文件。
  • 分配相关工具。 如果技能需要 Kusto 查询或 Azure 操作等特定工具，请添加它们。

后续步骤

了解技能

相关内容

  • Last updated on