int-reference
Copilot Studio YAML Reference
Core File Types
| File | Purpose |
|---|---|
agent.mcs.yml |
Main agent metadata (kind: GptComponentMetadata) |
settings.mcs.yml |
Agent settings and configuration |
connectionreferences.mcs.yml |
Connector references |
topics/*.mcs.yml |
Conversation topics (kind: AdaptiveDialog) |
actions/*.mcs.yml |
Connector-based actions (kind: TaskDialog) |
knowledge/*.mcs.yml |
Knowledge sources (kind: KnowledgeSourceConfiguration) |
variables/*.mcs.yml |
Global variables (kind: GlobalVariableComponent) |
agents/*.mcs.yml |
Child agents (kind: AgentDialog) |
Trigger Types
Topics with OnRecognizedIntent have two routing mechanisms — which one matters depends on the orchestration mode:
More from microsoft/skills-for-copilot-studio
best-practices
Best practices for Copilot Studio agents. Covers JIT glossary loading (customer acronyms, terminology), JIT user context provisioning (M365 profile, country, department), the shared OnActivity initialization pattern, dynamic topic redirects with Switch expressions, and preventing child agents from responding directly to users. USE FOR: glossary, acronyms, user context, user profile, country-aware answers, JIT initialization, OnActivity provisioning, conversation-init, personalized knowledge, dynamic redirect, Switch, BeginDialog, if/then/else replacement, child agent responses, completion setting, SendMessageTool, output variables, connected agents. DO NOT USE FOR: general knowledge sources (use add-knowledge), topic creation (use new-topic).
24int-project-context
>
24patterns
Index of repeatable implementation patterns for Copilot Studio agents. When a request may need a best-practice architecture or reusable pattern for building an agent capability, retrieve this index before deciding what detailed guidance is relevant. Do not decide from this frontmatter alone; use the index summaries, then open only the specific pattern file if needed. Do not use for general knowledge sources or topic creation.
4authoring-tips
Index of practical authoring tips and workarounds for Copilot Studio agents. When a request may need best-practice guidance, an authoring technique, or a workaround for improving an agent's behavior, retrieve this index before deciding what detailed guidance is relevant. Do not decide from this frontmatter alone; use the index summaries, then open only the specific tip file if needed. Do not use for repeatable implementation patterns, general knowledge sources, or topic creation.
4_project-context
>
2int-patterns
Pattern library for Copilot Studio agent design. Contains proven and recommended implementation patterns with YAML examples. Used by the Advisor agent to suggest patterns and by the Author agent to reference YAML structure during implementation. USE FOR: design guidance, pattern suggestions, review against best practices, troubleshooting known pitfalls, YAML reference during implementation. DO NOT USE FOR: general YAML schema reference (use int-reference), topic creation mechanics (use new-topic).
1