azure-infra-free

核心功能: 本技能提供等高级功能等能力。

Azure Infra Free

输入参数

部署指引

1. 检查 CLI 是否安装：az --version。若未安装，提示用户安装 Azure CLI.
2. 检查登录状态：az account show。若未登录，引导用户执行 az login --use-device-code.
3. 使用默认订阅或询问用户选择目标订阅.
4. 使用只读命令（list/show/get）回答用户问题. 结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.

安全规则

• 所有操作均为只读，本免费版不执行任何写操作或破坏性变更.
• 若用户请求变更（删除、启停、修改），提示该功能需升级至付费版.
• 禁止输出或记录任何密钥（access key、client secret、token、password）.

安全风险防范

基础查询命令

订阅切换：az account list -o table 查看所有订阅，az account set --subscription 切换目标订阅。查询结果涉及订阅范围时明确标注所用订阅名称.

简单健康检查

• VM 电源状态：az vm list --show-details --query "[].{name:name,state:powerState}" -o table
• VM 实例视图：az vm get-instance-view --name -g --query "instanceView.statuses" -o table
• 失败活动日志：az monitor activity-log list --status Failed --offset 1h -o table
• CPU 指标：az monitor metrics list --resource --metric "Percentage CPU" --interval PT1H -o table

工作流程

1. 前置检查：CLI 安装、登录状态、订阅上下文.
2. 只读执行：执行 list/show 命令查询资源.
3. 结果呈现：结构化输出结果，标注所用订阅.
4. 写操作拦截：用户请求变更时，提示升级付费版.

案例展示

案例 1：盘点订阅内虚拟机运行状态

用户请求：帮我看看这个订阅里有哪些虚拟机，分别是什么状态. 执行流程：

# 1. 确认当前订阅
az account show --query "{name:name,id:id}" -o table
# ...
# 2. 列出所有虚拟机及电源状态（只读）
az vm list --show-details --query "[].{name:name,rg:resourceGroup,state:powerState,sku:hardwareProfile.vmSize}" -o table

输出说明：以表格列出虚拟机名称、资源组、电源状态、规格。用户可据此识别停止的实例。若用户希望启停或删除实例，提示该操作需升级付费版.

案例 2：查看最近失败的活动日志

用户请求：最近一小时有没有什么操作失败了？

执行流程：

az monitor activity-log list --status Failed --offset 1h --query "[].{time:eventTimestamp,resource:resourceId,op:operationName.value}" -o table

输出说明：列出最近 1 小时状态为 Failed 的活动事件，包含时间、资源 ID、操作名。用于初步定位异常操作.

异常应对

常见疑问

Q1：如何切换到另一个订阅查询？

A：az account list -o table 查看所有订阅，az account set --subscription 切换，然后执行查询命令.

Q2：查询返回数据太多看不清怎么办？

A：使用 --query 参数过滤字段，例如 --query "[].{name:name,rg:resourceGroup}"，并用 -o table 输出表格格式.

Q3：我能用这个免费版启停虚拟机或删除资源吗？

A：不能。本免费版仅支持只读查询。启停虚拟机、删除资源、修改配置等写操作需升级至付费版 azure-infra 技能，付费版提供完整的确认机制与 dry-run 支持.

Q4：Key Vault 机密值能查出来吗？

A：本免费版不查询 Key Vault 机密值，也不展示任何密钥、令牌等敏感凭据，确保安全.

能力边界

• 仅支持只读查询，不支持任何写操作或破坏性变更.
• 不包含安全审计（NSG 暴露面、RBAC 检查、存储公开访问检查）.
• 不包含 Cost Management 成本分析.
• 不支持跨订阅批量查询，需手动切换订阅.
• 依赖本地 Azure CLI 与网络连接到 Azure ARM 端点.

升级提示

本免费版仅提供基础只读查询能力。如需完整功能（写操作确认、安全审计、成本分析、跨订阅查询、故障诊断、Key Vault 管理），请升级至付费版 azure-infra 技能.

调用前提

• 用户明确提到 Azure、az cli、Azure 资源查询等关键词且仅需只读查询时激活.
• 用户请求写操作、安全审计、成本分析时，提示需升级付费版.

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

主要能力

安全规则(补充)

基础查询命令(补充)

简单健康检查(补充)

{name:name,state:powerState}" -o table`

• **失败

工作流程(补充)

触发条件(补充)

结果格式

{
  "success": true,
  "data": {
    "result": "Azure Infra Free处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "azure-infra"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

---

边界条件与限制 (Boundary Conditions)

Azure Infra Free技能在执行过程中存在以下边界条件和限制：

• 输入数据长度限制：对于输入的命令和查询参数，存在字符长度限制，超过限制可能导致命令无法正确执行。
• 查询结果数量限制：对于某些查询命令，如资源列表查询，存在返回结果数量的限制，大量资源可能导致查询失败或响应时间过长。
• 资源类型限制：部分高级资源类型，如虚拟机扩展、网络接口等，可能不支持查询或查询结果不完整。
• 网络连接限制：技能执行依赖于稳定的网络连接，网络不稳定可能导致查询失败或响应时间过长。
• 性能限制：对于复杂的查询或大量资源的查询，技能的执行时间可能会增加，可能需要等待较长时间才能获得结果。
• 订阅限制：技能不支持跨订阅查询，用户需要手动切换到目标订阅才能执行查询操作。
• 权限限制：技能执行依赖于用户的Azure订阅权限，若用户权限不足，可能导致查询失败或部分功能不可用。

性能边界 (Performance Boundaries)

Azure Infra Free技能的性能边界包括：

• 查询响应时间：对于简单的查询操作，如列出资源组，响应时间通常在几秒内。对于复杂的查询，如查询大量虚拟机状态，响应时间可能会更长。
• 资源限制：技能不支持查询大量资源，如超过数千个虚拟机或存储账户，可能导致查询失败或响应时间过长。
• 并发限制：技能不支持并发执行多个查询操作，每个查询操作之间需要等待前一个操作完成。

兼容性约束 (Compatibility Constraints)

Azure Infra Free技能的兼容性约束如下：

• Azure CLI版本：技能依赖于Azure CLI工具，需要确保本地安装的Azure CLI版本与技能版本兼容。
• 操作系统：技能在Windows、macOS和Linux操作系统上均支持，但可能存在某些特定功能的兼容性问题。
• 网络连接：技能执行依赖于稳定的网络连接，需要确保网络连接到Azure ARM端点。

---

场景介绍

使用场景

• 个人开发者日常Operations任务处理
• 团队协作中的自动化流程
• 批量数据处理与格式转换

触发条件

触发条件: 当用户需要处理Operations相关任务时自动激活

限制说明

不适用: 超大文件处理(>100MB)或高并发场景(>100QPS)，建议使用专业版或企业方案

创新特色

效率提升量化分析

差异化对比

核心痛点解决

问题处理指引

核心功能特性

• 自动化执行: 通过本地 Azure
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

主要功能

• 自动化执行: 通过本地 Azure
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

异常修复

针对Azure免费版使用中可能遇到的常见问题,提供以下排查方案:

Azure免费版通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

问答精选汇总