Replace hardcoded Azure Functions runtime versions with dynamic doc-query guidance by Copilot · Pull Request #1060 · microsoft/GitHub-Copilot-for-Azure

Copilot · 2026-02-27T00:48:32Z

Replace hardcoded Runtime Stacks version table with query-official-docs guidance in README.md
Add missing PowerShell row and fix .NET runtime identifier to dotnet-isolated
Replace hardcoded version: '3.11' in Flex Consumption bicep.md with <version> placeholder
Fix MCP tool invocation format: change azure-documentation query: to intent: / learn: true YAML params (matches repo convention)
Fix hardcoded linuxFxVersion: 'Node|18' in legacy Consumption Plan bicep example with <version> placeholder and doc link

Original prompt

This section details on the original issue you should resolve

<issue_title>Skill docs contain hardcoded outdated runtime versions instead of querying official docs</issue_title>
<issue_description>## Summary

The azure-prepare skill contains hardcoded runtime version numbers that become stale over time. This causes agents to recommend outdated versions instead of current GA releases.

Current Problem

In plugin/skills/azure-prepare/references/services/functions/README.md (around line 45-50):
| Runtime Stack | Version |
|--------------|---------|
| Node.js | 18 |
| Python | 3.11 |
| .NET | 8.0 |
| Java | 17 |
Actual current GA versions (per official docs):

Language Hardcoded Current GA Status

Node.js 18 22, 20 ❌ Node 18 not even listed anymore!

Python 3.11 3.13, 3.12, 3.11 ⚠️ Outdated

.NET 8.0 10, 9, 8 ❌ .NET 10 is GA

Java 17 21, 17, 11, 8 ✅ OK (LTS)

PowerShell missing 7.4 ❌ Not listed

Impact

Agents use hardcoded versions from their context instead of querying current docs

Users get deployments with outdated runtimes

Creates technical debt and security exposure

Requires manual updates every time Azure updates supported versions

Suggested Fix

Replace hardcoded version tables with instructions to query official documentation:
> **⚠️ ALWAYS QUERY OFFICIAL DOCUMENTATION FOR VERSIONS**
> 
> Do NOT use hardcoded versions. Query for latest GA versions before generating code:
> 
> **Primary Source:** [Azure Functions Supported Languages](https://learn.microsoft.com/en-us/azure/azure-functions/supported-languages)
> 
> Use the azure-documentation MCP tool to fetch current supported versions:
> \`\`\`
> azure-documentation query: "Azure Functions supported language versions"
> \`\`\`

### Version Selection Priority
1. **Latest GA** - For new projects (best features, longest support window)
2. **LTS** - For enterprise/compliance requirements
3. **User-specified** - When explicitly requested
Files Affected

plugin/skills/azure-prepare/references/services/functions/README.md

Any other skill files with hardcoded version numbers

Template references that specify versions

Related Issues

azure-prepare: MCP recipe not discovered when user asks to create MCP server #997 - MCP recipe not discovered

CRITICAL: azure-prepare deleted user workspace when adding MCP support #998 - Workspace deletion issue

azure-prepare: Function file naming and README/test updates for new functions #1000 - Function naming and README updates

/cc @anthropics</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes Skill docs contain hardcoded outdated runtime versions instead of querying official docs #1005

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Co-authored-by: tmeschter <10506730+tmeschter@users.noreply.github.com>

github-actions · 2026-02-27T17:27:51Z

🔍 Token Analysis Report

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts compare --base origin/main --head HEAD --markdown

📊 Token Change Report

Comparing origin/main → HEAD

Summary

Metric	Value
📈 Total Change	+248 tokens (+9%)
Before	2,756 tokens
After	3,004 tokens
Files Changed	2

Changed Files

File	Before	After	Change
`plugin/skills/azure-prepare/references/services/functions/README.md`	624	820	+196 (+31%)
`plugin/skills/azure-prepare/references/services/functions/bicep.md`	2,132	2,184	+52 (+2%)

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts check --markdown

📊 Token Limit Check Report

Checked: 432 files
Exceeded: 122 files

⚠️ Files Exceeding Token Limits

File	Tokens	Limit	Over By
`.github/skills/file-test-bug/SKILL.md`	613	500	+113
`.github/skills/sensei/README.md`	3530	1000	+2530
`.github/skills/sensei/SKILL.md`	2366	500	+1866
`.github/skills/sensei/references/EXAMPLES.md`	3707	1000	+2707
`.github/skills/sensei/references/LOOP.md`	4181	1000	+3181
`.github/skills/sensei/references/SCORING.md`	3926	1000	+2926
`.github/skills/sensei/references/TOKEN-INTEGRATION.md`	1094	1000	+94
`.github/skills/skill-authoring/SKILL.md`	802	500	+302
`plugin/skills/appinsights-instrumentation/SKILL.md`	950	500	+450
`plugin/skills/azure-ai/SKILL.md`	831	500	+331
`plugin/skills/azure-ai/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-aigateway/SKILL.md`	1290	500	+790
`plugin/skills/azure-aigateway/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-aigateway/references/patterns.md`	1696	1000	+696
`plugin/skills/azure-aigateway/references/policies.md`	2342	1000	+1342
`plugin/skills/azure-aigateway/references/troubleshooting.md`	1971	1000	+971
`plugin/skills/azure-compliance/SKILL.md`	1235	500	+735
`plugin/skills/azure-compliance/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-compliance/references/azqr-recommendations.md`	1447	1000	+447
`plugin/skills/azure-compliance/references/azqr-remediation-patterns.md`	1987	1000	+987
`plugin/skills/azure-compliance/references/azure-keyvault-expiration-audit.md`	1286	1000	+286
`plugin/skills/azure-compliance/references/azure-quick-review.md`	1268	1000	+268
`plugin/skills/azure-compute/SKILL.md`	2616	500	+2116
`plugin/skills/azure-compute/references/retail-prices-api.md`	1609	1000	+609
`plugin/skills/azure-compute/references/vm-families.md`	1234	1000	+234
`plugin/skills/azure-compute/references/vmss-guide.md`	1621	1000	+621
`plugin/skills/azure-cost-optimization/SKILL.md`	3452	500	+2952
`plugin/skills/azure-cost-optimization/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-deploy/SKILL.md`	1090	500	+590
`plugin/skills/azure-deploy/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-deploy/references/pre-deploy-checklist.md`	1195	1000	+195
`plugin/skills/azure-deploy/references/recipes/azd/errors.md`	1212	1000	+212
`plugin/skills/azure-deploy/references/troubleshooting.md`	1527	1000	+527
`plugin/skills/azure-diagnostics/SKILL.md`	1062	500	+562
`plugin/skills/azure-hosted-copilot-sdk/SKILL.md`	655	500	+155
`plugin/skills/azure-hosted-copilot-sdk/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-hosted-copilot-sdk/references/azure-model-config.md`	1151	1000	+151
`plugin/skills/azure-kusto/SKILL.md`	2160	500	+1660
`plugin/skills/azure-messaging/SKILL.md`	852	500	+352
`plugin/skills/azure-messaging/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-messaging/references/service-troubleshooting.md`	1044	1000	+44
`plugin/skills/azure-observability/SKILL.md`	1032	500	+532
`plugin/skills/azure-observability/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-prepare/SKILL.md`	1828	500	+1328
`plugin/skills/azure-prepare/references/apim.md`	1453	1000	+453
`plugin/skills/azure-prepare/references/aspire.md`	2735	1000	+1735
`plugin/skills/azure-prepare/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-prepare/references/azure-context.md`	1019	1000	+19
`plugin/skills/azure-prepare/references/plan-template.md`	1063	1000	+63
`plugin/skills/azure-prepare/references/recipes/azd/aspire.md`	1584	1000	+584
`plugin/skills/azure-prepare/references/recipes/azd/azure-yaml.md`	1803	1000	+803
`plugin/skills/azure-prepare/references/recipes/azd/terraform.md`	2924	1000	+1924
`plugin/skills/azure-prepare/references/research.md`	1784	1000	+784
`plugin/skills/azure-prepare/references/runtimes/nodejs.md`	1508	1000	+508
`plugin/skills/azure-prepare/references/security.md`	2092	1000	+1092
`plugin/skills/azure-prepare/references/services/functions/bicep.md`	2184	1000	+1184
`plugin/skills/azure-prepare/references/services/functions/templates/SPEC-composable-templates.md`	6187	1000	+5187
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/README.md`	1354	1000	+354
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/common/nodejs-entry-point.md`	1034	1000	+34
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/common/uami-bindings.md`	1223	1000	+223
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/composition.md`	4564	1000	+3564
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/cosmosdb/README.md`	1467	1000	+467
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/durable/README.md`	1149	1000	+149
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/eventhubs/README.md`	1403	1000	+403
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/mcp/source/java.md`	1312	1000	+312
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/mcp/source/python.md`	1207	1000	+207
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/mcp/source/typescript.md`	1138	1000	+138
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/servicebus/README.md`	1171	1000	+171
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/servicebus/source/dotnet.md`	1280	1000	+280
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/servicebus/source/java.md`	1016	1000	+16
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/sql/source/java.md`	1009	1000	+9
`plugin/skills/azure-prepare/references/services/functions/templates/recipes/sql/source/python.md`	1080	1000	+80
`plugin/skills/azure-prepare/references/services/functions/terraform.md`	2545	1000	+1545
`plugin/skills/azure-prepare/references/services/service-bus/patterns.md`	1122	1000	+122
`plugin/skills/azure-resource-lookup/SKILL.md`	1373	500	+873
`plugin/skills/azure-resource-lookup/references/azure-resource-graph.md`	1307	1000	+307
`plugin/skills/azure-resource-visualizer/SKILL.md`	2089	500	+1589
`plugin/skills/azure-storage/SKILL.md`	1164	500	+664
`plugin/skills/azure-storage/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/azure-storage/references/sdk-usage.md`	1135	1000	+135
`plugin/skills/azure-validate/SKILL.md`	746	500	+246
`plugin/skills/azure-validate/references/recipes/azd/README.md`	1191	1000	+191
`plugin/skills/entra-app-registration/SKILL.md`	2053	500	+1553
`plugin/skills/entra-app-registration/references/api-permissions.md`	2545	1000	+1545
`plugin/skills/entra-app-registration/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/entra-app-registration/references/cli-commands.md`	2211	1000	+1211
`plugin/skills/entra-app-registration/references/console-app-example.md`	2752	1000	+1752
`plugin/skills/entra-app-registration/references/first-app-registration.md`	1846	1000	+846
`plugin/skills/entra-app-registration/references/oauth-flows.md`	2375	1000	+1375
`plugin/skills/entra-app-registration/references/troubleshooting.md`	1896	1000	+896
`plugin/skills/microsoft-foundry/SKILL.md`	1932	500	+1432
`plugin/skills/microsoft-foundry/foundry-agent/create/create.md`	3016	1000	+2016
`plugin/skills/microsoft-foundry/foundry-agent/create/references/agentframework.md`	1300	1000	+300
`plugin/skills/microsoft-foundry/foundry-agent/create/references/tool-memory.md`	1204	1000	+204
`plugin/skills/microsoft-foundry/foundry-agent/deploy/deploy.md`	4005	1000	+3005
`plugin/skills/microsoft-foundry/foundry-agent/invoke/invoke.md`	1273	1000	+273
`plugin/skills/microsoft-foundry/foundry-agent/trace/references/kql-templates.md`	1913	1000	+913
`plugin/skills/microsoft-foundry/foundry-agent/trace/references/search-traces.md`	1366	1000	+366
`plugin/skills/microsoft-foundry/foundry-agent/trace/trace.md`	1265	1000	+265
`plugin/skills/microsoft-foundry/foundry-agent/troubleshoot/troubleshoot.md`	1299	1000	+299
`plugin/skills/microsoft-foundry/models/deploy-model/SKILL.md`	1625	500	+1125
`plugin/skills/microsoft-foundry/models/deploy-model/capacity/SKILL.md`	1724	500	+1224
`plugin/skills/microsoft-foundry/models/deploy-model/customize/EXAMPLES.md`	1091	1000	+91
`plugin/skills/microsoft-foundry/models/deploy-model/customize/SKILL.md`	2220	500	+1720
`plugin/skills/microsoft-foundry/models/deploy-model/customize/references/customize-workflow.md`	3335	1000	+2335
`plugin/skills/microsoft-foundry/models/deploy-model/preset/SKILL.md`	1211	500	+711
`plugin/skills/microsoft-foundry/models/deploy-model/preset/references/preset-workflow.md`	5534	1000	+4534
`plugin/skills/microsoft-foundry/models/deploy-model/preset/references/workflow.md`	1315	1000	+315
`plugin/skills/microsoft-foundry/project/create/create-foundry-project.md`	1346	1000	+346
`plugin/skills/microsoft-foundry/quota/quota.md`	2129	1000	+1129
`plugin/skills/microsoft-foundry/quota/references/capacity-planning.md`	1968	1000	+968
`plugin/skills/microsoft-foundry/quota/references/error-resolution.md`	1141	1000	+141
`plugin/skills/microsoft-foundry/quota/references/optimization.md`	1846	1000	+846
`plugin/skills/microsoft-foundry/quota/references/ptu-guide.md`	1473	1000	+473
`plugin/skills/microsoft-foundry/quota/references/troubleshooting.md`	1807	1000	+807
`plugin/skills/microsoft-foundry/quota/references/workflows.md`	1614	1000	+614
`plugin/skills/microsoft-foundry/rbac/rbac.md`	1752	1000	+752
`plugin/skills/microsoft-foundry/references/auth-best-practices.md`	1543	1000	+543
`plugin/skills/microsoft-foundry/references/sdk/foundry-sdk-py.md`	2060	1000	+1060
`plugin/skills/microsoft-foundry/resource/create/create-foundry-resource.md`	1489	1000	+489
`plugin/skills/microsoft-foundry/resource/create/references/workflows.md`	1637	1000	+637
`.github/agents/SkillCreator.agent.md`	1044	1000	+44

Consider moving content to references/ subdirectories.

Automated token analysis. See skill authoring guidelines for best practices.

Copilot

Pull request overview

Updates the azure-prepare Azure Functions reference docs to avoid stale, hardcoded language runtime versions by directing agents to query Microsoft’s official “Supported languages” documentation at generation time.

Changes:

Replaces hardcoded runtime versions in the Functions runtime table with <version> placeholders and adds a “always query official docs” callout + version selection guidance.
Adds missing PowerShell runtime row and updates .NET worker runtime guidance to dotnet-isolated.
Replaces a hardcoded Python runtime version in the Flex Consumption Bicep example with a <version> placeholder and doc link.

Reviewed changes

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

File	Description
`plugin/skills/azure-prepare/references/services/functions/README.md`	Shifts runtime version guidance from pinned values to “query official docs” workflow; updates runtime identifiers and adds PowerShell row.
`plugin/skills/azure-prepare/references/services/functions/bicep.md`	Removes hardcoded Python runtime version in Flex Consumption example in favor of a `<version>` placeholder and doc link.

plugin/skills/azure-prepare/references/services/functions/README.md

plugin/skills/azure-prepare/references/services/functions/bicep.md

JasonYeMSFT

Copilot made a few good comments. If you merge this PR as is, please address them in a separate PR.

tmeschter · 2026-02-27T21:34:42Z

@copilot apply changes based on the comments in this thread

…sion Co-authored-by: tmeschter <10506730+tmeschter@users.noreply.github.com>

Initial plan

f15bd29

Copilot AI assigned Copilot and tmeschter Feb 27, 2026

Copilot started work on behalf of tmeschter February 27, 2026 00:48 View session

Replace hardcoded runtime versions with guidance to query official docs

ae5ffbb

Co-authored-by: tmeschter <10506730+tmeschter@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Update hardcoded runtime versions in skill docs~~ Replace hardcoded Azure Functions runtime versions with dynamic doc-query guidance Feb 27, 2026

Copilot finished work on behalf of tmeschter February 27, 2026 00:51

tmeschter marked this pull request as ready for review February 27, 2026 17:27

tmeschter requested review from Copilot, paulyuk and wbreza February 27, 2026 17:27

Copilot started reviewing on behalf of tmeschter February 27, 2026 17:28 View session

Copilot AI reviewed Feb 27, 2026

View reviewed changes

plugin/skills/azure-prepare/references/services/functions/README.md Outdated Show resolved Hide resolved

plugin/skills/azure-prepare/references/services/functions/bicep.md Show resolved Hide resolved

github-actions bot mentioned this pull request Feb 27, 2026

[repo-status] Weekly Repo Status — Feb 20–27, 2026 #1066

Closed

JasonYeMSFT previously approved these changes Feb 27, 2026

View reviewed changes

Copilot started work on behalf of tmeschter February 27, 2026 21:34 View session

Address PR review: fix MCP tool format and legacy bicep hardcoded ver…

18f3f52

…sion Co-authored-by: tmeschter <10506730+tmeschter@users.noreply.github.com>

Copilot AI dismissed JasonYeMSFT’s stale review via 18f3f52 February 27, 2026 21:36

Copilot finished work on behalf of tmeschter February 27, 2026 21:37

JasonYeMSFT approved these changes Mar 2, 2026

View reviewed changes

tmeschter merged commit 9db5e67 into main Mar 2, 2026
11 checks passed

tmeschter deleted the copilot/update-runtime-versions branch March 2, 2026 22:21

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Replace hardcoded Azure Functions runtime versions with dynamic doc-query guidance#1060

Replace hardcoded Azure Functions runtime versions with dynamic doc-query guidance#1060
tmeschter merged 3 commits intomainfrom
copilot/update-runtime-versions

Copilot AI commented Feb 27, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 27, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

JasonYeMSFT left a comment

Uh oh!

tmeschter commented Feb 27, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Language	Hardcoded	Current GA	Status
Node.js	18	22, 20	❌ Node 18 not even listed anymore!
Python	3.11	3.13, 3.12, 3.11	⚠️ Outdated
.NET	8.0	10, 9, 8	❌ .NET 10 is GA
Java	17	21, 17, 11, 8	✅ OK (LTS)
PowerShell	missing	7.4	❌ Not listed

Conversation

Copilot AI commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Current Problem

Impact

Suggested Fix

Files Affected

Related Issues

Comments on the Issue (you are @copilot in this section)

Uh oh!

github-actions bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Token Analysis Report

📊 Token Change Report

Summary

Changed Files

📊 Token Limit Check Report

⚠️ Files Exceeding Token Limits

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

JasonYeMSFT left a comment

Choose a reason for hiding this comment

Uh oh!

tmeschter commented Feb 27, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Copilot AI commented Feb 27, 2026 •

edited

Loading

github-actions bot commented Feb 27, 2026 •

edited

Loading