Skip to content

Clarify Azure AI Foundry format parameter documentation#313

Merged
IEvangelist merged 2 commits intomainfrom
copilot/update-documentation-for-format-parameter
Jan 30, 2026
Merged

Clarify Azure AI Foundry format parameter documentation#313
IEvangelist merged 2 commits intomainfrom
copilot/update-documentation-for-format-parameter

Conversation

Copy link
Contributor

Copilot AI commented Jan 29, 2026

The format parameter documentation incorrectly stated users could find this value in the Azure AI Foundry portal. Users reported this information is not visible anywhere in the portal.

Changes

  • Updated the note in the Azure AI Foundry integration docs to clarify that format specifies the model publisher/provider
  • Added common examples: "OpenAI" for GPT models, "Microsoft" for Phi models
  • Added link to AIFoundryModel API reference

Screenshot

Updated format parameter documentation

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • https://api.github.com/repos/CommunityToolkit/Aspire/contributors
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (http block)
  • https://api.github.com/repos/dotnet/aspire-samples/contributors
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (http block)
  • https://api.github.com/repos/dotnet/aspire/contributors
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (http block)
  • https://api.github.com/repos/microsoft/aspire.dev/contributors
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (http block)
  • https://api.github.com/repos/microsoft/dcp/contributors
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (http block)
  • learn.microsoft.com
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (dns block)
  • telemetry.astro.build
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (dns block)
    • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js dev git log %D �� %b �� %aN �� %aE ���� --follow k/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/git udes/option-versgit --follow tools/pnpm/10.28--exclude-standard /usr/lib/git-cor--others remo�� t/docs/integrations/cloud/azure/azure-ai-foundry.mdx REDACTED .1/bin/git resources.mdx --follow e/git git (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Op:
According to the docs (https://aspire.dev/integrations/cloud/azure/azure-ai-foundry/), the format parameter is supposed to be in the Foundry portal in the detail page of the model after the Quick facts section. Yet, I've checked every model page in the old and new foundry and there is no listed parameter named format available anywhere on any of these pages. Any docs on what this value should be set to for GPT-* models? Or where to find it?

Answer:

Op: Ah, nice, ok. That helps a lot. Probably just need to make the docs a little clearer there.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI changed the title [WIP] Update documentation for format parameter in Foundry Clarify Azure AI Foundry format parameter documentation Jan 29, 2026
Copilot AI requested a review from IEvangelist January 29, 2026 16:07
@IEvangelist IEvangelist marked this pull request as ready for review January 29, 2026 16:08
@IEvangelist IEvangelist requested a review from eerhardt as a code owner January 29, 2026 16:08
Copilot AI review requested due to automatic review settings January 29, 2026 16:08
@IEvangelist IEvangelist enabled auto-merge (squash) January 29, 2026 16:09
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR fixes incorrect documentation for the format parameter in the Azure AI Foundry integration. The previous documentation incorrectly stated users could find the format value in the Azure AI Foundry portal, but this information is not available there. The updated documentation clarifies that the format parameter specifies the model publisher/provider and provides concrete examples.

Changes:

  • Replaced incorrect statement about finding format in the portal with accurate explanation of what the parameter represents
  • Added examples showing "OpenAI" for GPT models and "Microsoft" for Phi models
  • Included link to AIFoundryModel API reference documentation for additional details

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@IEvangelist IEvangelist merged commit 31183e0 into main Jan 30, 2026
12 checks passed
@IEvangelist IEvangelist deleted the copilot/update-documentation-for-format-parameter branch January 30, 2026 17:48
IEvangelist added a commit that referenced this pull request Feb 3, 2026
* Clarify Azure AI Foundry format parameter documentation (#313)

* Initial plan

* Improve Azure AI Foundry format parameter documentation

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Configure WAF on the Azure Front Door (#324)

* Configure WAF on the Azure Front Door

These policies are required by Microsoft to prevent DDOS attacks on the site.

* Fix invalid wafPolicy name

* Update resource creation in Node.js docs (#333)

Correction to invalid syntax.

* Add generic "Upgrade Aspire" article under What's new (#322)

* Initial plan

* Add Upgrade Aspire article and update sidebar configuration

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Fix typo and remove broken link in Upgrade Aspire article

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* refactor: streamline Upgrade Aspire article and remove legacy content

* fix: update Upgrade Aspire article for clarity and accuracy

* chore: remove outdated setup and tooling link from Upgrade Aspire article

* fix: update link to installation instructions for Aspire CLI in Upgrade Aspire article

* fix: clarify upgrade instructions and remove outdated content in Upgrade Aspire article

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>

* Add CLI telemetry details page

* Fix

* Fix

* Fix

* Improve doc-tester and doc-writer skills, fix cross-platform paths (#361)

* Add doc-writer and doc-tester skills with hex1b MCP server

- Add doc-writer skill with Aspire documentation guidelines
- Add doc-tester skill for validating documentation accuracy
- Include common documentation rules from PR feedback patterns
- Configure hex1b MCP server in .mcp.json, .vscode/mcp.json, opencode.jsonc
- Add .doc-tester-workspace/ to .gitignore
- Add .vscode/mcp.json exception to .gitignore

* Improve doc-tester and doc-writer skills, fix cross-platform paths

Key changes:

doc-tester skill:
- Add Knowledge Source Awareness section to distinguish between intrinsic knowledge and documentation-derived knowledge
- Add Documentation Takes Priority guidance - follow the docs being tested, not skill defaults
- Add Aspire CLI installation guidance (GA, Dev, PR, and Staging builds)
- Replace dotnet-specific commands with polyglot-friendly Aspire CLI (aspire add, aspire run)
- Add Hex1b MCP tools section for terminal screenshots and asciinema recordings

doc-writer skill:
- Add AsciinemaPlayer component documentation for terminal recordings
- Add Hex1b MCP tools guidance for creating new recordings
- Add Aspire CLI installation guidance for testing documentation
- Add aspire add recommendation for testing integration packages

Other fixes:
- Update Prettier extension recommendation to esbenp.prettier-vscode
- Fix cross-platform path in frontend.esproj (backslash to forward slash)

* Update Hex1b.McpServer to 0.66.0

---------

Co-authored-by: Mitch Denny <mitch@mitchdeny.com>

* Fix PowerShell syntax in telemetry opt-out example

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>
Co-authored-by: Tristan <Tri125@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>
Co-authored-by: Mitch Denny <midenn@microsoft.com>
Co-authored-by: Mitch Denny <mitch@mitchdeny.com>
IEvangelist added a commit that referenced this pull request Feb 3, 2026
* Clarify Azure AI Foundry format parameter documentation (#313)

* Initial plan

* Improve Azure AI Foundry format parameter documentation

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Configure WAF on the Azure Front Door (#324)

* Configure WAF on the Azure Front Door

These policies are required by Microsoft to prevent DDOS attacks on the site.

* Fix invalid wafPolicy name

* Update resource creation in Node.js docs (#333)

Correction to invalid syntax.

* Add generic "Upgrade Aspire" article under What's new (#322)

* Initial plan

* Add Upgrade Aspire article and update sidebar configuration

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Fix typo and remove broken link in Upgrade Aspire article

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* refactor: streamline Upgrade Aspire article and remove legacy content

* fix: update Upgrade Aspire article for clarity and accuracy

* chore: remove outdated setup and tooling link from Upgrade Aspire article

* fix: update link to installation instructions for Aspire CLI in Upgrade Aspire article

* fix: clarify upgrade instructions and remove outdated content in Upgrade Aspire article

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>

* Add CLI telemetry details page

* Fix

* Fix

* Fix

* Improve doc-tester and doc-writer skills, fix cross-platform paths (#361)

* Add doc-writer and doc-tester skills with hex1b MCP server

- Add doc-writer skill with Aspire documentation guidelines
- Add doc-tester skill for validating documentation accuracy
- Include common documentation rules from PR feedback patterns
- Configure hex1b MCP server in .mcp.json, .vscode/mcp.json, opencode.jsonc
- Add .doc-tester-workspace/ to .gitignore
- Add .vscode/mcp.json exception to .gitignore

* Improve doc-tester and doc-writer skills, fix cross-platform paths

Key changes:

doc-tester skill:
- Add Knowledge Source Awareness section to distinguish between intrinsic knowledge and documentation-derived knowledge
- Add Documentation Takes Priority guidance - follow the docs being tested, not skill defaults
- Add Aspire CLI installation guidance (GA, Dev, PR, and Staging builds)
- Replace dotnet-specific commands with polyglot-friendly Aspire CLI (aspire add, aspire run)
- Add Hex1b MCP tools section for terminal screenshots and asciinema recordings

doc-writer skill:
- Add AsciinemaPlayer component documentation for terminal recordings
- Add Hex1b MCP tools guidance for creating new recordings
- Add Aspire CLI installation guidance for testing documentation
- Add aspire add recommendation for testing integration packages

Other fixes:
- Update Prettier extension recommendation to esbenp.prettier-vscode
- Fix cross-platform path in frontend.esproj (backslash to forward slash)

* Update Hex1b.McpServer to 0.66.0

---------

Co-authored-by: Mitch Denny <mitch@mitchdeny.com>

* Fix PowerShell syntax in telemetry opt-out example

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>
Co-authored-by: Tristan <Tri125@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>
Co-authored-by: Mitch Denny <midenn@microsoft.com>
Co-authored-by: Mitch Denny <mitch@mitchdeny.com>
IEvangelist added a commit that referenced this pull request Feb 7, 2026
* Clarify Azure AI Foundry format parameter documentation (#313)

* Initial plan

* Improve Azure AI Foundry format parameter documentation

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Configure WAF on the Azure Front Door (#324)

* Configure WAF on the Azure Front Door

These policies are required by Microsoft to prevent DDOS attacks on the site.

* Fix invalid wafPolicy name

* Update resource creation in Node.js docs (#333)

Correction to invalid syntax.

* Add generic "Upgrade Aspire" article under What's new (#322)

* Initial plan

* Add Upgrade Aspire article and update sidebar configuration

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Fix typo and remove broken link in Upgrade Aspire article

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* refactor: streamline Upgrade Aspire article and remove legacy content

* fix: update Upgrade Aspire article for clarity and accuracy

* chore: remove outdated setup and tooling link from Upgrade Aspire article

* fix: update link to installation instructions for Aspire CLI in Upgrade Aspire article

* fix: clarify upgrade instructions and remove outdated content in Upgrade Aspire article

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>

* Add CLI telemetry details page

* Fix

* Fix

* Fix

* Improve doc-tester and doc-writer skills, fix cross-platform paths (#361)

* Add doc-writer and doc-tester skills with hex1b MCP server

- Add doc-writer skill with Aspire documentation guidelines
- Add doc-tester skill for validating documentation accuracy
- Include common documentation rules from PR feedback patterns
- Configure hex1b MCP server in .mcp.json, .vscode/mcp.json, opencode.jsonc
- Add .doc-tester-workspace/ to .gitignore
- Add .vscode/mcp.json exception to .gitignore

* Improve doc-tester and doc-writer skills, fix cross-platform paths

Key changes:

doc-tester skill:
- Add Knowledge Source Awareness section to distinguish between intrinsic knowledge and documentation-derived knowledge
- Add Documentation Takes Priority guidance - follow the docs being tested, not skill defaults
- Add Aspire CLI installation guidance (GA, Dev, PR, and Staging builds)
- Replace dotnet-specific commands with polyglot-friendly Aspire CLI (aspire add, aspire run)
- Add Hex1b MCP tools section for terminal screenshots and asciinema recordings

doc-writer skill:
- Add AsciinemaPlayer component documentation for terminal recordings
- Add Hex1b MCP tools guidance for creating new recordings
- Add Aspire CLI installation guidance for testing documentation
- Add aspire add recommendation for testing integration packages

Other fixes:
- Update Prettier extension recommendation to esbenp.prettier-vscode
- Fix cross-platform path in frontend.esproj (backslash to forward slash)

* Update Hex1b.McpServer to 0.66.0

---------

Co-authored-by: Mitch Denny <mitch@mitchdeny.com>

* Fix PowerShell syntax in telemetry opt-out example

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>
Co-authored-by: Tristan <Tri125@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>
Co-authored-by: Mitch Denny <midenn@microsoft.com>
Co-authored-by: Mitch Denny <mitch@mitchdeny.com>
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.

3 participants