Skip to content

feature: Feature/azure compute/enablemachinemanagement - #2069

Merged
rakal-dyh merged 18 commits into
microsoft:mainfrom
rakal-dyh:feature/azure-compute/enablemachinemanagement
May 5, 2026
Merged

feature: Feature/azure compute/enablemachinemanagement#2069
rakal-dyh merged 18 commits into
microsoft:mainfrom
rakal-dyh:feature/azure-compute/enablemachinemanagement

Conversation

@rakal-dyh

@rakal-dyh rakal-dyh commented Apr 27, 2026

Copy link
Copy Markdown
Collaborator

Description

Checklist

  • [Y] Tests pass locally (cd tests && npm test)
  • [Y] If modifying skill descriptions: verified routing correctness with integration tests (npm run test:skills:integration -- <skill>)
  • [Y] If modifying skill USE FOR / DO NOT USE FOR / PREFER OVER clauses: confirmed no routing regressions for competing skills
  • [Y] Version bumped in skill frontmatter (if skill files changed)

Related Issues

Yinghui Dong and others added 3 commits April 21, 2026 13:57
- Add 'Should Trigger - Essential Machine Management' section with 7 EMM prompts
- Add 'Essential Machine Management Workflow' unit tests (sections, routing, API, errors)
- Add 'EMM Reference Files' unit tests (all 4 refs exist, content assertions)
- Update router test to verify EMM description keywords and routing
- Add 2 EMM integration test cases (enable flow, enrollment status)
- Update snapshot with new EMM keywords

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@rakal-dyh

Copy link
Copy Markdown
Collaborator Author

verify the integration test now

@tmeschter

Copy link
Copy Markdown
Member

Update the PR title to start with "feature:" to have this automatically included in the CHANGELOG.md.

@rakal-dyh rakal-dyh changed the title Feature/azure compute/enablemachinemanagement feature: Feature/azure compute/enablemachinemanagement Apr 27, 2026

@jongio Jon Gallant (jongio) left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two things to address in this EMM sub-workflow addition:

1. Contradictory "Portal-only" statement (emm-overview.md, Key Characteristics section)

The overview states:

Portal-only during preview: No CLI/API-only enrollment flow is officially supported yet

But emm-enable-flow.md documents a complete 8-step Copilot-guided flow using REST API calls (PUT to Microsoft.ManagedOps/managedOps/default). If the agent reads the overview first, it'll tell users EMM is portal-only and skip the API flow - which is the whole point of this skill.

Suggestion: rephrase to clarify that the REST API exists and the Copilot-guided flow uses it, even if Microsoft's official docs focus on the portal experience.

2. Offboard instructions split with different approaches

essential-machine-management.md says offboard via portal UI (navigate, select, click Offboard). emm-enable-flow.md documents a DELETE API call for the same action. The parent workflow's routing doesn't point to the API-based offboard path. Consider consolidating - either add the API path to the parent routing tree, or remove the duplicate from the enable-flow reference.

Yinghui Dong and others added 3 commits April 27, 2026 17:07
…lability

The 'portal-only' statement contradicted emm-enable-flow.md which documents
a full Copilot-guided REST API enrollment flow via Microsoft.ManagedOps.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove 'Via Portal' sub-section from Browse (keep Copilot-guided API approach)
- Point Offboard to emm-enable-flow.md#disable-emm-offboard instead of portal steps
- Keep portal routing entry for users who explicitly mention portal

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Update all references in SKILL.md, essential-machine-management.md, and unit tests.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The #disable-emm-offboard anchor doesn't work when the agent reads files.
Reference the file directly and mention the section name in text.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

@jongio Jon Gallant (jongio) left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addresses my previous feedback - the "portal-only" contradiction is fixed and offboard instructions are consolidated. Clean changes.

Two new issues in the latest commits:

  1. integration.test.ts: The describe block was renamed from "skill-invocation" to "11skill-invocation11". This looks like accidental debug characters left in. It'll affect test output/filtering.

  2. .playwright-mcp/page-2026-04-20T21-13-59-247Z.yml was committed - looks like an accidental Playwright MCP artifact. Should be removed and probably added to .gitignore.

Comment thread tests/azure-compute/integration.test.ts Outdated
@jongio

Copy link
Copy Markdown
Collaborator

.playwright-mcp/page-2026-04-20T21-13-59-247Z.yml was committed - looks like an accidental Playwright MCP artifact. Should be removed and .playwright-mcp/ added to .gitignore.

@rakal-dyh

Copy link
Copy Markdown
Collaborator Author

adress the latest comment, remove the mistakenly committed file

@jongio Jon Gallant (jongio) left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addresses my previous feedback. Both items fixed:

  • "11skill-invocation11" reverted to "skill-invocation"
  • .playwright-mcp/ artifact removed

No new issues found in the incremental diff. All CI green.

Copilot AI review requested due to automatic review settings April 30, 2026 05:08

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Essential Machine Management (EMM) coverage to the azure-compute skill by introducing a new EMM workflow + reference docs and extending unit/trigger/integration tests to validate routing and keyword matching.

Changes:

  • Added an EMM workflow (essential-machine-management.md) with routing, browse/offboard guidance, and error handling.
  • Added EMM reference docs (overview, prerequisites, enable flow, portal enable flow).
  • Updated azure-compute skill metadata/routing and extended tests + snapshots to cover EMM prompts and routing.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
tests/azure-compute/unit.test.ts Adds unit assertions for EMM description keywords, routing link presence, and validates new workflow/reference file content.
tests/azure-compute/triggers.test.ts Adds trigger prompts ensuring EMM queries trigger the azure-compute skill.
tests/azure-compute/integration.test.ts Adds integration prompts to verify EMM queries route to the new workflow at/above the invocation threshold.
tests/azure-compute/snapshots/triggers.test.ts.snap Updates snapshot to include EMM in description and extracted keywords.
plugin/skills/azure-compute/workflows/essential-machine-management/essential-machine-management.md New workflow router for EMM intents (enable/portal/overview/prereqs/browse/offboard/troubleshoot).
plugin/skills/azure-compute/workflows/essential-machine-management/references/emm-enable-flow.md New Copilot-guided enablement flow and API/CLI guidance for enrolling/offboarding EMM.
plugin/skills/azure-compute/workflows/essential-machine-management/references/emm-enable-flow-portal-guidance.md New portal-specific enablement walkthrough for users explicitly requesting portal steps.
plugin/skills/azure-compute/workflows/essential-machine-management/references/emm-overview.md New EMM feature/tier/pricing overview reference.
plugin/skills/azure-compute/workflows/essential-machine-management/references/emm-prerequisites.md New prerequisites (resources, roles, RPs) reference.
plugin/skills/azure-compute/SKILL.md Extends skill description + routing to include EMM and link to the new workflow and references.

@jongio Jon Gallant (jongio) left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Latest commits address the Copilot bot findings:

  • MCP tool names fixed to mcp_azure_mcp_subscription_list (both router and enable-flow)
  • azure-monitor MCP tool refs replaced with explicit CLI commands for Log Analytics and Azure Monitor workspaces
  • Role check tip and 403 error handling now consistent - both correctly explain that assignedTo is self-scoped but requires at least one role on the subscription

All prior review items resolved. CI green. No new issues.

@rakal-dyh
rakal-dyh merged commit 7612caa into microsoft:main May 5, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants