dotnet-microsoft-agent-framework: consolidate Azure AI Foundry agent type docs after upstream page merge

[Copilot]

Upstream Microsoft Learn consolidated three separate Azure AI Foundry agent type pages into a single "Microsoft Foundry Agents" page — all three URLs now return the same ETag (2ybUScSLcWfSiT1m1vzpEfDdOyw=).

Skill changes

• New references/official-docs/user-guide/agents/agent-types/microsoft-foundry-agents.md — consolidated reference covering all three modes in one file:

  • Persistent Azure AI Foundry Agents (PersistentAgentsClient, service-managed threads)
  • Foundry Models via Chat Completions (chatClient.AsAIAgent(...))
  • Foundry Models via Responses (responseClient.AsAIAgent(...))
  • C# and Python examples, plus a comparison table (thread ownership, hosted tools, portability)

• Deleted the three now-orphaned files:

  • azure-ai-foundry-agent.md
  • azure-ai-foundry-models-chat-completion-agent.md
  • azure-ai-foundry-models-responses-agent.md

• Updated official-docs-index.md — 3 entries → 1, page count 102 → 100

• Updated providers.md — source pages list reflects the consolidated file

• Updated index.md (agent types index) — both C# and Python tables collapsed to single Foundry row

• Fixed anthropic-agent.md — Next Steps link pointed to a deleted file

• Bumped SKILL.md version 1.4.0 → 1.5.0

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:

• ai-engineer.in
  • 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)
• 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)

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

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Upstream update: learn.microsoft.comagent-framework/user-guide/agents/agent-types/azure-ai-foundry-models-chat-completion-agent documentation documentation changed</issue_title>
<issue_description>Automation detected an upstream change for learn.microsoft.comagent-framework/user-guide/agents/agent-types/azure-ai-foundry-models-chat-completion-agent documentation.

• Watch id: agent-framework-docs-user-guide-agents-agent-types-azure-ai-foundry-models-chat-completion-agent
• Kind: http_document
• Source: https://learn.microsoft.com/agent-framework/user-guide/agents/agent-types/azure-ai-foundry-models-chat-completion-agent
• Current value: "2ybUScSLcWfSiT1m1vzpEfDdOyw="
• Previous value: "Hg02rJsHk+4js49tZV2ihVVwges="

Observed detail:

• Microsoft Foundry Agents | Microsoft Learn | ETag "2ybUScSLcWfSiT1m1vzpEfDdOyw="

Why this matters:

• Review the linked skills when https://learn.microsoft.com/agent-framework/user-guide/agents/agent-types/azure-ai-foundry-models-chat-completion-agent changes.

Likely skills to review:

• dotnet-microsoft-agent-framework

Suggested follow-up:

• Review the upstream release notes or documentation diff
• Update the affected files under skills/
• Update README.md if framework coverage or guidance changed
• Close this issue after the catalog has been refreshed

<agent_instructions>Review all tasks and if needed make jsut one pr an done branch with all updates for skills and docs </agent_instructions>

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

• Fixes Upstream update: learn.microsoft.comagent-framework/user-guide/agents/agent-types/azure-ai-foundry-models-chat-completion-agent documentation documentation changed #10

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull request overview

Consolidates the Azure AI Foundry agent type reference docs in the dotnet-microsoft-agent-framework skill to match upstream Microsoft Learn’s merged “Microsoft Foundry Agents” page, removing the now-redundant per-mode pages and updating indexes/links accordingly.

Changes:

• Added a consolidated microsoft-foundry-agents.md covering persistent Foundry Agents + Foundry Models via Chat Completions and Responses (C# + Python).
• Removed the three superseded Azure AI Foundry agent-type pages and updated agent-type tables/Next Steps links to point to the consolidated page.
• Updated reference indexes/provider lists and bumped skill version to 1.5.0.

Reviewed changes

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

Show a summary per file

File	Description
skills/dotnet-microsoft-agent-framework/references/providers.md	Repoints source list entry to the consolidated Foundry agents page.
skills/dotnet-microsoft-agent-framework/references/official-docs/user-guide/agents/agent-types/microsoft-foundry-agents.md	New consolidated agent-type reference page (persistent + Chat Completions + Responses).
skills/dotnet-microsoft-agent-framework/references/official-docs/user-guide/agents/agent-types/index.md	Collapses agent-type tables to a single “Microsoft Foundry Agents” entry.
skills/dotnet-microsoft-agent-framework/references/official-docs/user-guide/agents/agent-types/azure-ai-foundry-models-responses-agent.md	Deleted (superseded by consolidated page).
skills/dotnet-microsoft-agent-framework/references/official-docs/user-guide/agents/agent-types/azure-ai-foundry-models-chat-completion-agent.md	Deleted (superseded by consolidated page).
skills/dotnet-microsoft-agent-framework/references/official-docs/user-guide/agents/agent-types/azure-ai-foundry-agent.md	Deleted (superseded by consolidated page).
skills/dotnet-microsoft-agent-framework/references/official-docs/user-guide/agents/agent-types/anthropic-agent.md	Fixes Next Steps link to point to the consolidated Foundry agents page.
skills/dotnet-microsoft-agent-framework/references/official-docs-index.md	Updates mirrored page count and replaces 3 entries with 1 consolidated entry.
skills/dotnet-microsoft-agent-framework/SKILL.md	Bumps skill version to 1.5.0.

---

You can also share your feedback on Copilot code review. Take the survey.