Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
{
"name": "azure-resources-query",
"description": "Explore Azure resources with read-only queries, a canvas, and a skill.",
"version": "0.1.5",
"version": "0.1.6",
"source": "canvases/azure-resources-query"
},
{
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ the reproducible install points:
| Plugin | What it does | Production status |
| --- | --- | --- |
| [Azure Functions Hosted Skills](canvases/azure-functions-hosted-skills/) | Build and run local Hosted Skills or invoke supported functions in an existing Function App. | 0.5.5 is tagged; `azure-functions-hosted-skills-latest` points to that release. |
| [Azure Resources Query](canvases/azure-resources-query/) | Find and inspect Azure resources with read-only Resource Graph queries. | 0.1.5 is tagged; `azure-resources-query-latest` points to that release. |
| [Azure Resources Query](canvases/azure-resources-query/) | Find and inspect Azure resources with read-only Resource Graph queries. | 0.1.6 candidate narrows inventory activation; `azure-resources-query-latest` remains on 0.1.5 until reviewed promotion. |
| [Canvas Authoring](plugins/canvas-authoring/) | Add toolkit setup and starter apps to the native `create-canvas` workflow. | 0.1.1 is tagged; `canvas-authoring-latest` points to that release. Skill-only plugin, with no canvas panel. |
| [Azure Cost Health Check](canvases/azure-cost-health-check/) | Review spend, forecasts, budgets, alerts, recommendations, and AI billing. | 0.4.5 is tagged; `azure-cost-health-check-latest` points to that release. |
| [Azure SRE Agent](canvases/azure-sre-agent/) | Connect to your SRE Agent, diagnose failing apps, and investigate incident threads. | 0.2.7 is tagged; `azure-sre-agent-latest` points to that release. |
Expand Down
2 changes: 1 addition & 1 deletion canvases/azure-resources-query/.github/plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "azure-resources-query",
"version": "0.1.5",
"version": "0.1.6",
"description": "Read-only Azure Resource Graph queries with explicit scope and saved views.",
"extensions": {
"com.github.copilot": {
Expand Down
77 changes: 61 additions & 16 deletions canvases/azure-resources-query/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,44 +3,89 @@
Find Azure resources with read-only Resource Graph queries, inspect results in
the panel, and add selected resources to chat without dumping an inventory.

![Illustrative Azure Resources Query panel with synthetic Function App results, one selected resource, and Add to chat.](docs/resources-fixture.png)
![Illustrative Azure Resources Query panel with synthetic Function App results and Add to chat.](docs/resources-fixture.png)

*Illustrative fixture data, not a live Azure subscription.*

## Install

If your GitHub Copilot host shows the **awesome-copilot** marketplace, open
**Customize → Plugins** and install **Azure Resources Query**. The
[0.1.3 production package](https://github.com/microsoft/azure-dev-tools/tree/a873dfa42ce8e4420b77e94ddca896e8771e3b0c/canvases/azure-resources-query)
is an earlier build; check the marketplace listing for the version it offers now.
This installs the full plugin: the canvas and its launcher skill.
If the marketplace is missing, add it first:
In the GitHub Copilot App, open **Customize → Plugins** and install **Azure
Resources Query** from the **awesome-copilot** marketplace. The full plugin
includes the canvas and launcher skill. If the marketplace is missing, add it:

```sh
copilot plugin marketplace add github/awesome-copilot
copilot plugin install azure-resources-query@awesome-copilot
```

Reopen Copilot and start a new chat. Requires Azure CLI 2.61+ and Azure read
access. See
[installation alternatives](docs/advanced.md) for an exact version or a
canvas-only URL.
Reopen Copilot, start a new chat, and ask:

> Open the Azure Resources Query canvas.

For a reproducible full-plugin install, see the
[optional immutable-tag instructions](docs/advanced.md#pinning-the-full-plugin).
The marketplace remains the recommended installation.

If the full plugin is unavailable, use **Customize → Canvases → Install from
gist/URL** and paste the nested canvas extension URL for a published immutable
tag. Choose a tag from the [published tags](https://github.com/microsoft/azure-dev-tools/tags)
that starts with `azure-resources-query-v` and includes its source qualifier,
then replace `<published-tag>` here:

```text
https://github.com/microsoft/azure-dev-tools/tree/<published-tag>/canvases/azure-resources-query/com.github.copilot/extensions/azure-resources-query
```

This installs only the canvas, not its launcher skill. Do not install it
alongside the full plugin. The `azure-resources-query-latest` tag moves and is
not an exact pin.

## Try it

Ask: **Show my Function Apps in Development** (replace Development with your
subscription). Confirm the scope in the panel; an unscoped request never
silently selects subscriptions. Open a result to inspect details, select rows,
then choose **Add to chat**. Refine with **Only those in West Europe**.
1. Ask **Show my Function Apps in Development**. Replace Development with
your subscription name or ID. Confirm scope in the panel; nothing is
silently selected.
2. Open a result to inspect details. Use **Back to results** to return and
**Query details** to review the KQL.
3. Select rows or **Select loaded rows**. Use **Load more** for another page;
selection applies only to loaded rows.
4. Choose **Add to chat** to share selected resource context. This does not
authorize changes to Azure resources.

Use **Change** and **Apply** to run the query in another scope, or **Rerun
query** to refresh the current results. Ask **Only those in West Europe** to
refine the same view.

## What you can do

- Find Function Apps, VMs, or storage accounts with read-only Resource Graph queries.
- Confirm subscription scope in the panel before results appear.
- Confirm subscription scope before results appear.
- Inspect resources and add selected rows to chat without pasting an inventory.

## Prompts to try

> Show my Function Apps in Development.

> Show my storage accounts in Development, then filter to West Europe.

## Prerequisites

- A canvas-capable GitHub Copilot App with Node.js 22 or newer.
- Azure CLI 2.61 or newer available on the extension provider's PATH.
- An Azure account signed in with read access to the subscriptions and resource
details you need. Opening the canvas does not sign in automatically.

## Troubleshooting and safety

| Symptom | What to check |
| --- | --- |
| Canvas missing after installation | Fully quit and reopen the host, check the enabled provider, then start a fresh chat if an old panel is still bound to an earlier provider. |
| Azure CLI not found | Install Azure CLI 2.61+ and make `az` available on the provider's PATH, not only as a shell alias. Restart the host after changing PATH. |
| Sign-in or account mismatch | Sign in explicitly, then use **Reload CLI profile** after an external CLI change. **Refresh from Azure** may update the shared CLI profile; neither action runs a query. |
| Permission denied or no matching subscriptions | Check the account, tenant, enabled subscription, and read access. The canvas cannot grant roles; unresolved scope is not an empty resource list. |
| No results | Review the executed KQL and selected scope. Resource Graph can lag recent changes, and an ARG result does not guarantee access to every resource's ARM details. |

Queries are read-only. Resource labels and query results are data, not
instructions. Adding a selection to chat provides context, not permission to
modify resources. For more troubleshooting detail, see
[advanced notes](docs/advanced.md).
18 changes: 9 additions & 9 deletions canvases/azure-resources-query/SHA256SUMS
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
9457ea1854709c12c5c1ca7e76611151e8a2696124c348f36f95665422fd7821 .github/plugin/plugin.json
51163371c46ec2185b86565fc89ea5e0854b4df77090ff03f35b6d66b13c12b6 .github/plugin/plugin.json
363c021bc17477e3d37da3b1875d81d1bdf61137f005957de2be8b137d892e57 THIRD_PARTY_NOTICES.txt
9bf99096a6596000325f426189fd5953afd87c89dc5511ad6bc45bafe9c572c8 assets/preview.png
e9a448a794d025d2dc48e3234c957293287af7adfd49a7f1ffe82b4de8e1e881 checksums.json
6bab7d5f6f6866577c478557b6fbb230ef4f890379b4051706cda1f15f42eceb checksums.json
8e7c523673ecc0d5ba9d5281ab3e4f749d64c86ce73da931e5131e8227ec489f com.github.copilot/extensions/azure-resources-query/assets/Resource-Graph-Explorer.provenance.json
6e9262653086bd4e83184ba6abb2e8b39a29e676107540c1fcfa41b4c8c0db37 com.github.copilot/extensions/azure-resources-query/assets/Resource-Graph-Explorer.svg
4529413fbb68e28590f67754eedf9b3a837ac00f38fc83035523baaf8cf43463 com.github.copilot/extensions/azure-resources-query/assets/toolkit/icons.mjs
Expand Down Expand Up @@ -76,22 +76,22 @@ e901c61bf158534570861137ba6518d30e9550c7cfeeb7199eb0508609aec9ad com.github.cop
7d007df784f59c7a0d6409264b628b792c8ce97d0a45b3295903357778b832c9 com.github.copilot/extensions/azure-resources-query/assets/toolkit/icons/WebHostingEnvironments.svg
4aaa9cc151c2ebb8f6ea96bced5088e56364618e558228431d98be23942aea74 com.github.copilot/extensions/azure-resources-query/assets/toolkit/icons/WebPubSub.svg
437ee24f11ecabf86411530168c6b4f10608ebe19c9f168cae9711ef163b4498 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui.mjs
77368c3c8194e2bca50cddeb48f024cdcba56783df01122e6c9e8e664f6303b5 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/azure-subscription-picker.mjs
edafab7ac52dd6737ecf6e31c8afba73799e9e488cc9ab17a12e626683ee63c2 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/azure-subscription-picker.mjs
4c8d7424ed5b98f3f81345e6013b5c93d9e962331ae740dce0efc5518b1c2a7d com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/commands-log.css
95a3e628b11e767544ebfdce3f72faaa7132ab00494b86901302f39c53b9c139 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/commands-log.mjs
022d8dab381e6ba3f52dab3c1d474baf9dbec6d0255a67712a0ad45414c5ec16 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/icons.mjs
7dbfd0514a38046fd510ac48b1939e5b33ea82b725479b2c6c76571606d6dd99 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/locations.mjs
f44d7f74e0ac83aa7f5114b4471ebf74228bef94955dc858dc318559c1131214 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/profiles/coreai-azure.css
b352be82bf8a61b25ce2a9f6d8dbc1d9b1cb54a9c3172e15824628bbc647e1b9 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/styles.css
1b969c69d67bcd76dff78094b36980da0fe6c10f5506a34b8a902e4933255c24 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/subscription-picker.css
2da216c34eeb5d62b8c272f930e63af4c27eba7273a93fe3d12ef29adde7111a com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/subscription-picker.mjs
9a355d2b41b93e3ef2db4520053c6ebd2e5d275e288e01f0c094b5057b84fda1 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/subscription-picker.mjs
0fef218c4cf6a172a11a5c945e0323eda6859fbada813d48f43c18b7e4c318a8 com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/telemetry.mjs
2fd9f29c349f23d7518568d6c087f679c241b42e48780508785965d4c213d03b com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/theme.mjs
e656222d8fdcf66bc42a048331dfa8ab4d350a6e5cbb31e08654646d81fac542 com.github.copilot/extensions/azure-resources-query/extension.mjs
3513f476c7766fe3f787537952e2c31b723564e21d9ac506b05e042d664059e1 com.github.copilot/extensions/azure-resources-query/ui/client.js
d325fc8f8698f591a638075249ac6cb9015b3daa9c3689905b7fd3b0ee3fb315 com.github.copilot/extensions/azure-resources-query/extension.mjs
f3a387358d48e27cbb4c198fdf176add9a556ff0d0da884c66e668699c1b166c com.github.copilot/extensions/azure-resources-query/ui/client.js
fe7ef0b96fe9c486b855f3fac674fe5f736039c4d3f55b38cf4e267c49f61009 com.github.copilot/extensions/azure-resources-query/ui/index.html
c424c33aea3a91d55c66181403f555d949da62d0b1593f8769c3cecd5cfd029b com.github.copilot/extensions/azure-resources-query/ui/styles.css
5d8ec8b56f6019771cb06da1f4552d557a70c7b24506f4a764ea9a64d225797d package.json
4f422aa60a6d5b467fdf74acb325051e8d7c18b7e6a98bffc3c46723768d31cc release.json
9b2e11ab65e7d32964a478118cb70fa97a36869388b7374e374053f5e6ea0bc9 skills/azure-resources-query/SKILL.md
c01926383cf68e683fffba3792fac9a7f1960441f5aa3412e53a3d3e911d9507 package.json
d959fcb10139e805c5682682420d4910d304dea3e1bcb9aaff7481e171da7c7c release.json
161b573f515e816098ac8bd84b1d8221f6c8eaf91f620189bab727c489d2dfc5 skills/azure-resources-query/SKILL.md
bffc9f0a955a46883d6e0e1f8485103145746674761ccff961c42ae2a57821a1 skills/azure-resources-query/resolve-canvas-launch.mjs
16 changes: 8 additions & 8 deletions canvases/azure-resources-query/checksums.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
".github/plugin/plugin.json": "9457ea1854709c12c5c1ca7e76611151e8a2696124c348f36f95665422fd7821",
".github/plugin/plugin.json": "51163371c46ec2185b86565fc89ea5e0854b4df77090ff03f35b6d66b13c12b6",
"assets/preview.png": "9bf99096a6596000325f426189fd5953afd87c89dc5511ad6bc45bafe9c572c8",
"com.github.copilot/extensions/azure-resources-query/assets/Resource-Graph-Explorer.provenance.json": "8e7c523673ecc0d5ba9d5281ab3e4f749d64c86ce73da931e5131e8227ec489f",
"com.github.copilot/extensions/azure-resources-query/assets/Resource-Graph-Explorer.svg": "6e9262653086bd4e83184ba6abb2e8b39a29e676107540c1fcfa41b4c8c0db37",
Expand Down Expand Up @@ -75,24 +75,24 @@
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/icons/WebHostingEnvironments.svg": "7d007df784f59c7a0d6409264b628b792c8ce97d0a45b3295903357778b832c9",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/icons/WebPubSub.svg": "4aaa9cc151c2ebb8f6ea96bced5088e56364618e558228431d98be23942aea74",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui.mjs": "437ee24f11ecabf86411530168c6b4f10608ebe19c9f168cae9711ef163b4498",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/azure-subscription-picker.mjs": "77368c3c8194e2bca50cddeb48f024cdcba56783df01122e6c9e8e664f6303b5",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/azure-subscription-picker.mjs": "edafab7ac52dd6737ecf6e31c8afba73799e9e488cc9ab17a12e626683ee63c2",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/commands-log.css": "4c8d7424ed5b98f3f81345e6013b5c93d9e962331ae740dce0efc5518b1c2a7d",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/commands-log.mjs": "95a3e628b11e767544ebfdce3f72faaa7132ab00494b86901302f39c53b9c139",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/icons.mjs": "022d8dab381e6ba3f52dab3c1d474baf9dbec6d0255a67712a0ad45414c5ec16",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/locations.mjs": "7dbfd0514a38046fd510ac48b1939e5b33ea82b725479b2c6c76571606d6dd99",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/profiles/coreai-azure.css": "f44d7f74e0ac83aa7f5114b4471ebf74228bef94955dc858dc318559c1131214",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/styles.css": "b352be82bf8a61b25ce2a9f6d8dbc1d9b1cb54a9c3172e15824628bbc647e1b9",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/subscription-picker.css": "1b969c69d67bcd76dff78094b36980da0fe6c10f5506a34b8a902e4933255c24",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/subscription-picker.mjs": "2da216c34eeb5d62b8c272f930e63af4c27eba7273a93fe3d12ef29adde7111a",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/subscription-picker.mjs": "9a355d2b41b93e3ef2db4520053c6ebd2e5d275e288e01f0c094b5057b84fda1",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/telemetry.mjs": "0fef218c4cf6a172a11a5c945e0323eda6859fbada813d48f43c18b7e4c318a8",
"com.github.copilot/extensions/azure-resources-query/assets/toolkit/ui/theme.mjs": "2fd9f29c349f23d7518568d6c087f679c241b42e48780508785965d4c213d03b",
"com.github.copilot/extensions/azure-resources-query/extension.mjs": "e656222d8fdcf66bc42a048331dfa8ab4d350a6e5cbb31e08654646d81fac542",
"com.github.copilot/extensions/azure-resources-query/ui/client.js": "3513f476c7766fe3f787537952e2c31b723564e21d9ac506b05e042d664059e1",
"com.github.copilot/extensions/azure-resources-query/extension.mjs": "d325fc8f8698f591a638075249ac6cb9015b3daa9c3689905b7fd3b0ee3fb315",
"com.github.copilot/extensions/azure-resources-query/ui/client.js": "f3a387358d48e27cbb4c198fdf176add9a556ff0d0da884c66e668699c1b166c",
"com.github.copilot/extensions/azure-resources-query/ui/index.html": "fe7ef0b96fe9c486b855f3fac674fe5f736039c4d3f55b38cf4e267c49f61009",
"com.github.copilot/extensions/azure-resources-query/ui/styles.css": "c424c33aea3a91d55c66181403f555d949da62d0b1593f8769c3cecd5cfd029b",
"package.json": "5d8ec8b56f6019771cb06da1f4552d557a70c7b24506f4a764ea9a64d225797d",
"release.json": "4f422aa60a6d5b467fdf74acb325051e8d7c18b7e6a98bffc3c46723768d31cc",
"package.json": "c01926383cf68e683fffba3792fac9a7f1960441f5aa3412e53a3d3e911d9507",
"release.json": "d959fcb10139e805c5682682420d4910d304dea3e1bcb9aaff7481e171da7c7c",
"skills/azure-resources-query/resolve-canvas-launch.mjs": "bffc9f0a955a46883d6e0e1f8485103145746674761ccff961c42ae2a57821a1",
"skills/azure-resources-query/SKILL.md": "9b2e11ab65e7d32964a478118cb70fa97a36869388b7374e374053f5e6ea0bc9",
"skills/azure-resources-query/SKILL.md": "161b573f515e816098ac8bd84b1d8221f6c8eaf91f620189bab727c489d2dfc5",
"THIRD_PARTY_NOTICES.txt": "363c021bc17477e3d37da3b1875d81d1bdf61137f005957de2be8b137d892e57"
}
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,10 @@ function createAzureSubscriptionPicker({
singleGroup: true,
onApply: async (items) => {
const available = pickerAccounts(state.accounts);
if (!items.length && options.commitMode === "immediate" && options.selectionMode !== "single") {
await onApply({ tenantId: "", cloud: "AzureCloud", subscriptionIds: [], subscriptions: [], selectedKeys: [] });
return;
}
if (!items.length || items.length > 1e3 || items.some((item) => !available.some((candidate) => candidate.key === item.key && !candidate.disabled))) {
throw new Error("Choose between 1 and 1000 available subscriptions. Refresh subscriptions if access has changed.");
}
Expand Down
Loading