azure-resource-lookup

Visão geral

O que é azure-resource-lookup?

azure-resource-lookup é uma skill de descoberta e relatórios para Azure que ajuda você a listar, localizar e inspecionar recursos Azure de praticamente qualquer tipo, em múltiplas subscriptions e resource groups.

Ela usa Azure Resource Graph (ARG) para consultas rápidas entre subscriptions sobre o metadado do Azure Resource Manager (ARM). Isso a torna adequada para perguntas de inventário como:

• "list websites"
• "list virtual machines"
• "list my VMs in subscription X"
• "show storage accounts in this resource group"
• "find container apps in region Y"
• "what resources do I have?"

Nos bastidores, azure-resource-lookup traduz essas intenções em consultas ARG, para que você obtenha visões estruturadas e quase em tempo real do seu ambiente sem precisar escrever KQL manualmente para cada requisição.

Para quem é esta skill?

azure-resource-lookup é voltada para:

• Engenheiros de cloud e plataforma que precisam de visibilidade rápida sobre recursos Azure em várias subscriptions.
• Times de DevOps e SRE que querem buscar tipos específicos de recurso, estados ou tags como parte de fluxos operacionais.
• Times de segurança e compliance que precisam verificar se tags ou configurações obrigatórias estão presentes.
• Desenvolvedores que querem uma forma simples de responder "onde este app/componente está rodando?" ou "quais recursos este deployment criou?" sem navegar manualmente pelo Azure Portal.

Se sua necessidade principal é relatório, inventário e descoberta de recursos no Azure, esta skill é um bom encaixe.

Que problemas a azure-resource-lookup resolve?

Use azure-resource-lookup quando você precisar:

• Listar recursos de qualquer tipo comum
  • Máquinas virtuais, web apps, storage accounts, container apps, bancos de dados e muito mais.
• Mostrar recursos por escopo
  • Restringir resultados a uma subscription específica, um conjunto de subscriptions ou um resource group específico.
• Executar buscas entre subscriptions
  • Responder perguntas como "show all storage accounts in all production subscriptions" sem trocar de contexto.
• Encontrar recursos órfãos ou não utilizados
  • Descobrir discos desanexados, NICs não usados, IPs ociosos e outros candidatos prováveis a limpeza.
• Verificar cobertura e convenções de tags
  • Localizar recursos sem tags obrigatórias ou agrupar recursos por valores de tag (como env, owner, costCenter).
• Montar um inventário de recursos
  • Contar recursos por tipo, região ou subscription para documentação ou auditoria.
• Filtrar por estado do recurso
  • Encontrar recursos parados, com problemas de saúde ou falha de provisionamento usando o metadado indexado no Resource Graph.

Isso se alinha a cenários de relatório e visibilidade em que você precisa de visões claras e consultáveis da sua infraestrutura Azure existente.

Quando esta skill não é uma boa opção?

azure-resource-lookup não foi projetada para:

• Criar ou modificar recursos
  • Ela não cria, atualiza ou exclui recursos Azure.
• Análise de custos e otimização
  • Ela não calcula gastos, recomendações de rightsizing ou detalhamento de custos.
• Clouds que não sejam Azure ou recursos on-premises
  • É específica para recursos do Azure Resource Manager expostos via Azure Resource Graph.
• Ferramentas profundas e específicas de recurso
  • Para operações muito especializadas (por exemplo, trabalho em schema de banco de dados, gerenciamento de objetos Kubernetes ou mudanças detalhadas de configuração de VMs), utilize ferramentas dedicadas ou outras skills.

Se você precisa de visão operacional e inventário em Azure, azure-resource-lookup é bem adequada. Se você precisa de mudanças, automação ou análise de custos, combine com outras ferramentas.

Como usar

Pré-requisitos

Antes de instalar e usar azure-resource-lookup, verifique se:

• Você tem uma conta Azure com permissões adequadas para ler recursos nas subscriptions de destino.
• Azure Resource Graph está disponível no seu tenant (ele vem habilitado por padrão na maioria dos cenários).
• Seu agente ou ambiente de automação consegue autenticar no Azure (via az login, managed identity ou service principal, dependendo da sua configuração).

A skill está no repositório GitHub microsoft/azure-skills, no caminho skills/azure-resource-lookup, e foi projetada para funcionar em runtimes de agente compatíveis que suportam skills desse repositório.

Passos de instalação

1. Adicione o repositório azure-skills e esta skill

Se o runtime do seu agente suporta npx skills (por exemplo, as ferramentas de skills da Microsoft), você pode adicionar azure-resource-lookup diretamente do GitHub:

npx skills add https://github.com/microsoft/azure-skills --skill azure-resource-lookup

Esse comando:

• Registra o repositório microsoft/azure-skills como fonte de skills.
• Instala a definição da skill azure-resource-lookup e material de referência associado no ambiente do seu agente.

Se sua plataforma usa outro mecanismo, aponte para:

• Repository: https://github.com/microsoft/azure-skills
• Skill path: skills/azure-resource-lookup

e siga os passos documentados da plataforma para adicionar uma skill.

2. Revise a definição da skill

Após a instalação, abra o arquivo SKILL.md no diretório azure-resource-lookup. Esse arquivo contém:

• A descrição oficial e os principais casos de uso.
• Orientação sobre quando usar esta skill em vez de outras do mesmo repositório.

Use esse conteúdo para confirmar que a skill corresponde ao seu cenário (inventário e consulta de recursos em Azure).

3. Configure o acesso ao Azure para seu agente

Configure o ambiente onde seu agente roda para que ele possa consultar o Azure Resource Graph. Alguns padrões comuns:

• Login interativo com Azure CLI para testes locais:

  az login
  

• Service principal para automação não interativa:

  az login --service-principal -u <APP_ID> -p <PASSWORD_OR_CERT> --tenant <TENANT_ID>
  

• Managed identity ao rodar em serviços hospedados no Azure que oferecem esse recurso.

A skill aproveita o metadado dos recursos, portanto normalmente precisa de permissões Reader ou semelhantes, somente leitura, nas subscriptions consultadas.

4. Conecte a skill ao seu agente

A maioria das plataformas de agente que suportam esse repositório expõe a skill automaticamente após a instalação. Em UIs de configuração ou manifests JSON, verifique se:

• azure-resource-lookup está listada entre as skills habilitadas.
• A skill tem acesso às mesmas credenciais Azure configuradas no passo anterior.

Consulte a documentação do seu framework de agente para finalizar a ligação entre skills e ferramentas.

Consultando recursos Azure com a skill

Prompts em linguagem natural mais comuns

Depois de configurada, você pode interagir com azure-resource-lookup usando prompts em linguagem natural. Alguns exemplos alinhados com o SKILL.md:

• Listagem de recursos

  • "List virtual machines in my production subscription."
  • "Show storage accounts in resource group rg-app-prod."
  • "List container apps in region westeurope."

• Buscas baseadas em tags

  • "Find resources tagged env=prod in all subscriptions."
  • "Which resources are missing the owner tag in subscription X?"

• Recursos órfãos

  • "List unattached managed disks in all subscriptions."
  • "Show idle IP addresses that are not associated with any resource."

• Inventário e contagens

  • "Count all resources by type across all subscriptions."
  • "How many storage accounts are in each region?"

• Consultas baseadas em estado

  • "Show virtual machines that are stopped."
  • "List resources in a failed provisioning state."

A skill traduz esses pedidos em consultas Azure Resource Graph e retorna resultados estruturados, prontos para relatórios ou análises posteriores.

Usando padrões de consulta do Azure Resource Graph

Para cenários mais avançados, consulte o arquivo de referência references/azure-resource-graph.md no repositório. Ele documenta:

• O formato padrão do comando az graph query:

  az graph query -q "<KQL>" --query "data[].{col1:field1, col2:field2}" -o table
  

• Tabelas principais como Resources, ResourceContainers, HealthResources e outras.
• Conceitos básicos de KQL para Resource Graph, como =~ (comparação case-insensitive), mv-expand, isempty() e tostring().
• Padrões práticos de inventário, por exemplo:
  • Contar recursos por tipo.
  • Agrupar recursos por localização.

Mesmo que você não rode az graph query manualmente, esses padrões ajudam a entender o que a skill faz por baixo dos panos e como interpretar os resultados.

Integração em fluxos de trabalho e relatórios

Por ser focada em inventário e descoberta somente leitura, azure-resource-lookup se encaixa naturalmente em:

• Dashboards operacionais – alimentar ferramentas de relatório com resultados diários de contagem e cobertura de recursos.
• Verificações de governança e compliance – escanear regularmente tags ausentes ou configurações não permitidas.
• Campanhas de limpeza – identificar discos órfãos, NICs não usados ou IPs ociosos antes de executar workflows de deleção com outras ferramentas.
• Revisões de release e ambiente – verificar quais recursos existem em cada ambiente após deployments.

Use esta skill como a camada de informação em fluxos maiores: ela informa o que existe e em que estado, enquanto outras ferramentas executam mudanças quando necessário.

FAQ

Em que a azure-resource-lookup se baseia nos bastidores?

azure-resource-lookup foi criada para funcionar com Azure Resource Graph, o serviço de metadado indexado do Azure para recursos ARM. Ela emite consultas no estilo ARG para pesquisar e filtrar rapidamente recursos em várias subscriptions e resource groups, retornando esses resultados para o seu agente.

Posso usar azure-resource-lookup para criar ou excluir recursos Azure?

Não. azure-resource-lookup é uma skill de descoberta e relatórios somente leitura. Ela não se destina à criação, alteração ou exclusão de recursos Azure. Para essas tarefas, combine com ferramentas de deployment como templates ARM/Bicep, Terraform ou outras skills de automação.

Esta skill funciona com clouds que não são Azure?

Não. azure-resource-lookup é específica para recursos do Azure Resource Manager expostos via Azure Resource Graph. Ela não consulta AWS, GCP ou ambientes on-premises.

azure-resource-lookup é adequada para análise ou otimização de custos?

Não diretamente. Embora você possa usá-la para fazer inventário de recursos (algo que costuma ser insumo para análise de custos), a skill não foi projetada para otimização de custos. Ela não oferece cálculos de custo, estimativas de preço ou recomendações de rightsizing.

Quais permissões são necessárias para usar esta skill?

Você precisa de pelo menos acesso de leitura (por exemplo, papel Reader) nas subscriptions e resource groups que deseja consultar. Como azure-resource-lookup é somente leitura e usa Resource Graph, permissões elevadas além de leitura geralmente não são necessárias.

Como azure-resource-lookup se compara à busca de recursos no Azure Portal?

O Azure Portal oferece busca e filtros interativos. Já azure-resource-lookup fornece:

• Consultas scriptáveis e repetíveis em várias subscriptions.
• Saída estruturada que agentes e workflows podem consumir automaticamente.
• Entrada em linguagem natural, sem necessidade de escrever KQL manualmente para cada pergunta.

Ela é especialmente útil quando você quer inventário e descoberta consistentes e automatizados, e não buscas manuais pontuais.

Onde posso ver mais exemplos de consultas?

No diretório azure-resource-lookup dentro do repositório microsoft/azure-skills, abra:

• SKILL.md para comportamento geral e notas de uso.
• references/azure-resource-graph.md para padrões concretos de consulta Azure Resource Graph e dicas de KQL.

Use esses exemplos como referência para entender e expandir os tipos de perguntas que você faz por meio da skill.

Quando devo escolher outra skill em vez desta?

Considere outra skill, ou uma skill adicional, quando você precisar:

• Alterar infraestrutura (criar, atualizar, excluir ou escalar recursos).
• Gerenciar workloads dentro dos recursos (por exemplo, deployments de aplicação, schemas de banco de dados ou objetos Kubernetes).
• Realizar análise detalhada de custo, desempenho ou segurança além de relatórios baseados em metadados.

Nesses casos, use azure-resource-lookup para descoberta e inventário, e depois entregue para ferramentas especializadas de deployment, monitoramento ou segurança para as próximas etapas.