Skip to content

.NET samples: revive structural alignment changes#6485

Open
alliscode wants to merge 8 commits into
microsoft:mainfrom
alliscode:revive/dotnet-samples-structure-v2
Open

.NET samples: revive structural alignment changes#6485
alliscode wants to merge 8 commits into
microsoft:mainfrom
alliscode:revive/dotnet-samples-structure-v2

Conversation

@alliscode

@alliscode alliscode commented Jun 11, 2026

Copy link
Copy Markdown
Member

This pull request primarily restructures and cleans up the agent samples documentation and removes some obsolete project files. The main focus is on improving organization and clarity for users getting started with the agent framework.

Documentation reorganization and cleanup:

  • The AgentProviders/README.md file has been deleted, consolidating provider-related documentation elsewhere and reducing redundancy.
  • The main samples README.md has been updated to reflect a new, clearer folder and documentation structure, with updated links and more descriptive sample categories.

Obsolete sample project removal:

  • Removed the Agent_Anthropic_Step03_UsingFunctionTools.csproj and Agent_OpenAI_Step06_CodeInterpreterFileDownload.csproj project files, likely because these samples have been reorganized or are no longer needed. [1] [2]

alliscode and others added 3 commits June 11, 2026 12:43
Rename all dotnet/samples/ subdirectories to use kebab-case naming
convention, matching the Python samples structure:

02-agents/:
  Agents→agents, AgentProviders→providers, AgentOpenTelemetry→observability,
  AgentSkills→skills, AgentWithAnthropic→anthropic,
  AgentWithMemory→context-providers, AgentWithOpenAI→openai,
  AgentWithRAG→rag, AgentsWithFoundry→foundry, DeclarativeAgents→declarative,
  ModelContextProtocol→mcp, AGUI→ag-ui, DevUI→devui, Evaluation→evaluation

03-workflows/:
  _StartHere→_start-here, Agents→agents, Checkpoint→checkpoint,
  Concurrent→parallelism, ConditionalEdges→control-flow (+ Loop merged in),
  Declarative→declarative, Evaluation→evaluation,
  HumanInTheLoop→human-in-the-loop, Observability→observability,
  Orchestration→orchestrations, Resources→resources,
  SharedStates→state-management, Visualization→visualization

04-hosting/:
  A2A→a2a, DurableAgents→durable-agents, DurableWorkflows→durable-workflows,
  FoundryHostedAgents→foundry-hosted-agents

05-end-to-end/:
  A2AClientServer→a2a-client-server, AGUIClientServer→ag-ui-client-server,
  AGUIWebChat→ag-ui-web-chat, AgentWebChat→agent-web-chat,
  AgentWithPurview→purview-agent, AspNetAgentAuthorization→aspnet-agent-authorization,
  DevUIAspireIntegration→devui-aspire-integration, Evaluation→evaluation,
  M365Agent→m365-agent

Updated .slnx, AGENTS.md, README.md, and all sample READMEs with new paths.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Reorganize providers to match Python's providers/ structure where samples
are grouped by provider (anthropic/, azure/, openai/, foundry/, etc.)
instead of flat Agent_With_* directories.

- Create provider subfolders: a2a, anthropic, azure, custom, foundry,
  github-copilot, google-gemini, ollama, onnx, openai
- Move Agent_With_* projects into respective provider subfolders
- Merge standalone anthropic/, openai/, foundry/ folders into providers/
- Fix ProjectReference paths (depth increased by 1)
- Update slnx, AGENTS.md, README.md files

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Point declarative workflow sample entry to InvokeHttpRequest\n- Add Hosted_Shared_Contributor_Setup under foundry-hosted-agents responses for restored project references\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings June 11, 2026 19:58

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

@moonbox3 moonbox3 added documentation Improvements or additions to documentation .NET workflows Related to Workflows in agent-framework labels Jun 11, 2026
@alliscode alliscode changed the title .NET samples: revive structural alignment changes .NET samples: structural alignment changes Jun 11, 2026
@github-actions github-actions Bot changed the title .NET samples: structural alignment changes .NET samples: revive structural alignment changes Jun 11, 2026
Remove the deprecated providers/azure/Agent_With_AzureAIAgentsPersistent sample and clean up solution and providers index references.\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Fix dotnet solution project path casing for InvokeHttpRequest on Linux\n- Repair markdown links broken by structure/casing changes across root, dotnet, samples, docs, and declarative workflow docs\n- Update durable-agents docs links to current durable-agents paths\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Use dotnet.microsoft.com/download URL variant that does not return 403 in CI link checks.\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Snapshot activities list before iterating to prevent 'Collection was modified'
errors when telemetry system concurrently adds activities during test execution.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Restore PascalCase sample folder names for the hosting samples and update the solution map accordingly.\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation .NET workflows Related to Workflows in agent-framework

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants