Copilot Studio Gallery
ContributorsShare a sample
← Back to gallery

Agents + workflows

IT Service Desk Assistant

Sample agent that classifies IT support requests, guides employees through self-service troubleshooting for identity and connectivity issues, and drafts structured incident hand-offs. Includes a placeholder workflow definition with no live ticketing.

SPby Sapan PatelVersion 1.0.0.02 downloadsGitHub Release ZIP downloads across tracked versions since 2026-11-15. Last counted 2026-11-16T17:47:50.584Z. Includes direct downloads, repeats, and automation; not installations. As of 2026-11-16T17:47:50.584Z.Updated 2026-11-13Rate & discuss

This community example is provided as-is and is not covered by Microsoft Support. The underlying Copilot Studio and Power Platform products retain their standard support. Importing can create or modify resources and use your connections and permissions. Support details

Download ZIP
What’s in the solution
  • 1 workflow
  • 1 agent
  • 1 MCP server
  • 1 tool
  • 3 skills

Workflow preview

Triage and resolve IT support incidents

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
IT & securityit-supporthelpdeskservice-desktroubleshootingtriageself-serviceincident-management

Sample Disclaimer: This solution is an architectural reference sample and template provided for demonstration, evaluation, and community learning. It is not a production-ready IT service desk service. The diagnostic playbooks, identity recovery procedures, and escalation templates are illustrative examples that require organizational security review, policy validation, and integration with approved enterprise endpoints before any production deployment.

An intelligent Copilot Studio agent and workflow solution sample that demonstrates front-line IT helpdesk triage patterns, interactive diagnostic playbooks, routine employee self-service guidance (identity, password resets, VPN, software licensing), and structured incident escalation formatting.

Overview

Frontline IT support teams spend over 40% of their time collecting basic diagnostics and addressing repetitive requests such as password resets, VPN connection failures, and software entitlement requests.

The IT Service Desk Assistant demonstrates a pattern for 24/7 first-contact support across Microsoft Teams, Microsoft 365 Copilot, and web portals. When an employee reports an issue, the agent classifies the request using standard ITIL categories, guides the user through common self-service troubleshooting steps, and—if the issue requires human escalation—packages a structured incident hand-off with urgency ratings and diagnostic logs.

Download sample IT incident catalog (CSV)

Key Capabilities

  • Conversational Classification & Intent Detection: The agent identifies category and urgency across Access & Identity, Network & Connectivity, Software & Licensing, and Hardware & Endpoints.
  • Guided Self-Service Troubleshooting (conversational):
    • Account & Identity: Step-by-step guidance for Entra ID / Active Directory self-service password reset (SSPR) portals, MFA re-registration, and account lockout verification.
    • VPN & Network: Step-by-step connectivity troubleshooting (DNS flushing, certificate validation, split tunneling checks).
    • Software Provisioning: Guided software catalog lookups, entitlement criteria validation, and self-service portal links.
  • Structured Incident Escalation:
    • Gathers reproduction steps, error codes, device OS, and impact severity (P1 Critical through P4 Low).
    • Formats an engineer-ready escalation payload for Dataverse, ServiceNow, Jira Service Management, or Zendesk.
  • Instruction-Level Credential Guidance: Prompts users not to share plain-text passwords or secret tokens during troubleshooting sessions. Note that automatic programmatic text/chat redaction of chat history or incident payloads is not provided by this template; organizations requiring automatic redaction should configure Microsoft Purview Sensitive Information Types (SIT) or tenant-level Data Loss Prevention (DLP) rules.

Agent Skills & Tools

The agent includes dedicated inline skills and tool definitions:

  • identity-access-resolver (Skill): Guided playbooks for account lockout recovery, password resets, and MFA re-registration.
  • vpn-network-diagnostics (Skill): Step-by-step guidance for VPN tunnel drops, gateway checks, and DNS resolution issues.
  • incident-escalation-formatter (Skill): Structures troubleshooting history and system errors into prioritized P1–P4 escalation records.
  • ITKnowledgeBaseMCP (Tool): Configured for Dataverse-backed knowledge base search (shared_commondataserviceforapps / InvokeMCP).
  • DispatchITSMTicket (Tool): Configured for incident dispatch to ITSM queues (shared_itsm / CreateIncident).

How It Works

  1. Intake & Trigger: The employee describes an IT problem in natural language via Teams or web chat.
  2. Triage & Classification: The agent parses the request, determines the domain, and evaluates whether a known self-service resolution path exists.
  3. Knowledge Guidance: References common IT operating procedures and troubleshooting steps.
  4. Interactive Troubleshooting: If self-service is possible, walks the user through diagnostic steps with clear confirmation gates.
  5. Human Escalation: If self-service fails or high urgency is detected, formats a prioritized IT ticket payload for manual submission or for a ticketing tool you bind in your tenant.

Conceptual Workflow Canvas

The solution includes a visual workflow canvas titled Triage and resolve IT support incidents (it-service-desk-triage-workflow).

Note on Workflow Implementation (placeholder logic): solution/Workflows/workflow.json contains two parts:

  • Canvas graph (trigger.metadata.associatedData.graph): a conceptual visual preview of the triage and escalation flow.
  • Executable definition: a nonfunctional placeholder included only so the export is structurally complete. Its HTTP trigger captures the request and a single Response action returns 501 NotImplemented with isPlaceholder: true. It does not classify requests, search knowledge, create ITSM tickets, return ticket IDs, deliver playbooks, or send notifications.

To make the workflow functional, replace the placeholder Response with your own actions (for example, an ITSM CreateIncident connector call and a Dataverse knowledge search) or a Power Automate flow in your tenant. Classification and guided troubleshooting in this sample are performed conversationally by the agent and its skills, not by this workflow.

The canvas illustrates:

  • Intake: Conceptual entry point for employee requests.
  • Agent Analysis: Problem domain, impact, and urgency classification.
  • Knowledge Search: Querying resolution documentation.
  • Decision Branch: Evaluating self-service feasibility versus engineering escalation.
  • Dispatch: Packaging structured incident ticket records.
  • Notification: Providing ticket tracking references back to the employee.

Prerequisites & Required Connections

  • Environment: Power Platform environment with Microsoft Copilot Studio enabled.
  • Channels: Compatible with Microsoft Teams, Microsoft 365 Copilot, and Web Chat.
  • Required Connections & Permissions (if using tool actions):
    • ITSM Ticket Dispatch (DispatchITSMTicket): Binds to the ITSM connector (shared_itsm / CreateIncident) using authMode: Invoker. Invoking users must have an active connection to your ITSM endpoint (e.g., ServiceNow, Jira Service Management) with permissions to create incident tickets in target queues.
    • Knowledge Base MCP Tool (ITKnowledgeBaseMCP): Binds to Microsoft Dataverse (shared_commondataserviceforapps / InvokeMCP) using authMode: Invoker. Invoking users require Dataverse read permissions on knowledge tables and access to the corresponding MCP endpoint.
  • Running in Chat-Only / Standalone Mode: If external ITSM and Dataverse connections are not configured in your environment, the agent can be run without these tools enabled. In this mode, the agent operates as an interactive conversational troubleshooter, guiding users through diagnostic steps and presenting formatted incident summaries directly in the chat session for manual submission.

Supporting files

  • Sample IT incidents and diagnostic catalogCSV · 1,367 B

Agents and their components

The MCP servers, tools, and skills each agent uses, and which agents hand off to others. Hover a component for its description.

AgentMCP serversToolsSkills

IT Service Desk Assistant

Agent · Teams · Microsoft365Copilot

  • IT Knowledge Base MCP
  • Dispatch ITSM Ticket
  • identity-access-resolver
  • incident-escalation-formatter
  • vpn-network-diagnostics

Workflows and their components

Triggers, steps, connector services, and agent calls in each workflow.

WorkflowTriggerConnectorsAgents

Triage and resolve IT support incidents

7 steps

This export doesn't include the trigger type or some connector identities.

When an IT support request is submitted

Not included in this export
  • Classify domain & urgency

    Agent call

  • Execute guided self-service resolution

    Agent call

Exploded solution manifest

The download rebuilds these submitted files at the ZIP root. Gallery metadata and the human-facing README are excluded.

Solution
it_service_desk_assistant
Publisher
IT Support Solutions
Version
1.0.0.0
Files
17
component: 10bot: 2other: 2solution: 2workflow: 1
PathTypeSize
[Content_Types].xmlother941 B
Assets/botcomponent_connectionreferenceset.xmlother402 B
botcomponents/it_service_desk_assistant.skill.identity-access-resolver/botcomponent.xmlcomponent523 B
botcomponents/it_service_desk_assistant.skill.identity-access-resolver/datacomponent818 B
botcomponents/it_service_desk_assistant.skill.incident-escalation-formatter/botcomponent.xmlcomponent526 B
botcomponents/it_service_desk_assistant.skill.incident-escalation-formatter/datacomponent987 B
botcomponents/it_service_desk_assistant.skill.vpn-network-diagnostics/botcomponent.xmlcomponent529 B
botcomponents/it_service_desk_assistant.skill.vpn-network-diagnostics/datacomponent814 B
botcomponents/it_service_desk_assistant.tool.DispatchITSMTicket/botcomponent.xmlcomponent472 B
botcomponents/it_service_desk_assistant.tool.DispatchITSMTicket/datacomponent226 B
botcomponents/it_service_desk_assistant.tool.ITKnowledgeBaseMCP/botcomponent.xmlcomponent481 B
botcomponents/it_service_desk_assistant.tool.ITKnowledgeBaseMCP/datacomponent244 B
bots/it_service_desk_assistant/bot.xmlbot89 B
bots/it_service_desk_assistant/configuration.jsonbot1,606 B
customizations.xmlsolution230 B
solution.xmlsolution510 B
Workflows/workflow.jsonworkflow5,781 B

Rate & discuss

Found this solution useful? Give it a thumbs up, ask a question, or share what you built.

GitHub Discussions ↗

Sign in with GitHub to join the conversation. Your comments and reactions are public.

Loading discussion...

This community example is provided as-is and is not covered by Microsoft Support. The underlying Copilot Studio and Power Platform products retain their standard support. Importing can create or modify resources and use your connections and permissions. Support details

Download ZIP

Explore community-built apps, agents, and workflows before you install.

Third-party noticesView on GitHub