32 Commits
Author SHA1 Message Date
Amos HerschandCopilot App 1d7df774b7 docs: make ToolDescriptionEvaluator optional for Fabric MCP tools (#3864)
* docs: make Fabric tool description evaluation optional

Keep Azure and other non-Fabric evaluation gates, including stricter toolset requirements, and all other validation unchanged.

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

* docs: use absolute links for Fabric evaluation policy

Fix the three AGENTS.md policy links rejected by repository link-format guidance. Policy scope is unchanged.

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

* docs: minimize Fabric evaluator exception wording

Keep only short Fabric qualifiers in existing guidance, preserving the original requirements and examples. Remove the expanded policy section and links as requested.

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

---------

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-10-07 09:41:25 +03:00
Chidozie Ononiwu c9184dbed4 Ensure that Run tests (http) is actually testing http (#3340)
* Ensure that Run tests (http) is actually testing http

* Update ClientToolTests to support both http and stdio

* Update readiness cancelation

* Update AzureMigrateCommandTests

* Update KeyVaultCommandTests and StorageCommandTests

* Add shared recorded test validation for local-only tools

* Use CancellationTokenSource.CreateLinkedTokenSource
2026-09-01 09:28:05 -07:00
Alan Zimmer d2ec4f3d47 Fix two LROs using incorrect waiting pattern and update guidance to be explicit (#3424)
* Fix two LROs using incorrect waiting pattern

* Update guidance with LRO pattern

* Update guidance with LRO pattern
2026-08-28 14:07:42 -04:00
Alan Zimmer 05315f2579 Update guidance to stop recommending RetryPolicyOption in tools (#3403)
* Update guidance to stop recommending RetryPolicyOption in tools

* Few fixes in code references
2026-08-27 15:26:32 -04:00
Connie Yau 57ccd2eecf Add support for vally (#3163)
* Ignore any vally-results

* Initial Commit.

* - Add .vscode gitignore
- Update agentic-workflow components
- Add initial template for pr-vally-eval
- Fix namespace in PromptDataStore
- Update launchSettings in VallyEvaluator

* Update AGENTS.md to understand vally testing.

* Add documentation

* Add instructions to CONTRIBUTING.md

* Add documentation for testing.

* Add "interaction" column to clarify if prompt is enough.

* Put extensions into their own folder.

* Update the instructions to be clearer.

* Update foundry descriptions to be more prescriptive in their offerings.

* Fix linting errors.

* Pin vally-cli to current version

* Update YamlSerializer to exclude default values.

* Update to use new test framework

* Add context-required for ones requireing files.

* Add words to spellcheck dictionary.

* Remove angle-bracket replacement logic

* Add description

* Add more spelling.

* Update e2e prompts that are ambiguous

* Fix Microsoft sln

* Update cspell words for vally.
2026-08-12 02:31:32 -07:00
Chidozie Ononiwu 277c126e7c Cleanup cspell (#3263)
* Centralize cspell dictionary in cspell.json

* Update directory cspell configs to import the centralized cspell.json

* Update cspell in docs
2026-08-11 18:00:58 -07:00
Alan Zimmer befd97450d Update AGENTS.md to reference .NET SDK major version only (#3261) 2026-08-11 17:03:38 -04:00
Chidozie Ononiwu c2fe91aae6 Switch CSpell to distributed form (#2958)
* Switch CSpell to distributed form

* Add missing cspell.yaml

* Update cspellinformatio in docs

* Update tools/Fabric.Mcp.Tools.Docs/cspell.yaml

* Remove spell checking from devOps

* Fix cspell issues

* revert changes in eng/common

* Remove root cspell.json
2026-08-10 14:14:49 -07:00
Alan Zimmer 4828227fcf Merge Azure resource services into a single service and rework structure (#3230)
* Merge tenant, subscription, and resource group into a single service

* Fix linting
2026-08-10 10:32:58 -04:00
a74a5fb426 Add onboarding Copilot agent for new contributors (#2523)
* Add onboarding Copilot agent for new contributors

Create a custom GitHub Copilot agent at .github/copilot/agents/onboarding.md
that guides new contributors through environment setup, codebase understanding,
and their first contribution. Content sourced from CONTRIBUTING.md.

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

* Update .github/copilot/agents/onboarding.md

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

* Update .github/copilot/agents/onboarding.md

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

* Update .github/copilot/agents/onboarding.md

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

* update agent

* Refine onboarding agent: consolidate to .github/agents/, update for new skill

- Remove .github/copilot/agents/onboarding.md (not discoverable by GitHub)
- Update .github/agents/onboarding.agent.md with consolidated content
- Replace new-command.md references with /skills add-azure-mcp-tools
- Reference AGENTS.md for coding standards instead of duplicating
- Fix Build-Local.ps1 invalid -UsePaths flag
- Fix consolidated-tools.json path
- Update to two-generic pattern ([Option] attributes, SubscriptionCommandUnitTestsBase)
- Remove internal-only links (aka.ms/azmcp/intake, private project board)
- Add eng/scripts/Update-Solutions.ps1 -All guidance
- Use New-TestResources.ps1 for live test deployment

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

* Consolidate onboarding content from PR #2918

- Update onboarding.agent.md with external MCP server integration, NuGet feed, server modes, and namespace creation guidance
- Add docs/Onboarding.md as human-readable onboarding guide with correct patterns
- Add onboarding callout tip to CONTRIBUTING.md
- Fix typos in CONTRIBUTING.md (Substitue -> Substitute, whem -> when)
- Add cspell words: configfile, remotemcp, slnx, uniqueprefix

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

* Remove docs/Onboarding.md - handled by PR #2918

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

* Slim down onboarding.agent.md to agent-focused instructions

Remove duplicate detailed content (prerequisites, full workflows, server modes)
that belongs in docs/Onboarding.md (PR #2918). Keep only:
- Agent behavioral instructions (approach, tone, delegation)
- Key reference file table for the agent to read
- Essential facts and pitfalls to convey
- Quick commands lookup

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

* Update onboarding callout with agent usage steps

Replace docs/Onboarding.md link with concrete steps on how to
invoke the @onboarding agent in Copilot Chat.

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

* Update AGENTS.md to use two-generic option pattern

Replace old one-generic RegisterOptions/BindOptions/OptionDefinitions guidance
with the new two-generic pattern using [Option] attributes on flat POCOs,
per docs/option-conversion.md.

Key changes:
- Do/Don't sections updated for [Option] attributes and ISubscriptionOption
- Option Handling Pattern section rewritten with two-generic example
- Replace new-command.md references with skill and option-conversion.md refs
- Replace Deploy-TestResources.ps1 with New-TestResources.ps1
- Remove -UsePaths from Build-Local.ps1 commands
- Update test base class guidance (SubscriptionCommandUnitTestsBase)
- Fix logging example to not log full options object
- Update Required Files to remove OptionDefinitions.cs

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

* Restore comprehensive content to onboarding.agent.md

Since docs/Onboarding.md is being removed, the agent file needs to
contain all the important onboarding info directly: prerequisites,
project structure, workflows, testing, external server integration,
coding standards, quality checklist, and common pitfalls.

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

* Add VS Code debugging setup instructions to onboarding agent

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

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-07-02 09:34:08 -07:00
Anannya Patra 4f0db29302 Replace new-command.md with skills (#2709) 2026-06-22 13:11:35 -07:00
7e7b65c7e5 Add git worktree safety guidance to AGENTS.md (#2829)
* Add git worktree safety guidance against git stash in AGENTS.md

Warn against using git stash in linked worktrees that share a common
.git directory, since stash entries live in the shared refs/stash and
collide across concurrent worktrees, risking clobbered edits.

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

* Clarify git worktree add arguments in AGENTS guidance

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
2026-06-08 10:57:20 -07:00
Alan Zimmer c2c34e9d47 Design how merging LiveTests and UnitTests projects into a single Tests project works (#2612)
* Begin investigation

* Merge Azure MCP Core Live and Unit tests

* Migrate test recordings and add attribute for live-only tests

* Fix checks in scripts

* Two small changes

* Merge in main and few review fixes

* Update to use --filter in Test-Code

* Add missing '+'
2026-05-13 16:12:30 -04:00
Alan Zimmer 1e459d9302 Clean up examples of bad patterns in MD files (#2562)
* Clean up examples of bad patterns in MD files

* PR feedback and more updates
2026-05-04 14:40:00 -04:00
vcolin7andCopilot d65e253a0e Update documentation to require recording live tests (#2451)
* Update documentation to require recording live tests

* Updated docs

* Applied PR feedback

Co-authored-by: Copilot <copilot@github.com>

* Fixed broken link

Co-authored-by: Copilot <copilot@github.com>

* Fixed one more broken link

---------

Co-authored-by: Copilot <copilot@github.com>
2026-04-24 14:55:31 -07:00
Alan Zimmer 84e50230bf Add base class for command unit tests (#2399)
* Add base class for command unit tests

* Fix linting and add a few more examples

* Update design, add convenience methods for common workflows

* PR feedback

* PR feedback
2026-04-17 11:08:59 -04:00
Alan Zimmer 0a1dc3b174 Accept tenant when calling Azure Resource Graph queries (#1945)
* Accept tenant when calling Azure Resource Graph queries

* Fix compilation issue
2026-03-18 10:13:00 -04:00
Connie Yau 21c53ea16e Upgrade .NET SDK to 10.0.201 (#2072)
* Upgrade .NET SDK to 10.0.201

* Add CHANGELOG
2026-03-16 16:23:55 -07:00
Connie Yau 6a635b9ebb Update dependencies. (#1740)
* Update .NET SDK to 10.0.103

* Update Microsoft.Azure.Kusto.Data and Ingest to 14.0.3

* Add correct PR and more description

* Fix section
2026-02-17 14:48:38 -08:00
Alan Zimmer 800f51d0ee Extend ExecuteResourceQueryAsync to return a model type with more information (#1526)
* Extend ExecuteResourceQueryAsync to return a model type with more information

* Fix compilation

* Fix linting

* Add CHANGELOG entry

* Update based on feedback

* Update new tool

* Fix linting
2026-01-27 16:05:24 -05:00
Patrick Hallisey 3fec7fdea6 Update repo to use net10.0 (#1221)
* Update projects to target net10
- Update TargetFramework in directory.build.props to net10.0
- Update framework dependency package versions to the 10.0 series
* reader.EndOfStream isn't safe in async and unnecessary when using ReadLineAsync
* Update npgsql to 10.0.1
2026-01-13 12:42:25 -08:00
Patrick Hallisey 7fc4c1f3f6 Add a solution file per server and update the update script (#1491)
* Add a solution file per server and update the update script
* Add root Microsoft.Mcp solution
2026-01-13 12:38:56 -08:00
vcolin7 bd1ed664ed Conflict-Free Changelog Management System (#1194)
* Added development plan

* Added and updated docs

* Added scripts

* Removed old YAML file

* Added some QoL changes to the scripts

* Added a way to provide a specific version to compile entries into

* Updated dry run code

* Fixed the compile script to not delete entries with different indentation

* Added support for multi-line entries

* Added trimming for multi-line

* Added multi-line support to New-ChangelogEntry.ps1

* Added a script for syncing the main CHANGELOG with that one for VS Code

* Updated the changelog compilation script to remove empty sections

* Added support for any MCP server in this repo

* Moved a couple of docs

* Updated other docs

* Updated new-command.md

* Updated behavior to ask for a CHANGELOG path instead of defaulting to the Azure MCP Server. Added an optional filename parameter in New-ChangelogEntry.ps1. Updated schema. Updated documentation.

* Updated Compile-Changelog.ps1 to accept files any name and using either the .yml or .yaml extension

* Applied GitHub Copilot feedback for PowerShell scripts

* Applied PR feedback to PS scripts

* Added sample file

* Refactored indentation and trimming logic

* Refactored a couple of scripts to use logic found in `eng/common/scripts/ChangeLog-Operations.ps1`

* Updated test file and added examples for other servers

* Added logic for extracting PR number from the commit that added an entry file
2025-12-11 17:37:52 -08:00
Connie Yau 239b3d8e02 Fix invalid paths for ToolDescriptionEvaluator after src/ move (#1312)
Fix invalid paths after src/ move
2025-12-04 11:00:14 -08:00
Connie Yau 47934b122a Moving engineering tools into src/tests format. (#1058)
* Move items into src/, scripts/, prompts/

* Adding Tools.sln

* Update paths to include src\

* Update README paths.

* Remove old results.

* Remove tools.json

* Adding solution folder.
2025-12-02 16:09:07 -08:00
Alan Zimmer 39478b911b Stop using writeIndented to reduce token usage (#1226)
* Stop using writeIndented to reduce token usage

* Add CHANGELOG entry

* Move CHANGELOG
2025-11-21 17:14:28 +00:00
Vinay Gera 93a0fce0a1 Update docs for remote mcp server (#1044) 2025-11-07 18:53:49 -08:00
Alan Zimmer e25fa088fb Disable telemetry in non-release builds (#783)
* Basic disabling of telemetry in non-release builds

* More complicated ifdef

* Don't blindly trust Copilot code...

* Replace DebugBuild with ReleaseBuild

* Does native require release build

* Change ifdef check

* Revert accidental changes

* Flow through PublishTarget

* Another try to fix release build

* Fix accidental change

* Reading issue

* Switch ifdef to RELEASE
2025-10-15 15:11:13 -04:00
Arthur Ma 0a1b7d9b27 Update the instructions for ARM operations (#764) 2025-10-13 11:21:53 +08:00
JasonYeMSFT efbe403e9e Add useful Azure MCP docs to sln (#682)
* add Azure MCP docs to csproj and rerun update-solution script

* Add recreated solution file

* Move Azure MCP exclusive docs to Azure.Mcp.Server project

* Update path references to Azure MCP doc files

* Update default path in ToolDescriptionEvaluator code and more doc references

* Update tools.json and evaluation results from latest code

* Fix broken links referencing the old files
2025-10-07 11:13:06 -07:00
Connie YauandCopilot 7fd81a3564 Updates instructions for Docker (#626)
* Fix Docker build instructions. Make ServerName mandatory.

* Update README and TROUBLESHOOTING.

* Move to single line.

* Update servers/Azure.Mcp.Server/TROUBLESHOOTING.md

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

* Add preamble and link to TROUBLESHOOTING

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-09-30 08:35:38 -07:00
Jon Gallant 4351197bf8 Add AGENTS.md (#536)
* Add comprehensive AGENTS.md documentation for project overview, setup, and development workflow

* Fix formatting inconsistencies in AGENTS.md documentation

* Enhance AGENTS.md with detailed guidelines for coding practices, command usage, project structure, and development environment setup

* Refine AGENTS.md guidelines by removing specific references to Newtonsoft.Json, clarifying command submission practices, and updating examples for consistency in command naming and testing.
2025-09-23 10:20:38 -07:00