Last 20 commits touching this section.
Merge remote-tracking branch 'upstream/main' into alvinashcraft/main-grok-47-release
Clarify Voice Live quickstart title and move classic to Deprecated (#14728) * docs: clarify Voice Live quickstart and archive classic navigation Rename the quickstart to Voice Live with Foundry Agent Service, align title references, and move the classic integration under Deprecated without changing URLs. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: address Voice Live AI wording suggestions Use by using for SDK descriptions and present tense for the C# introduction. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Yulin Li <yulili@microsoft.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Merge remote-tracking branch 'upstream/main' into alvinashcraft/main-aoai-release-0929
Clarify managed compute Hugging Face guidance (#14641) * docs: clarify managed compute Hugging Face guidance * Update articles/foundry/how-to/deploy-models-managed.md Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * docs: update Hugging Face guidance attribution Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Update VNET docs for observability (#14388) * Update VNET docs * updated * updated * updated * updated
Release preview voice agent (#13844) * block out changes * overview P0 voice agent drafts * voice agent quickstart stub and links * rm word wrap * Apply suggestions from code review Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Add azd prompt voice agent quickstart Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * add voice agent mentions * voice agent mention * toc split and stub articles * Document advanced prompt voice settings Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address prompt voice authoring feedback Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify prompt voice preview prerequisites Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Defer prompt voice extension version requirement Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify advanced prompt voice settings Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs(agents): add voice-first agent guidance Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9acf4d1e-e442-4cbd-901c-7a2837083107 * Apply suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * H2 changes * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> * fix word wrap * add tentative limits and other aux content * change tentative note * Document voice agent integrations Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Exclude Voice Live hosted agent changes Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update articles/foundry/agents/how-to/use-subagent-voice-first-agent.md Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Update articles/foundry/agents/how-to/use-subagent-voice-first-agent.md Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Fill in voice-first agent P0 articles Replaces the placeholder voice-first agent articles with content grounded in the public voice-agents TypeSpec and the maintained Foundry SDK samples. - Configure a voice agent: model type, instructions, greeting and structured inputs, input/output audio, turn detection, transcription, tools, interim responses, and conversation persistence. - Optimize voice agent instructions: five-section instruction structure, writing for speech, tool descriptions, and validation. - Best practices: latency, turn-taking, tool design, interruption handling, privacy, and production readiness. - Tracing, monitoring, and evaluation: trace structure, latency and interruption attributes, content-capture opt-in, stored conversation routes, and transcript-based evaluation. - Pricing: cost drivers, managed vs self-deployed billing, and cost reduction guidance. - Teams phone: renamed to a task-based title and documented the Teams Phone extensibility call path, telephony bindings, Event Grid setup, and transfer targets. - Quickstart: replaced placeholder code with runnable Python samples for creating an agent, completing a turn, and reading the conversation back. Telephony and WebRTC routes aren't in the public spec yet, so that content is marked preview and unverified details are flagged with [TO VERIFY]. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Scope observability article to a summary with links The doc plan asks for "Tracing, monitoring and evaluation (summary and links to articles under 'observability')". The previous version was a standalone deep dive that duplicated the observability articles. - Rewrite as a summary that points to the existing observability articles for tracing setup, sensitive content, monitoring, and evaluation. - Keep only the voice-specific parts: what voice turns add to a trace, and conversation storage, which isn't covered elsewhere. - Revert the TOC regrouping that wasn't part of the plan. The only TOC change is the Teams phone entry name matching its retitled article. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * combine like drafts * combine overviews * combine quickstarts * move + rename channel-publish article * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * writer edits * use platform zone pivots * writer edits / fleshing out * writer edits * use zone pivots in tele how-to * Review agent fixes * Remove unsupported Speech CLI option from voice agent quickstart Remove the unused speech-cli pivot from voice-agent-quickstart-tools. Keep the Foundry portal, Python SDK, and Azure Developer CLI paths unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Require Azure AI Projects SDK 2.7.0 in the voice agent quickstart Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Preserve existing quickstart end-of-file spacing Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document both Python voice agent creation methods Add natural-language generation alongside explicit definitions, preserve generated configuration with storage enabled, and align the shared realtime example with SDK model names and greeting handling. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Adjust voice quickstart model selection defaults Let generation select its model and default the explicit-definition example to gpt-realtime-2.1. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document session-start greeting configuration Show template and model-generated greetings, use current SDK greeting classes, and explain disabling greetings and receiving the initial response. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Refresh voice agent configuration Python examples for SDK 2.7 Use current audio, transcription, and tool models; serialize interim latency as a timedelta; keep shared configuration objects coherent; and include authenticated preview-enabled client setup for saving versions. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Align voice agent telephony REST examples with the current contract Use provider-specific bindings, returned incoming-call URLs, ETag-protected updates and deletion, agent-level transfer targets, and separate call transfer/end operations. Include authenticated Event Grid delivery while preserving supported phone transfers and SDK installation guidance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document hosted agent voice conversation engine * Add Python client for voice agent conversations * Improve voice subagent documentation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add greeting to hosted agent voice example * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * pr fixes * Revert "Merge branch 'speech-voice-agent' of https://github.com/PatrickFarley/azure-ai-docs-pr into speech-voice-agent" This reverts commit 0783784105b36a4342645bfc853617ebfd9b4605, reversing changes made to 96cee51b6120e6ffa2939990ed65f72d2d868bc7. * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * overview P0 voice agent drafts (#14051) * overview P0 voice agent drafts * voice agent quickstart stub and links * rm word wrap * Apply suggestions from code review Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Add azd prompt voice agent quickstart Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * add voice agent mentions * voice agent mention * toc split and stub articles * Document advanced prompt voice settings Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address prompt voice authoring feedback Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify prompt voice preview prerequisites Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Defer prompt voice extension version requirement Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify advanced prompt voice settings Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs(agents): add voice-first agent guidance Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9acf4d1e-e442-4cbd-901c-7a2837083107 * Apply suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * H2 changes * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> * fix word wrap * add tentative limits and other aux content * change tentative note * Document voice agent integrations Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Exclude Voice Live hosted agent changes Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update articles/foundry/agents/how-to/use-subagent-voice-first-agent.md Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Update articles/foundry/agents/how-to/use-subagent-voice-first-agent.md Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Fill in voice-first agent P0 articles Replaces the placeholder voice-first agent articles with content grounded in the public voice-agents TypeSpec and the maintained Foundry SDK samples. - Configure a voice agent: model type, instructions, greeting and structured inputs, input/output audio, turn detection, transcription, tools, interim responses, and conversation persistence. - Optimize voice agent instructions: five-section instruction structure, writing for speech, tool descriptions, and validation. - Best practices: latency, turn-taking, tool design, interruption handling, privacy, and production readiness. - Tracing, monitoring, and evaluation: trace structure, latency and interruption attributes, content-capture opt-in, stored conversation routes, and transcript-based evaluation. - Pricing: cost drivers, managed vs self-deployed billing, and cost reduction guidance. - Teams phone: renamed to a task-based title and documented the Teams Phone extensibility call path, telephony bindings, Event Grid setup, and transfer targets. - Quickstart: replaced placeholder code with runnable Python samples for creating an agent, completing a turn, and reading the conversation back. Telephony and WebRTC routes aren't in the public spec yet, so that content is marked preview and unverified details are flagged with [TO VERIFY]. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Scope observability article to a summary with links The doc plan asks for "Tracing, monitoring and evaluation (summary and links to articles under 'observability')". The previous version was a standalone deep dive that duplicated the observability articles. - Rewrite as a summary that points to the existing observability articles for tracing setup, sensitive content, monitoring, and evaluation. - Keep only the voice-specific parts: what voice turns add to a trace, and conversation storage, which isn't covered elsewhere. - Revert the TOC regrouping that wasn't part of the plan. The only TOC change is the Teams phone entry name matching its retitled article. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * combine like drafts * combine overviews * combine quickstarts * move + rename channel-publish article * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * writer edits * use platform zone pivots * writer edits / fleshing out * writer edits * use zone pivots in tele how-to * Review agent fixes * Remove unsupported Speech CLI option from voice agent quickstart Remove the unused speech-cli pivot from voice-agent-quickstart-tools. Keep the Foundry portal, Python SDK, and Azure Developer CLI paths unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Require Azure AI Projects SDK 2.7.0 in the voice agent quickstart Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Preserve existing quickstart end-of-file spacing Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document both Python voice agent creation methods Add natural-language generation alongside explicit definitions, preserve generated configuration with storage enabled, and align the shared realtime example with SDK model names and greeting handling. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Adjust voice quickstart model selection defaults Let generation select its model and default the explicit-definition example to gpt-realtime-2.1. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document session-start greeting configuration Show template and model-generated greetings, use current SDK greeting classes, and explain disabling greetings and receiving the initial response. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Refresh voice agent configuration Python examples for SDK 2.7 Use current audio, transcription, and tool models; serialize interim latency as a timedelta; keep shared configuration objects coherent; and include authenticated preview-enabled client setup for saving versions. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Align voice agent telephony REST examples with the current contract Use provider-specific bindings, returned incoming-call URLs, ETag-protected updates and deletion, agent-level transfer targets, and separate call transfer/end operations. Include authenticated Event Grid delivery while preserving supported phone transfers and SDK installation guidance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Improve voice subagent documentation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * GA of Automate agents with routines * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * pr fixes * Revert "Merge branch 'speech-voice-agent' of https://github.com/PatrickFarley/azure-ai-docs-pr into speech-voice-agent" This reverts commit 0783784105b36a4342645bfc853617ebfd9b4605, reversing changes made to 96cee51b6120e6ffa2939990ed65f72d2d868bc7. * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> --------- Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: Junjie Li <junjieli@microsoft.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Co-authored-by: Varsha Saha <varshasaha@microsoft.com> Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: Jian Miao <jianm@microsoft.com> Co-authored-by: Jian Miao <1238408+unbuilt@users.noreply.github.com> Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> Co-authored-by: Yulin Li <yulili@microsoft.com> Co-authored-by: sdgilley <3650506+sdgilley@users.noreply.github.com> Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com> Copilot-Session: 9acf4d1e-e442-4cbd-901c-7a2837083107 * rename and writer edits * add to toc * Document voice agent observability and simulation (#14364) Co-authored-by: Shivank Goel <shivankgoel@microsoft.com> * fix(agents): remove unsupported voice instruction option (#14341) * fix(agents): remove unsupported voice instruction option Remove portal guidance for the unsupported industry use-case instruction optimizer and direct users to enter instructions in the playground. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 6fbcf4e9-4e65-4cc2-a5e2-da8b1043735b * Update prompt-voice-agent.md --------- Co-authored-by: Varsha Saha <varshasaha@microsoft.com> Co-authored-by: Samantha Salgado <96396805+ssalgadodev@users.noreply.github.com> Copilot-Session: 6fbcf4e9-4e65-4cc2-a5e2-da8b1043735b * docs: document update for azd prompt and hosted voice agent public preview (#14439) * docs: clarify verified azd voice agent CLI behavior Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: document azd voice agent public preview features Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: align voice agent guidance with azd implementation Correct the interactive voice menu path and clarify BYOM initialization and distinct hosted target names. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: address voice agent authoring feedback Remove the positional above reference from the prompt voice quickstart. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: fix voice client storage and telephony cleanup guidance Adapt the SDK client for store:false without requiring a persisted conversation ID, and document ETag-conditional cleanup with the azd preview telephony route. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify voice agent availability, limits, and retention Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Capitalize Class A in regional support guidance Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Refresh voice agent samples for the latest Python SDK Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: remove forced prose wrapping in azd voice guidance Join prose paragraphs introduced by #14439 without changing wording or non-prose content. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Add note for subagent not support vnet * Add VNet limitation note Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix Python voice quickstart sample link and transcript order Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update articles/foundry/agents/quickstarts/prompt-voice-agent.md Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * rm tbds * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * add voice option in "choose what to build" * change table link * add voice-agent row * rm comment blocks * feature rename * add channels doc to toc; remove duplicate toc entry * rename toc * move toc entry * js qs initial commit * align js qs with sample code * update portal instructions * add js to configure how-to * fix(agents): update voice telephony channel guidance (#14466) * fix(agents): update voice telephony guidance Remove the unsupported ACS-purchased-number path, document the current Teams Phone Extensibility setup, and add the Twilio connection and number-binding flow. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs(agents): align telephony guide with gated UI Clarify provider-specific prerequisites, management behavior, test evidence, and the Teams-only call preview based on the voice_agent_bundle channel implementation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs(agents): frame telephony as channel integration Rename the provider-neutral article and update its title, terminology, TOC entry, and inbound links to cover both Microsoft Teams Phone and Twilio channel integrations. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * fix: redirect renamed voice telephony article Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: e5b40796-072b-4f9d-a9d4-bdb8397e6365 --------- Co-authored-by: Varsha Saha <varshasaha@microsoft.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Patrick Farley <pafarley@microsoft.com> Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> Copilot-Session: e5b40796-072b-4f9d-a9d4-bdb8397e6365 * use zone pivots * clarify sdk * fix link * add toc link * Speech voice agent updates (#14540) * overview P0 voice agent drafts * voice agent quickstart stub and links * rm word wrap * Apply suggestions from code review Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Add azd prompt voice agent quickstart Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * add voice agent mentions * voice agent mention * toc split and stub articles * Document advanced prompt voice settings Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address prompt voice authoring feedback Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify prompt voice preview prerequisites Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Defer prompt voice extension version requirement Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify advanced prompt voice settings Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs(agents): add voice-first agent guidance Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9acf4d1e-e442-4cbd-901c-7a2837083107 * Apply suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * H2 changes * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> * fix word wrap * add tentative limits and other aux content * change tentative note * Document voice agent integrations Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Exclude Voice Live hosted agent changes Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update articles/foundry/agents/how-to/use-subagent-voice-first-agent.md Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Update articles/foundry/agents/how-to/use-subagent-voice-first-agent.md Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Fill in voice-first agent P0 articles Replaces the placeholder voice-first agent articles with content grounded in the public voice-agents TypeSpec and the maintained Foundry SDK samples. - Configure a voice agent: model type, instructions, greeting and structured inputs, input/output audio, turn detection, transcription, tools, interim responses, and conversation persistence. - Optimize voice agent instructions: five-section instruction structure, writing for speech, tool descriptions, and validation. - Best practices: latency, turn-taking, tool design, interruption handling, privacy, and production readiness. - Tracing, monitoring, and evaluation: trace structure, latency and interruption attributes, content-capture opt-in, stored conversation routes, and transcript-based evaluation. - Pricing: cost drivers, managed vs self-deployed billing, and cost reduction guidance. - Teams phone: renamed to a task-based title and documented the Teams Phone extensibility call path, telephony bindings, Event Grid setup, and transfer targets. - Quickstart: replaced placeholder code with runnable Python samples for creating an agent, completing a turn, and reading the conversation back. Telephony and WebRTC routes aren't in the public spec yet, so that content is marked preview and unverified details are flagged with [TO VERIFY]. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Scope observability article to a summary with links The doc plan asks for "Tracing, monitoring and evaluation (summary and links to articles under 'observability')". The previous version was a standalone deep dive that duplicated the observability articles. - Rewrite as a summary that points to the existing observability articles for tracing setup, sensitive content, monitoring, and evaluation. - Keep only the voice-specific parts: what voice turns add to a trace, and conversation storage, which isn't covered elsewhere. - Revert the TOC regrouping that wasn't part of the plan. The only TOC change is the Teams phone entry name matching its retitled article. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * combine like drafts * combine overviews * combine quickstarts * move + rename channel-publish article * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * writer edits * use platform zone pivots * writer edits / fleshing out * writer edits * use zone pivots in tele how-to * Review agent fixes * Remove unsupported Speech CLI option from voice agent quickstart Remove the unused speech-cli pivot from voice-agent-quickstart-tools. Keep the Foundry portal, Python SDK, and Azure Developer CLI paths unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Require Azure AI Projects SDK 2.7.0 in the voice agent quickstart Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Preserve existing quickstart end-of-file spacing Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document both Python voice agent creation methods Add natural-language generation alongside explicit definitions, preserve generated configuration with storage enabled, and align the shared realtime example with SDK model names and greeting handling. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Adjust voice quickstart model selection defaults Let generation select its model and default the explicit-definition example to gpt-realtime-2.1. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document session-start greeting configuration Show template and model-generated greetings, use current SDK greeting classes, and explain disabling greetings and receiving the initial response. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Refresh voice agent configuration Python examples for SDK 2.7 Use current audio, transcription, and tool models; serialize interim latency as a timedelta; keep shared configuration objects coherent; and include authenticated preview-enabled client setup for saving versions. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Align voice agent telephony REST examples with the current contract Use provider-specific bindings, returned incoming-call URLs, ETag-protected updates and deletion, agent-level transfer targets, and separate call transfer/end operations. Include authenticated Event Grid delivery while preserving supported phone transfers and SDK installation guidance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document hosted agent voice conversation engine * Add Python client for voice agent conversations * Improve voice subagent documentation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add greeting to hosted agent voice example * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * pr fixes * Revert "Merge branch 'speech-voice-agent' of https://github.com/PatrickFarley/azure-ai-docs-pr into speech-voice-agent" This reverts commit 0783784105b36a4342645bfc853617ebfd9b4605, reversing changes made to 96cee51b6120e6ffa2939990ed65f72d2d868bc7. * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-02[bot] Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * rename and writer edits * add to toc * rm tbds * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * add voice option in "choose what to build" * change table link * add voice-agent row * rm comment blocks * feature rename * add channels doc to toc; remove duplicate toc entry * rename toc * move toc entry * js qs initial commit * align js qs with sample code * update portal instructions * add js to configure how-to * use zone pivots * clarify sdk * fix link * add toc link --------- Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: Junjie Li <junjieli@microsoft.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Co-authored-by: Varsha Saha <varshasaha@microsoft.com> Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: Jian Miao <jianm@microsoft.com> Co-authored-by: Jian Miao <1238408+unbuilt@users.noreply.github.com> Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> Co-authored-by: Yulin Li <yulili@microsoft.com> Co-authored-by: wujin <19744544+knitvoger@users.noreply.github.com> Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> Copilot-Session: 9acf4d1e-e442-4cbd-901c-7a2837083107 * [dirty pr] Speech voice agent (#14574) * fix issue * docs(voice-live): add models and verified pricing tiers Add preview GPT Realtime 2.1 variants and GPT-5.6 Luna availability. Document verified model pricing tiers and align the pricing summary. Link the evaluation guide to the complete supported-model list. Authored-by: GitHub Copilot for VS Code 0.65.0 Model: GitHub Copilot (model ID unavailable) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Document recent Python framework updates * Address authoring feedback * Apply remaining authoring suggestions * Revise retirement date for gpt-4.1-nano (#824) Updated the retirement date for gpt-4.1-nano from 2027-04-14 to 2026-10-14. * Fix retirement date for gpt-image-1.5 (#833) Updated the retirement date for gpt-image-1.5 from 2027-06-16 to 2026-12-16, to align with OpenAI's retirement schedule https://developers.openai.com/api/docs/deprecations#2026-06-02-gpt-image-model-deprecations and our own retirement date, shown in Foundry's model tile. * Cohere-command-a-plus-05-2026 retirement details Added information about replacement models: Hugging Face versions for Cohere-command-a-plus-05-2026. * Apply batched suggestions from code review Co-authored-by: Mope Akande <17515964+msakande@users.noreply.github.com> * Apply suggestion from @msakande * Apply suggestion from @msakande * RBAC requirements for Usages API * Update articles/foundry/concepts/rbac-foundry.md Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * delete duplicate section * Update migrate-to-sdk-1-48-2.md * Update articles/ai-services/speech-service/migrate-to-sdk-1-48-2.md Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * Update personal voice docs for Foundry UX (#14284) * Update personal voice docs for Foundry UX Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Refine personal voice Foundry guidance Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address PR review comments Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Align Personal Voice docs with Foundry portal UX Preserve classic workflows in tabs and add validated creation, playground, and integration guidance with contextual screenshots. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address PR review comments Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Keep Personal Voice portal and REST paths separate Scope introductions and identifiers to their workflows, and preserve portal and REST selections in continuation links. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address PR review comments Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Align Personal Voice setup entry with Professional Voice Use the validated Discover entry as the primary path and retain the Build shortcut in a tip. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Add Personal Voice workflow screenshots and align alternative entry Add contextual setup, consent, and review screenshots with the approved Personal voice display label. Align the Build shortcut with Customizations > Create. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Fix Personal Voice prerequisites, consent guidance, and links Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Remove forced prose wrapping throughout Personal Voice docs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Clarify Work IQ network routing Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update anchor link * Correct the model router policy documentation note by covering both provider and asset id as enabling information. * Apply suggestion from @learn-build-service-prod-01[bot] Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Remove webiq and shell temporarily, redirect (#14452) Co-authored-by: mattwoj_microsoft <115856590+mattwoj_microsoft@users.noreply.github.com> * Refresh Foundry Toolkit agent and workflow documentation (#14332) * Refresh Foundry Toolkit agent and workflow documentation Add agent creation and full prompt-agent lifecycle guides, move and refresh the hosted and declarative workflow articles, and update navigation, redirects, links, and screenshots. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address Foundry Toolkit documentation review feedback Apply authoring suggestions without duplicating reflowed paragraphs, fix the release-notes link, and expand the A2A screenshot filename. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Reconcile hosted workflow guide with VS Code documentation refresh Align the shared lifecycle with microsoft/vscode-docs#10270 while retaining Python and C# workflow samples. Clarify scaffold setup, source and container packaging, runtime configuration, remote testing, version routing, and API access. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Rename hosted agent article title and navigation labels Remove workflows from the page title and matching labels without changing the URL or workflow instructions. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Reconcile hosted agent guidance with refreshed VS Code screenshots Add eight reviewed screenshots from microsoft/vscode-docs#10270 at 73d7650161331565064ac804de073045969eea84. Align sample-gallery and remote-playground navigation, add supporting references, and label illustrative sample and runtime differences while preserving Python/C# workflow guidance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Remove links to deferred Agent Inspector documentation Keep Agent Inspector usage guidance as plain text until the article is added to this doc set. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address hosted agent screenshot caption review comments Clarify the four forward references to screenshots without changing the examples or restoring deferred documentation links. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Match screenshot redactions to their background colors Address Bob review feedback by replacing seven black blocks across four hosted-agent screenshots with the sampled field or panel background. Keep redacted text hidden and preserve all pixels outside the redaction bounds. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document Python vector providers and parser errors * Fix URLs for gpt-live * Fix method call to GetOutputText in SDK overview Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Fix bugs in MAI image docs * Fix hosted agent protocol guidance Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Refresh Azure Machine Learning guidance Correct pipeline samples and damaged registration content, update Automated ML deployment guidance, fix prompt flow JSON, and verify current inference images. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Apply fact-check corrections to Azure ML freshness edits - Restore a correct SDK v2 custom output-path example using Output(path=custom_path) - Make pipeline output download snippets self-contained (define job_name, download_path, output_port_name) - Replace SDK v1 supportedmodels API link with current supported-algorithms guidance - Fix prompt flow input references from ${input.<name>} to ${inputs.<name>} Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * update parameters table with required/optional column * Add guidance for execution environment * Tweak wording * Tweak wording * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> * Refine Work IQ boundary guidance Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update work-iq.md * Apply suggestion from @learn-build-service-prod-05[bot] Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * [BULK PR] Apply new preview terms approach across Azure AI Search docs (#13953) * Replace banners * Fix TOC * Adjust (preview) labels and preview framing * Adjust (preview) labels and preview framing * Adjust (preview) labels and preview framing * Restore MCP banners * Adjust (preview) labels and preview framing * Convert important boxes to warnings * Reposition warnings * Add ai-usage: ai-assisted to metadata * Tweak wording * Tweak wording * Applying CELA feedback from SW review * Added preview terms link * Clarify Serverless pricing model is in preview Update the Serverless pricing model description to indicate it is in preview. * Apply batched suggestions from code review Co-authored-by: Hailey Tapia <170486701+haileytap@users.noreply.github.com> * Apply suggestion from @haileytap * Apply suggestion from @haileytap * Apply suggestion from @haileytap --------- Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com> * Agent Insights (#14287) * Agent Insights * fixes * fixes * fixes * fixes * Update Agent Insights docs with focused SDK examples Align examples with the current SDK samples, remove test and cleanup boilerplate, and document setup and monitor lifecycle behavior. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fixes * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Align Agent Insights docs with SDK 2.6.1 release Update the minimum package version, remove the release warning, and link to the current SDK samples while retaining focused snippets. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: cce8de48-11ca-41e5-bd18-674e3ca79b6b * fix headings * fixes * fixes --------- Co-authored-by: Sean Gayler <sean@CPC-seang-KIDM9.localdomain> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Copilot-Session: cce8de48-11ca-41e5-bd18-674e3ca79b6b * Update date and add model support details Updated the date for the provenance disclosure article and added information about models supporting invisible watermarking for text output. * Remove out-of-place alert box * Update work-iq.md * Tweak wording * Initial plan * Fix background responses C# snippets Co-authored-by: sdgilley <3650506+sdgilley@users.noreply.github.com> * include access policy mode permission guidance for CMK * hosted agents cmk * Initial plan * Fix TypeScript snippet awaits Co-authored-by: sdgilley <3650506+sdgilley@users.noreply.github.com> * Document recent Python framework updates * Fix Agent Skills validation grammar * .NET: Clarify declarative workflow response events (#838) * docs: link compaction to context provider guidance (#828) Co-authored-by: shijian0-eng <182073506+shijian0-eng@users.noreply.github.com> * Clarify CompactionProvider and IChatReducer usage (#832) * Clarify CompactionProvider and IChatReducer usage Explain the lifecycle differences, reducer trigger events, and adapters between CompactionStrategy and IChatReducer. * Apply review suggestion for compaction guidance Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Clarify Microsoft.Extensions.AI reducer reference * Use action-oriented heading for compaction adapters --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Initial plan * Fix SDK overview validation errors Co-authored-by: sdgilley <3650506+sdgilley@users.noreply.github.com> * Update retirement date for gpt-4.1-nano model * Confirm merge from repo_sync_working_branch to main to sync with https://github.com/MicrosoftDocs/azure-ai-docs (branch main) (#14457) * .NET: Clarify declarative workflow response events (#838) * docs: link compaction to context provider guidance (#828) Co-authored-by: shijian0-eng <182073506+shijian0-eng@users.noreply.github.com> * Clarify CompactionProvider and IChatReducer usage (#832) * Clarify CompactionProvider and IChatReducer usage Explain the lifecycle differences, reducer trigger events, and adapters between CompactionStrategy and IChatReducer. * Apply review suggestion for compaction guidance Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Clarify Microsoft.Extensions.AI reducer reference * Use action-oriented heading for compaction adapters --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com> Co-authored-by: Manjunath Janardhan <35326118+manjunathshiva@users.noreply.github.com> Co-authored-by: shijian0-eng <2503236780@qq.com> Co-authored-by: shijian0-eng <182073506+shijian0-eng@users.noreply.github.com> Co-authored-by: hodaUsama <hoda.osama.mahfoz@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Document private networking support for skills Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update date fields to reflect the latest publication date and improve clarity in prerequisites section * Update hosted agent protocol version Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update concepts-model-retirement-schedule-content.md * Apply suggestion from @ssalgadodev * Use Foundry Dev Pack in hosted agent quickstart prerequisites * Add Content Understanding Studio walkthrough to agentic mode quickstart (#14444) * Add Studio walkthrough to agentic mode quickstart Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Inline Studio prerequisites and refine agentic screenshots Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Add contract sample and importable schema to agentic quickstart Preserve the user's prerequisite and walkthrough edits while adding the sample download, schema import steps, and an exact-file publishing resource entry. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Fix agentic schema resource matching in Learn builds Match the schema asset in both src-relative build scope and repository-relative resource classification by prefixing its resource glob with **/. Keep the payload and download link unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update agentic quickstart Studio instructions Check in the author's current article revisions, including simplified project and schema steps and selecting Test before running analysis. Preserve the existing schema download and resource-matching fix. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update articles/ai-services/content-understanding/quickstart/agentic-mode.md Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * update json file presentation * Update link for contract field schema download * Update agentic-mode.md * Delete docfx.json * Add files via upload * Refactor docfx.json to remove duplicate group entries Removed redundant group configurations for machine learning and document intelligence sections in docfx.json. * Fix SVG file exclusion in docfx.json * Delete articles/ai-services/content-understanding/media/quickstarts/agentic-contracts-schema.json * Fix missing newline at end of docfx.json Add missing newline at the end of docfx.json * docfx to main --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com> Co-authored-by: la <50501194+laujan@users.noreply.github.com> Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * Update region support to include Canada Central Added Canada Central region to the supported regions list for Azure Content Understanding. * adding include files (#14134) * adding include files * Update prompt-shield-attack-info.md * Create content-harms.md for AI content safety Added detailed documentation on content harms and severity levels for Azure AI Content Safety, including categories and guardrail configurations. * Add overview for protected material detection filter This document provides an overview of the protected material detection filter, including its functionality, troubleshooting tips, and limitations. * Update protected-material.md to include overview Removed detailed explanation of protected material detection APIs and next steps. * Document harm categories and severity levels Added section on harm categories and severity levels for content safety. * Revise harm categories and add shared content inclusion Updated harm categories section to include shared content details. * Update protected material detection filter documentation Removed detailed explanations of protected material detection filters and replaced them with a reference to shared content overview. * Update content filter severity levels documentation Replaced the harm categories section with a reference to content harms. * Create region availability overview for AACS and Guardrails Added a comprehensive overview of region availability for AACS and Guardrails, including service limits and language availability. * Document input limits for Azure AI Content Safety APIs Added input limits for various Azure AI Content Safety APIs, including character limits and file size restrictions. * Modify Groundedness availability in region tables Updated the Groundedness guardrail availability across various regions. * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> * Update include paths for severity level documents * Update title and include path for protected material * Update title in protected materials overview * Update content-harms.md * Solve warnigns * fixed warnings * fix * update h1 * change h1 * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * region availability * region tabs update * added items * Modify metadata in region-availability.md Updated metadata for region availability document. --------- Co-authored-by: Megan Yetman <meyetman@microsoft.com> Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * Update Microsoft Foundry Notification Center overview (#14509) * Update Microsoft Foundry Notification Center overview with preview title and enhanced content * REmoved incorrect preview flag * Update articles/foundry/concepts/concept-notification-center.md Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> --------- Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com> * Document Python 1.19 framework updates * Address authoring feedback * Document deep research tool retirement Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Update deep-research.md * Update articles/foundry/agents/how-to/isolate-sessions-per-user.md Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * Update articles/foundry/agents/how-to/isolate-sessions-per-user.md Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * Update articles/foundry/agents/how-to/deploy-hosted-agent-code.md Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * Document latest Python workflow fixes * Rerun documentation validation * Address authoring feedback * Apply final authoring suggestion * Fix custom avatar creation instructions for current Foundry UX (#14492) * Fix custom avatar creation instructions for current Foundry UX * Clarify avatar consent and add step-by-step Foundry screenshots * Address authoring feedback while preserving avatar training requirements * Remove added avatar screenshots and their references * Document recent Agent Framework Python changes * Address authoring feedback * Restore PowerFx package name * Update luna training date * Add deprecation notice for Azure Machine Learning data labeling service (#14417) * Add deprecation notice for Azure Machine Learning data labeling service * Reformat deprecation notice for Azure Machine Learning data labeling service * Refine deprecation notice for Azure Machine Learning data labeling service for clarity and consistency * Add deprecation notice for Azure Machine Learning data labeling service across multiple articles * Update versions for new launch date * update o4-mini support dev-tier training, update FW models * MAI-image-2.6: update rate limits and other features * add responsible AI for image section * add limit of multipart images * Add info w/ costs of using web search tool in RAPI * Update articles/foundry/openai/includes/how-to-web-search-content.md Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> * Update wording from review * Update publication dates and enhance prerequisites clarity for high availability and resiliency documentation * Added error troubleshooting doc (#14479) * Added error troubleshooting doc * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> * Corrected links * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> * Update articles/foundry/openai/how-to/troubleshoot-errors.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> --------- Co-authored-by: Soham Patel <sohampatel@microsoft.com> Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com> Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * Refresh C# search tutorial screenshot (#14528) Update the overview image for the MUI design system introduced by Azure-Samples/azure-search-static-web-app#45 and improve its accessibility description. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify deployment mode descriptions and remove redundant phrases in high availability documentation * update agent optimization doc structure (#14480) * update faos doc structure * update structure * address comments * Update MCP server documentation with new deployment details and clarify authentication options * Update tutorial with revised SharePoint integration details and correct publication date * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> * rm tbds * Add PTU and PP regions for new models * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com> * add voice option in "choose what to build" * change table link * add voice-agent row * rm comment blocks * feature rename * add channels doc to toc; remove duplicate toc entry * rename toc * move toc entry * js qs initial commit * Add supported models and MCP/Foundry Skill section * Remove model from PP and PTU for launch * claude new model launch (#14547) * claude new model launch * update links * Add PP regions * Revert "Add PP regions" This reverts commit dc45bfcc91911f01378962496d7193757feb2f75. * long context support available for GPT 5.6* models (#14098) * long context support available for GPT 5.6* models * Apply suggestion from @msakande * Apply suggestion from @msakande * Apply suggestion from @v-dirichards --------- Co-authored-by: Diana Richards <103777760+v-dirichards@users.noreply.github.com> * Initial plan * Update Foundry Hosted Agents and SDK overview docs for July/August 2026 update Co-authored-by: sdgilley <3650506+sdgilley@users.noreply.github.com> * Remove regions for gpt-6-sol and luna for launch * Apply batched suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> * Apply suggestion from @learn-build-service-prod-06[bot] Co-authored-by: learn-build-service-prod-06[bot] <274430002+learn-build-service-prod-06[bot]@users.noreply.github.com> * align js qs with sample code * Update all_turns info for GPT reasoning models * update portal instructions * add js to configure how-to * Update codex cli for gpt-6-sol and luna models * use zone pivots * clarify sdk * Add evaluation latency and cost extraction example (#14419) * Add evaluation latency and cost extraction example Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 603ec028-28b6-40fb-b553-e…
Update content-filters.md (#14294) * Update content-filters.md * Add files via upload
[BULK cpcli] Rebrand Microsoft 365 Copilot to Microsoft Copilot MAXADO-12279337 (#14344) * [BULK cpcli] Rebrand Microsoft 365 Copilot to Microsoft Copilot MAXADO-12279337 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 4829db76-3855-456d-a4c0-9931bdb6e163 * Apply suggestions from code review LAAA Suggestions Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Jason Howell <5067358+JasonWHowell@users.noreply.github.com> Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Copilot-Session: 4829db76-3855-456d-a4c0-9931bdb6e163
Merge remote-tracking branch 'upstream/main' into alvinashcraft/main-aoai-models-sept14
Merge remote-tracking branch 'upstream/main' into alvinashcraft/main-aoai-models-sept14
Document deep research tool retirement Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
adding include files (#14134) * adding include files * Update prompt-shield-attack-info.md * Create content-harms.md for AI content safety Added detailed documentation on content harms and severity levels for Azure AI Content Safety, including categories and guardrail configurations. * Add overview for protected material detection filter This document provides an overview of the protected material detection filter, including its functionality, troubleshooting tips, and limitations. * Update protected-material.md to include overview Removed detailed explanation of protected material detection APIs and next steps. * Document harm categories and severity levels Added section on harm categories and severity levels for content safety. * Revise harm categories and add shared content inclusion Updated harm categories section to include shared content details. * Update protected material detection filter documentation Removed detailed explanations of protected material detection filters and replaced them with a reference to shared content overview. * Update content filter severity levels documentation Replaced the harm categories section with a reference to content harms. * Create region availability overview for AACS and Guardrails Added a comprehensive overview of region availability for AACS and Guardrails, including service limits and language availability. * Document input limits for Azure AI Content Safety APIs Added input limits for various Azure AI Content Safety APIs, including character limits and file size restrictions. * Modify Groundedness availability in region tables Updated the Groundedness guardrail availability across various regions. * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> * Update include paths for severity level documents * Update title and include path for protected material * Update title in protected materials overview * Update content-harms.md * Solve warnigns * fixed warnings * fix * update h1 * change h1 * Apply batched suggestions from code review Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com> * region availability * region tabs update * added items * Modify metadata in region-availability.md Updated metadata for region availability document. --------- Co-authored-by: Megan Yetman <meyetman@microsoft.com> Co-authored-by: learn-build-service-prod-10[bot] <274431553+learn-build-service-prod-10[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-09[bot] <274431102+learn-build-service-prod-09[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-03[bot] <274428581+learn-build-service-prod-03[bot]@users.noreply.github.com> Co-authored-by: learn-build-service-prod-05[bot] <274429479+learn-build-service-prod-05[bot]@users.noreply.github.com>