int-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).
microsoft · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add microsoft/skills-for-copilot-studio --skill int-patterns技能说明
user-invocable: false name: int-patterns description: "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)." context: fork
Copilot Studio Pattern Library
Only read the pattern file relevant to the current task — do NOT read all files.
How to use patterns
Patterns are recommendations, not requirements. How you present them depends on your role:
If you are the Advisor agent:
- Present each pattern as a suggestion — explain the challenge it solves and why it's relevant
- Use status-appropriate language:
proven: "This is a proven pattern used in production — consider it for…"recommended: "A recommended approach that works well — consider it for…"experimental: "This is an experimental approach, not yet fully validated — you may want to test thoroughly before adopting"
- Always say "you could consider…" or "a common approach is…", never "you must…"
- Let the user decide — do NOT auto-apply patterns without confirmation
If you are the Author agent:
- When implementing a pattern the user or Advisor has already chosen, read the relevant pattern file for the correct YAML structure
- Do NOT suggest patterns yourself — that is the Advisor's role
- Use the YAML examples as reference for the correct kinds, fields, and structure
Pattern Index
JIT Glossary → jit-glossary.md
Loads customer-specific acronyms into a global variable on first message so the orchestrator can expand them before searching knowledge sources.
Read this pattern when:
- The user wants to add a glossary, acronym list, or terminology table
- Knowledge search quality is poor because the agent doesn't understand internal abbreviations
- The user asks about loading CSV/text data into a variable at conversation start
JIT User Context → jit-user-context.md
Loads the current user's M365 profile (country, department) into global variables for personalized answers.
Read this pattern when:
- The user wants country-aware, department-aware, or role-aware answers
- The agent needs to call the M365 Users connector
- The user asks about personalizing responses based on who is chatting
Dynamic Topic Redirect → dynamic-topic-redirect.md
Uses a Switch expression inside a BeginDialog node to route to different topics based on a variable.
Read this pattern when:
- The user needs to route to one of several topics based on a variable
- The user wants to replace nested ConditionGroup nodes with a cleaner approach
- The user asks about dynamic topic redirects or Switch expressions
Prevent Child Agent Responses → prevent-child-agent-responses.md
Stops child agents from messaging users directly by instructing them to use output variables.
Read this pattern when:
- The user wants a child agent to return data without messaging the user
- The user is confused about the completion setting on a child agent
- The parent agent needs to control all user-facing responses
Date Context → date-context.md
Injects the current date into agent instructions using Power Fx for accurate date-relative responses.
Read this pattern when:
- Users ask date-relative questions ("What's next week?", "upcoming events")
- The agent handles schedules, calendars, deadlines, or time-sensitive content
- Date interpretation is causing confusion or hallucinations
Orchestrator-Generated Variables → orchestrator-variables.md
Uses AutomaticTaskInput to classify or extract structured data from the user's message at orchestration time — zero extra cost or latency.
Read this pattern when:
- The user needs to route knowledge searches by category
- The user wants to extract a classification without asking the user or using an AI Prompt
- Knowledge search quality suffers because all sources are searched indiscriminately
Prevent Tool Call Leaks → prevent-tool-call-leaks.md
Stops the orchestrator from leaking internal reasoning and tool call metadata to the end user.
Read this pattern when:
- Users report seeing raw JSON in agent responses
- The agent has connector actions that the orchestrator invokes indirectly
- Responses contain
explanation_of_tool_callor similar internal metadata
Channel-Aware Behavior → channel-aware-behavior.md
Detects the host channel from System.Activity.ChannelId and gates behavior per surface (Teams, M365 Copilot, web chat, Direct Line, voice).
Read this pattern when:
- A feature works on one channel but breaks on another (file upload, Adaptive Card variants, hyperlinks)
- The user asks to detect Teams vs. M365 Copilot vs. web vs. voice
- A naive
=Lower(ChannelId) = "msteams"check is silently failing formsteams:Copilotor other compound channel IDs
RAI Error Handling → rai-error-handling.md
Classifies Azure OpenAI content-filter errors by subcode in the OnError topic and returns category-specific user messages with telemetry. Azure OpenAI models only — does not work with Anthropic or xAI models.
Read this pattern when:
- The u