refactor: improve re-host scenario in foundry skill - #3063
Merged
Conversation
Contributor
Details# 🔍 Token Analysis Report
fatal: path 'plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/foundry-model.md' exists on disk, but not in 'origin/main' 📊 Token Change ReportComparing Summary
Changed Files
📊 Token Limit Check ReportChecked: 848 files
|
| File | Tokens | Limit | Over By |
|---|---|---|---|
.github/skills/analyze-skill-issues/SKILL.md |
2109 | 500 | +1609 |
.github/skills/analyze-test-run/SKILL.md |
2471 | 500 | +1971 |
.github/skills/file-test-bug/SKILL.md |
628 | 500 | +128 |
.github/skills/sensei/SKILL.md |
861 | 500 | +361 |
.github/skills/skill-authoring/SKILL.md |
839 | 500 | +339 |
.github/skills/vally-eval/SKILL.md |
1737 | 500 | +1237 |
plugins/azure-kusto-graph-skills/skills/azure-kusto-graph/SKILL.md |
4810 | 500 | +4310 |
plugins/azure-kusto-graph-skills/skills/azure-kusto-irql/SKILL.md |
2625 | 500 | +2125 |
plugins/azure-kusto-graph-skills/skills/azure-kusto-irql-graph/SKILL.md |
4781 | 500 | +4281 |
plugins/azure-kusto-graph-skills/skills/azure-kusto-irql-graph/references/DEPLOY_IRQL_FUNCTIONS.md |
2854 | 2000 | +854 |
plugins/azure-skills/changelog-2026-07-24.md |
4226 | 2000 | +2226 |
plugins/azure-skills/skills/airunway-aks-setup/SKILL.md |
1025 | 500 | +525 |
plugins/azure-skills/skills/appinsights-instrumentation/SKILL.md |
937 | 500 | +437 |
plugins/azure-skills/skills/azure-ai/SKILL.md |
820 | 500 | +320 |
plugins/azure-skills/skills/azure-aigateway/SKILL.md |
1261 | 500 | +761 |
plugins/azure-skills/skills/azure-aigateway/references/policies.md |
2342 | 2000 | +342 |
plugins/azure-skills/skills/azure-app-onboard/SKILL.md |
1623 | 500 | +1123 |
plugins/azure-skills/skills/azure-app-onboard/deploy/SKILL.md |
1816 | 500 | +1316 |
plugins/azure-skills/skills/azure-app-onboard/deploy/references/code-deployment-container-apps.md |
2140 | 2000 | +140 |
plugins/azure-skills/skills/azure-app-onboard/deploy/references/deploy-checklist-template.md |
2564 | 2000 | +564 |
plugins/azure-skills/skills/azure-app-onboard/prepare/SKILL.md |
1566 | 500 | +1066 |
plugins/azure-skills/skills/azure-app-onboard/prepare/references/pricing-guide-services.md |
2142 | 2000 | +142 |
plugins/azure-skills/skills/azure-app-onboard/prepare/references/service-mapping.md |
2022 | 2000 | +22 |
plugins/azure-skills/skills/azure-app-onboard/prepare/references/sku-quota-validation.md |
2278 | 2000 | +278 |
plugins/azure-skills/skills/azure-app-onboard/references/session-protocol.md |
2026 | 2000 | +26 |
plugins/azure-skills/skills/azure-app-onboard/scaffold/SKILL.md |
3592 | 500 | +3092 |
plugins/azure-skills/skills/azure-app-onboard/scaffold/references/bicep-container-apps.md |
2354 | 2000 | +354 |
plugins/azure-skills/skills/azure-app-onboard/scaffold/references/self-review-checklist.md |
2269 | 2000 | +269 |
plugins/azure-skills/skills/azure-app-onboard/scaffold/references/subagent-iac-gen.md |
2406 | 2000 | +406 |
plugins/azure-skills/skills/azure-app-onboard-prereq/SKILL.md |
2517 | 500 | +2017 |
plugins/azure-skills/skills/azure-app-onboard-prereq/references/dependency-compatibility.md |
2239 | 2000 | +239 |
plugins/azure-skills/skills/azure-cloud-migrate/SKILL.md |
1085 | 500 | +585 |
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/cloudrun-deployment-guide.md |
2029 | 2000 | +29 |
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/deployment-guide.md |
2458 | 2000 | +458 |
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/fargate-deployment-guide.md |
2587 | 2000 | +587 |
plugins/azure-skills/skills/azure-cloud-migrate/references/services/container-apps/spring-deployment-guide.md |
3871 | 2000 | +1871 |
plugins/azure-skills/skills/azure-cloud-migrate/references/services/functions/lambda-to-functions.md |
2600 | 2000 | +600 |
plugins/azure-skills/skills/azure-cloud-migrate/references/services/functions/runtimes/javascript.md |
2181 | 2000 | +181 |
plugins/azure-skills/skills/azure-compliance/SKILL.md |
1188 | 500 | +688 |
plugins/azure-skills/skills/azure-compute/SKILL.md |
657 | 500 | +157 |
plugins/azure-skills/skills/azure-compute/workflows/essential-machine-management/references/emm-enable-flow.md |
2344 | 2000 | +344 |
plugins/azure-skills/skills/azure-deploy/SKILL.md |
1645 | 500 | +1145 |
plugins/azure-skills/skills/azure-deploy/references/pre-deploy-checklist.md |
4692 | 2000 | +2692 |
plugins/azure-skills/skills/azure-deploy/references/recipes/azd/errors.md |
4004 | 2000 | +2004 |
plugins/azure-skills/skills/azure-deploy/references/troubleshooting.md |
2038 | 2000 | +38 |
plugins/azure-skills/skills/azure-diagnostics/SKILL.md |
1596 | 500 | +1096 |
plugins/azure-skills/skills/azure-enterprise-infra-planner/SKILL.md |
911 | 500 | +411 |
plugins/azure-skills/skills/azure-enterprise-infra-planner/references/constraints/compute-apps.md |
2022 | 2000 | +22 |
plugins/azure-skills/skills/azure-kubernetes/SKILL.md |
2723 | 500 | +2223 |
plugins/azure-skills/skills/azure-kubernetes/azure-kubernetes-automatic-readiness/SKILL.md |
3690 | 500 | +3190 |
plugins/azure-skills/skills/azure-kusto/SKILL.md |
2152 | 500 | +1652 |
plugins/azure-skills/skills/azure-messaging/SKILL.md |
821 | 500 | +321 |
plugins/azure-skills/skills/azure-prepare/SKILL.md |
3145 | 500 | +2645 |
plugins/azure-skills/skills/azure-prepare/references/aspire.md |
4617 | 2000 | +2617 |
plugins/azure-skills/skills/azure-prepare/references/plan-template.md |
2560 | 2000 | +560 |
plugins/azure-skills/skills/azure-prepare/references/recipes/azd/aspire.md |
2275 | 2000 | +275 |
plugins/azure-skills/skills/azure-prepare/references/recipes/azd/terraform.md |
3555 | 2000 | +1555 |
plugins/azure-skills/skills/azure-prepare/references/research.md |
2196 | 2000 | +196 |
plugins/azure-skills/skills/azure-prepare/references/resources-limits-quotas.md |
3322 | 2000 | +1322 |
plugins/azure-skills/skills/azure-prepare/references/security.md |
2147 | 2000 | +147 |
plugins/azure-skills/skills/azure-prepare/references/services/functions/bicep.md |
3043 | 2000 | +1043 |
plugins/azure-skills/skills/azure-prepare/references/services/functions/templates/recipes/composition.md |
2813 | 2000 | +813 |
plugins/azure-skills/skills/azure-prepare/references/services/functions/terraform.md |
3404 | 2000 | +1404 |
plugins/azure-skills/skills/azure-quotas/SKILL.md |
3006 | 500 | +2506 |
plugins/azure-skills/skills/azure-quotas/references/commands.md |
2644 | 2000 | +644 |
plugins/azure-skills/skills/azure-reliability/SKILL.md |
5922 | 500 | +5422 |
plugins/azure-skills/skills/azure-reliability/references/configure-multi-region.md |
4729 | 2000 | +2729 |
plugins/azure-skills/skills/azure-reliability/references/services/app-service/reliability.md |
2591 | 2000 | +591 |
plugins/azure-skills/skills/azure-resource-lookup/SKILL.md |
1367 | 500 | +867 |
plugins/azure-skills/skills/azure-resource-visualizer/SKILL.md |
2122 | 500 | +1622 |
plugins/azure-skills/skills/azure-storage/SKILL.md |
1228 | 500 | +728 |
plugins/azure-skills/skills/azure-upgrade/SKILL.md |
1542 | 500 | +1042 |
plugins/azure-skills/skills/azure-upgrade/references/languages/java/INSTRUCTION.md |
2893 | 2000 | +893 |
plugins/azure-skills/skills/azure-upgrade/references/languages/java/package-specific/com.microsoft.azure.management.md |
2428 | 2000 | +428 |
plugins/azure-skills/skills/azure-upgrade/references/languages/java/templates/PLAN_TEMPLATE.md |
2411 | 2000 | +411 |
plugins/azure-skills/skills/azure-upgrade/references/languages/java/templates/PROGRESS_TEMPLATE.md |
2315 | 2000 | +315 |
plugins/azure-skills/skills/azure-upgrade/references/languages/java/templates/SUMMARY_TEMPLATE.md |
2190 | 2000 | +190 |
plugins/azure-skills/skills/azure-upgrade/references/services/functions/automation.md |
3463 | 2000 | +1463 |
plugins/azure-skills/skills/azure-upgrade/references/services/functions/consumption-to-flex.md |
2773 | 2000 | +773 |
plugins/azure-skills/skills/azure-validate/SKILL.md |
897 | 500 | +397 |
plugins/azure-skills/skills/entra-agent-id/SKILL.md |
3994 | 500 | +3494 |
plugins/azure-skills/skills/entra-app-registration/SKILL.md |
2058 | 500 | +1558 |
plugins/azure-skills/skills/entra-app-registration/references/api-permissions.md |
2545 | 2000 | +545 |
plugins/azure-skills/skills/entra-app-registration/references/cli-commands.md |
2211 | 2000 | +211 |
plugins/azure-skills/skills/entra-app-registration/references/console-app-example.md |
2752 | 2000 | +752 |
plugins/azure-skills/skills/entra-app-registration/references/oauth-flows.md |
2375 | 2000 | +375 |
plugins/azure-skills/skills/microsoft-foundry/SKILL.md |
6501 | 500 | +6001 |
plugins/azure-skills/skills/microsoft-foundry/finetuning/SKILL.md |
1376 | 500 | +876 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/azd-guidance/references/azd-ai-cli.md |
2230 | 2000 | +230 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md |
7598 | 2000 | +5598 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/quick-start-hosted.md |
5635 | 2000 | +3635 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/foundry-tool-catalog.md |
10922 | 2000 | +8922 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/local-run.md |
2443 | 2000 | +443 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/use-toolbox-in-hosted-agent.md |
2643 | 2000 | +643 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/deploy/deploy.md |
5033 | 2000 | +3033 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/eval-datasets/eval-datasets.md |
2863 | 2000 | +863 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/eval-datasets/references/generate-seed-dataset.md |
2212 | 2000 | +212 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/eval-datasets/references/trace-to-dataset.md |
4325 | 2000 | +2325 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/invocations-ws/invocations-ws.md |
2652 | 2000 | +652 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/observe.md |
3856 | 2000 | +1856 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/continuous-eval.md |
3855 | 2000 | +1855 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/evaluate-step.md |
2175 | 2000 | +175 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/observe/references/evaluation-suite-generation.md |
3134 | 2000 | +1134 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/routine/routine.md |
2032 | 2000 | +32 |
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/trace/references/kql-templates.md |
2701 | 2000 | +701 |
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/SKILL.md |
1798 | 500 | +1298 |
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/capacity/SKILL.md |
1739 | 500 | +1239 |
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/SKILL.md |
2236 | 500 | +1736 |
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/customize/references/customize-workflow.md |
3336 | 2000 | +1336 |
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/SKILL.md |
1227 | 500 | +727 |
plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/preset/references/preset-workflow.md |
5539 | 2000 | +3539 |
plugins/azure-skills/skills/microsoft-foundry/project/create/create-foundry-project.md |
2287 | 2000 | +287 |
plugins/azure-skills/skills/microsoft-foundry/quota/quota.md |
2289 | 2000 | +289 |
plugins/azure-skills/skills/microsoft-foundry/quota/references/capacity-planning.md |
2081 | 2000 | +81 |
plugins/azure-skills/skills/microsoft-foundry/references/agent-metadata-contract.md |
2217 | 2000 | +217 |
plugins/azure-skills/skills/python-appservice-deploy/SKILL.md |
688 | 500 | +188 |
Consider moving content to
references/subdirectories.
Automated token analysis. See skill authoring guidelines for best practices.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refactors the microsoft-foundry skill’s hosted-agent creation guidance to better support “re-host an existing agent” scenarios, adds a dedicated Foundry model/quota reference, and updates E2E eval prompts to use eastus.
Changes:
- Added dedicated re-hosting documentation and a Foundry model/quota reference page.
- Updated hosted-agent creation docs to clarify sample usage, environment setting flow, and where to consult model metadata/quota guidance.
- Updated the Foundry skill eval stimuli regions from
eastus2toeastus.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/re-host.md | New re-host workflow reference for migrating/rehoming agents into Foundry. |
| plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/foundry-model.md | New reference for querying regional model catalog and usage/quota. |
| plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/quick-start-hosted.md | Clarifies sample-selection usage, env-setting sequence, and model/quota troubleshooting reference. |
| plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md | Extracts re-host flow into dedicated reference, refines env-setting guidance, and links to model reference. |
| evals/azure-skills/microsoft-foundry/eval.yaml | Switches hosted-agent and migration eval regions from eastus2 to eastus. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.
Suppressed comments (8)
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/re-host.md:14
- “agent code” is typically treated as an uncountable noun here; “agent codes” reads awkwardly in this sentence.
To scaffold a Foundry agent project with existing agent codes, run:
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md:198
- Hyphenate “model-related” (compound adjective) for consistency with quick-start-hosted.md and other documentation.
Read [Foundry Model Reference](./references/foundry-model.md) and follow the steps in it when you want to query model related data.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/re-host.md:31
- This section uses informal wording (“awesome”) and bare URLs. Elsewhere in this skill, sample links are formatted as Markdown links (e.g., create/references/use-toolbox-in-hosted-agent.md:20-24); aligning improves readability and consistency.
For reference, here are some awesome samples for re-hosting scenarios:
1. Re-host agents built with the OpenAI Agents SDK: https://github.com/microsoft-foundry/foundry-samples/tree/main/samples/python/hosted-agents/bring-your-own/responses/openai-agents-sdk
2. Re-host agents built with the Claude Agent SDK: https://github.com/microsoft-foundry/foundry-samples/tree/main/samples/python/hosted-agents/bring-your-own/invocations/claude-agent-sdk
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/foundry-model.md:36
- Grammar: “agent support” reads more naturally than “agents support” in this bullet.
- Capabilities such as Responses, chat completions, and agents support.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/foundry-model.md:41
- The command shown returns all usage records for the subscription+region; it doesn’t directly query “the exact model and SKU”. Tweaking this sentence to mention filtering avoids implying the CLI call is already scoped.
Query the regional usage record for the exact model and SKU, then calculate the currently available quota:
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/references/re-host.md:49
- Hyphenate the compound adjective “model-related” for consistency with other docs (and this PR’s own quick-start-hosted.md).
Read [Foundry Model Reference](./foundry-model.md) and follow the steps in it when you want to query model related data.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/quick-start-hosted.md:86
- Add the missing article (“the user’s task”) to avoid a grammatical stumble in this guidance sentence.
You should pick only one sample for `azd ai agent init`, but you can browse multiple samples relevant to user's task as code reference.
plugins/azure-skills/skills/microsoft-foundry/foundry-agent/create/create-hosted.md:147
- Hyphenate “model-related” (compound adjective) for consistency with quick-start-hosted.md and other documentation.
This issue also appears on line 198 of the same file.
Read [Foundry Model Reference](./references/foundry-model.md) and follow the steps in it when you want to query model related data.
Xiaofu Huang (XiaofuHuang)
approved these changes
Aug 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Improve the hosted-agent re-host scenario and some other creation workflow.
azd ai agent inituses one sample while other relevant samples may be consulted as implementation references.azd env setas separate commands after initialization and from the scaffolded project directory.eastus2toeastus.Checklist
cd tests && npm test)fix:,feat:,feature:,chore:,misc:,test:,eval:tests/,npm run test:integration -- <skill>ornpm run test:vally -- --skill <skill>)Related Issues