Copilot Studio and Agents - repo structures and relationships

[cleemullins]

Problem Statement

Today there are numerous Copilot Studio, M365 Agents SDK and Bot Framework repos. The proliferation of repos has lead to obsolete samples, obsolete technologies, and obsolete documentation. The lack of clear repo ownership of repos also leads to Issues and PRs stagnating.

Search Engines are returning incorrect and obsolete results. Developers are unable to find what they're looking for or end up working with incorrect and obsolete technologies.

North Star

A set of quality GitHub Repos focused on the following:

• Copilot Studio Samples
• Agent M365 Agents Samples
• M365 Agents SDK Code
• Clear guidance around Issues and PRs.
• Interconnections and links between repos, so users can quickly navigate.
• Docs that explicitly mention pro-code scenarios

Proposed Organization

A Hub/Spoke model is proposed, as the Hub will be a starting point for finding content, hosting core specs and documentation, and hosting samples.

M365 Agents SDK

This is the top-level GitHub repo, and the focus of our pro code development. This repo hosts:

• Samples for M365 Agents SDK
• Samples & templates for Copilot Studio
• GitHub Pages / Docs focused on pro-code development.

Links from here go to:

• C# / JS / Python code repos.
• In a "Legacy" section in the readme, links to the Bot Framework SDK.

Update this repo's readme to have details around Pro Code Development for Copilot Studio. Extend the Github pages with these docs as well.

Bot Framework SDK Changes

The Bot Framework SDK get "Superseded by" messages along with links to the root M365 Agents Repo and specific language repo. Anyone who lands on these repos should be aware of the newer repos and tech stacks.

Copilot Studio Samples Repo

The following changes are suggested for (Copilot Studio Samples)[https://github.com/microsoft/CopilotStudioSamples]:

• Readme updated to point to the Agents SDK repo.
• A "Legacy" branch should be created.
• Obsolete and no-longer-relevant samples should be deleted from main. A link in the readme for "To see the legacy PVA samples, click here" could be added.
• The readme updated to point at the M365 Agents SDK.