How microsoft/copilotstudiosamples works
Purpose and Entry Points
This is a multi-sample repository for Microsoft Copilot Studio, not one deployable application. It provides importable agent solutions, topic artifacts, integration code, UI embeds, infrastructure templates, and validation examples. Repository navigation is published as a Jekyll/GitHub Pages site via _config.yml and .github/workflows/pages.yml; the root README.md is the catalog entry point.
Copilot Studio Authoring Artifacts
Importable Power Platform/Copilot Studio solutions and reusable authoring snippets are the primary platform-facing assets. Solutions package bot definitions, topics, GPT configuration, connectors, and Dataverse actions; snippets provide smaller YAML/Adaptive Card patterns.
• authoring/solutions/account-contact-lookup/sourcecode/bots/copilots_header_cref7_LookupDataAgent/bot.xml
• authoring/solutions/resume-job-finder/sourcecode/bots/cref7_resumeJobMatchAssistant/bot.xml
• authoring/snippets/adaptive-cards/ConversationStart.json
Employee Self-Service Agent Domain
A pending-deprecation employee-service sample models conversational topics as topic.yaml plus XML actions for Workday and facilities systems. Runtime control begins with intent/topic selection, collects needed values, invokes an external action, and renders the result. Workday and WorkdayDA are parallel artifact sets; changes should generally preserve both variants.
• EmployeeSelfServiceAgent/Workday/EmployeeScenarios/EmployeeGetVacationBalance/topic.yaml
• EmployeeSelfServiceAgent/Workday/EmployeeScenarios/EmployeeGetVacationBalance/msdyn_HRWorkdayHCMEmployeeGetVacationBalance.xml
• EmployeeSelfServiceAgent/Facilities/EmployeeGetDiningMenu/topic.yaml
Extensibility and Agent-to-Agent Boundaries
Extensibility samples demonstrate services called by Copilot Studio rather than shared runtime infrastructure. MCP samples expose tool servers and OpenAPI custom connectors; A2A and Agents SDK samples host agent-compatible HTTP endpoints. The order-management sample is the clearest composed flow: chat UI → Copilot Studio agents/connectors → order or warehouse MCP server.
• extensibility/mcp/order-management-enhanced-tc/mcp-servers/order-management/src/server.ts
• extensibility/mcp/order-management-enhanced-tc/connectors/order-management/apiDefinition.swagger.json
• extensibility/a2a/Simple-A2A-Sample/Program.cs
Channel, UI, and Contact-Center Integration
These samples implement channel-specific boundaries around Copilot Studio/Direct Line: browser and hosted chat UIs authenticate users, obtain tokens, relay conversation traffic, and optionally hand off to live agents. Runtimes include Next.js/TypeScript, Node.js Azure Functions, and ASP.NET/C#; external systems include Direct Line, ServiceNow, Salesforce, SharePoint, Dynamics 365, and Genesys.
• ui/custom-ui/assistant-ui/assistant-ui-mcs/app/api/chat/route.ts
• contact-center/servicenow/DirectLineAzureFunction/src/functions/relayToDirectLine.js
• contact-center/skill-handoff/HandoverToLiveAgentSample/Program.cs
Identity and Deployment Boundaries
SSO examples cover Entra ID and Okta integrations, while infrastructure artifacts provision or configure networking and Power Platform billing workflows. Credentials, tenant/environment configuration, and network reachability are deployment concerns external to these samples.
• sso/entra-id/index.html
• ui/embed/d365-cs-okta/app.js
• infrastructure/vnet-support/template.json
Validation and Evaluation
Evaluation is a separate operational layer: test inputs drive authenticated Copilot/Agents SDK conversations, collect multi-turn responses, and can gate delivery pipelines. Load testing targets WebSocket conversation traffic.
• testing/functional/PytestAgentsSDK/testinglib/copilot_client.py
• testing/evaluation/EvalGateADO/scripts/eval-gate.mjs
• testing/load/JMeterMultiThreadGroup/Multi Group WebSocket.jmx
Main entry points: README.md Repository catalog · route.ts Assistant UI chat route · topic.yaml Vacation balance topic · bot.xml Lookup Data Agent
Components 20
Copilot Authoring
Importable solutions and reusable conversation artifacts.
- Copilot Studio · Platform hosting imported agents, topics, and connectors.
- Lookup Data Agent
authoring/solutions/account-contact-lookup/sourcecode/bots/copilots_header_cref7_LookupDataAgent/bot.xml - Resume Job Match Agent
authoring/solutions/resume-job-finder/sourcecode/bots/cref7_resumeJobMatchAssistant/bot.xml - Conversation-start card
authoring/snippets/adaptive-cards/ConversationStart.json
Employee Self-Service
Pending-deprecation topic and action samples.
- Vacation balance topic · Intent flow gathers values and renders the returned balance.
EmployeeSelfServiceAgent/Workday/EmployeeScenarios/EmployeeGetVacationBalance/topic.yaml - Workday vacation action · Parallel Workday and WorkdayDA artifacts should remain aligned.
EmployeeSelfServiceAgent/Workday/EmployeeScenarios/EmployeeGetVacationBalance/msdyn_HRWorkdayHCMEmployeeGetVacationBalance.xml - Dining menu topic
EmployeeSelfServiceAgent/Facilities/EmployeeGetDiningMenu/topic.yaml
Extensibility
Agent, connector, and MCP boundary samples.
- Order Management connector
extensibility/mcp/order-management-enhanced-tc/connectors/order-management/apiDefinition.swagger.json - Order Management MCP server · Provides order and warehouse tools to connected agents.
extensibility/mcp/order-management-enhanced-tc/mcp-servers/order-management/src/server.ts - Simple A2A endpoint · Hosts an agent-compatible HTTP boundary.
extensibility/a2a/Simple-A2A-Sample/Program.cs
Channels & Contact Center
UI, relay, and live-handoff integrations.
- Assistant UI chat route · Browser chat boundary for Copilot Studio conversations.
ui/custom-ui/assistant-ui/assistant-ui-mcs/app/api/chat/route.ts - Direct Line · Authenticated conversation transport between clients and agents.
- ServiceNow relay · Relays ServiceNow conversation traffic to Direct Line.
contact-center/servicenow/DirectLineAzureFunction/src/functions/relayToDirectLine.js - Live-agent handoff
contact-center/skill-handoff/HandoverToLiveAgentSample/Program.cs
Identity, Infrastructure & Validation
Deployment and quality-operating examples.
- SSO integrations · Identity configuration and credentials remain external deployment concerns.
sso/entra-id/index.html - VNet support template · Provisions networking support for Power Platform scenarios.
infrastructure/vnet-support/template.json - Authenticated conversation client · Drives Copilot or Agents SDK multi-turn conversations.
testing/functional/PytestAgentsSDK/testinglib/copilot_client.py - Evaluation gate · Collects evaluations and can gate delivery pipelines.
testing/evaluation/EvalGateADO/scripts/eval-gate.mjs - WebSocket load test · Targets concurrent conversation traffic.
testing/load/JMeterMultiThreadGroup/Multi Group WebSocket.jmx
Other components
- Repository catalog · README and GitHub Pages navigation expose the sample catalog.
README.md
Connections 21
- Repository catalog → Lookup Data Agent: catalogs
- Repository catalog → Resume Job Match Agent: catalogs
- Repository catalog → Assistant UI chat route: catalogs
- Lookup Data Agent → Copilot Studio: imports into
- Resume Job Match Agent → Copilot Studio: imports into
- Conversation-start card → Copilot Studio: reused by
- Vacation balance topic → Workday vacation action: invokes
- Vacation balance topic → Copilot Studio: runs in
- Dining menu topic → Copilot Studio: runs in
- Copilot Studio → Order Management connector: uses connector
- Order Management connector → Order Management MCP server: calls tools
- Copilot Studio → Simple A2A endpoint: calls agent endpoint
- Assistant UI chat route → Direct Line: sends chat
- ServiceNow relay → Direct Line: relays traffic
- Direct Line → Copilot Studio: connects conversations
- Direct Line → Live-agent handoff: can hand off
- SSO integrations → Assistant UI chat route: authenticates users
- VNet support template → Copilot Studio: supports network reachability
- Authenticated conversation client → Copilot Studio: drives conversations
- Evaluation gate → Authenticated conversation client: evaluates results
- WebSocket load test → Direct Line: loads WebSocket traffic