Partager via


ICM MCP

ICM MCP permet aux agents MCS internes Microsoft d’interagir avec les tickets ICM. Il prend en charge les outils MCP standard, la liste et les outils/appels et outils allant des détails de l’incident à la modification et au transfert

Ce connecteur est disponible dans les produits et régions suivants :

Service Classe Régions
Copilot Studio Norme Toutes les régions Power Automate à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Apps Norme Toutes les régions Power Apps à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Norme Toutes les régions Power Automate à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Agent365 Microsoft.com
URL support Microsoft Power Automate
support Microsoft Power Apps
Courrier électronique robsanto@microsoft.com
Métadonnées du connecteur
Éditeur Microsoft
Website https://eng.ms/docs/products/icm/onboarding/introduction
Politique de confidentialité https://privacy.microsoft.com/en-US/privacystatement
Catégories IA; Productivité

Connecteur d’outils MCP ICM

Aperçu

Le connecteur Outils MCP ICM permet d’accéder au système ICM (Gestion des incidents) de Microsoft via l’interface MCP (Model Context Protocol). Ce connecteur permet à Power Automate et Power Apps d’interagir avec ICM pour la gestion des incidents à l’aide d’outils basés sur l’IA et de fonctionnalités d’analyse complète des incidents.

Ce connecteur fournit un accès direct au serveur MCP, ce qui vous permet de tirer parti d’un ensemble croissant d’outils de gestion des incidents puissants.

Prerequisites

  • Informations d’identification d’entreprise Microsoft valides
  • Accès au système ICM
  • Autorisations appropriées pour les opérations que vous souhaitez effectuer

Authentification

Le connecteur utilise l’authentification OAuth 2.0 avec Azure Active Directory. Lorsque vous créez une connexion, vous êtes invité à vous connecter avec vos informations d’identification d’entreprise Microsoft.

Opérations disponibles

Appeler le serveur MCP

Le connecteur fournit une opération unique et puissante qui vous donne accès à tous les outils MCP :

  • Appeler le serveur MCP : accès direct au serveur MCP avec prise en charge et tools/listtools/call méthodes

Outils MCP disponibles

Le connecteur prend actuellement en charge les outils suivants (cette liste continuera de croître) :

Analyse des incidents

  • get_incident_details_by_id - Récupérer des informations détaillées sur un incident spécifique
  • get_incident_context - Obtenir des informations contextuelles et des données associées pour un incident
  • get_incident_location - Obtenir des informations d’emplacement pour un incident
  • get_incident_customer_impact - Analyser l’impact du client sur un incident
  • get_similar_incidents - Rechercher des incidents similaires pour l’analyse des modèles
  • get_ai_summary - Obtenir un résumé généré par l’IA des informations sur les incidents
  • get_mitigation_hints - Obtenir des stratégies d’atténuation suggérées

Analyse de l’impact du client

  • get_impacted_s500_customers - Obtenir la liste des clients S500 impactés
  • get_impacted_ace_customers - Obtenir la liste des clients ACE impactés
  • get_impacted_azure_priority0_customers - Obtenir la liste des clients Azure Priority 0 impactés
  • get_impacted_subscription_count - Obtenir le nombre d’abonnements affectés
  • is_specific_customer_impacted - Vérifier si un client spécifique est affecté

Service et infrastructure

  • get_impacted_services_regions_clouds - Obtenir des informations sur les services, régions et clouds impactés
  • get_services_by_names - Récupérer des informations de service par noms
  • get_outage_high_priority_events - Obtenir des événements de panne de haute priorité

Gestion des équipes et des contacts

  • get_teams_by_public_id - Rechercher des équipes par leur ID public
  • get_teams_by_name - Rechercher des équipes par nom
  • get_team_by_id - Obtenir des informations d’équipe par ID
  • get_contact_by_alias - Obtenir des informations de contact par alias
  • get_contact_by_id - Obtenir les informations de contact par ID
  • get_on_call_schedule_by_team_id - Obtenir la planification des appels pour une équipe

Recherche et requêtes

  • search_incidents_by_owning_team_id - Rechercher des incidents en propriétaire de l’équipe
  • get_support_requests_crisit - Obtenir des demandes de support critiques

Guide pratique pour utiliser le connecteur

1. Répertorier les outils disponibles

Pour afficher tous les outils disponibles, utilisez la tools/list méthode :

Demande :

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "params": {},
  "id": 1
}

Réponse :

{
  "jsonrpc": "2.0",
  "result": {
    "tools": [
      {
        "name": "get_incident_details_by_id",
        "description": "Get detailed information about an incident by its ID",
        "inputSchema": {
          "type": "object",
          "properties": {
            "incident_id": {
              "type": "string",
              "description": "The unique identifier of the incident"
            }
          },
          "required": ["incident_id"]
        }
      },
      {
        "name": "get_incident_context",
        "description": "Get contextual information for an incident",
        "inputSchema": {
          "type": "object",
          "properties": {
            "incident_id": {
              "type": "string",
              "description": "The unique identifier of the incident"
            }
          },
          "required": ["incident_id"]
        }
      }
    ]
  },
  "id": 1
}

2. Appeler des outils spécifiques

Pour appeler un outil spécifique, utilisez la tools/call méthode :

Exemple : Obtenir les détails de l’incident

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_incident_details_by_id",
    "arguments": {
      "incident_id": "12345678"
    }
  },
  "id": 1
}

Réponse :

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"id\": \"12345678\", \"title\": \"Service degradation in West US\", \"severity\": \"Sev2\", \"status\": \"Active\", \"createDate\": \"2024-01-15T10:30:00Z\", \"description\": \"Users experiencing slow response times\", \"owningTeam\": \"ServiceTeam\", \"impactedServices\": [\"WebApp\", \"API\"]}"
      }
    ]
  },
  "id": 1
}

Exemple : Obtenir l’analyse de l’impact du client

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_impacted_s500_customers",
    "arguments": {
      "incident_id": "12345678"
    }
  },
  "id": 1
}

Exemple : Rechercher des incidents par équipe

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_incidents_by_owning_team_id",
    "arguments": {
      "team_id": "team-123",
      "status": "Active",
      "max_results": 50
    }
  },
  "id": 1
}

Exemple : Obtenir un résumé de l’IA

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_ai_summary",
    "arguments": {
      "incident_id": "12345678",
      "include_mitigation": true
    }
  },
  "id": 1
}

Utilisation de Power Automate

Configuration de l’action

  1. Ajoutez l’action « Appeler le serveur MCP » à votre flux
  2. Définissez le champ de méthode sur :
    • tools/list - pour découvrir les outils disponibles
    • tools/call - pour exécuter un outil spécifique
  3. Configurer l’objet params en fonction de la méthode choisie

Exemple de flux : Analyse automatisée des incidents

1. Trigger: When an incident is created
2. Action: Invoke MCP Server
   - method: "tools/call"
   - params: {
       "name": "get_incident_details_by_id",
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
3. Action: Invoke MCP Server  
   - method: "tools/call"
   - params: {
       "name": "get_ai_summary", 
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
4. Action: Send notification with incident details and AI summary

Exemple de flux : Évaluation de l’impact du client

1. Trigger: Manual trigger with incident ID
2. Action: Invoke MCP Server (Get S500 Customers)
   - method: "tools/call"
   - params: {
       "name": "get_impacted_s500_customers",
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
3. Action: Invoke MCP Server (Get ACE Customers)
   - method: "tools/call" 
   - params: {
       "name": "get_impacted_ace_customers",
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
4. Action: Create comprehensive impact report

Cas d’usage courants

1. Analyse complète des incidents

Combinez plusieurs outils pour obtenir une image complète :

  • get_incident_details_by_id - Informations de base sur les incidents
  • get_incident_context - Contexte et données connexes
  • get_ai_summary - Analyse basée sur l’IA
  • get_similar_incidents - Modèles historiques
  • get_mitigation_hints - Actions suggérées

2. Évaluation de l’impact du client

Évaluez l’étendue complète de l’impact du client :

  • get_impacted_s500_customers - Clients d’entreprise
  • get_impacted_ace_customers - Clients ACE
  • get_impacted_azure_priority0_customers - Priorité 0 clients
  • get_impacted_subscription_count - Impact total de l’abonnement

3. Coordination de l’équipe

Coordonner les efforts de réponse entre les équipes :

  • get_teams_by_name - Rechercher des équipes pertinentes
  • get_on_call_schedule_by_team_id - Vérifier qui est à l’appel
  • get_contact_by_alias - Obtenir des informations de contact
  • search_incidents_by_owning_team_id - Vérifier la charge de travail de l’équipe

4. Surveillance de l’intégrité du service

Surveillez et analysez l’intégrité du service :

  • get_impacted_services_regions_clouds - Infrastructure affectée
  • get_outage_high_priority_events - Événements critiques
  • get_services_by_names - Détails du service

Détails techniques

Flux de demande/réponse

  1. Power Automate envoie JSON-RPC demande mise en forme au connecteur
  2. Le connecteur transfère la demande au serveur MCP avec une authentification appropriée
  3. Le serveur MCP traite la requête et retourne JSON-RPC réponse
  4. Le connecteur gère les événements Server-Sent (SSE) s’ils sont présents et convertis en JSON
  5. La réponse est retournée à Power Automate au format JSON standard

Gestion des erreurs

Le connecteur gère différents scénarios d’erreur :

  • Noms d’outils non valides
  • Arguments obligatoires manquants
  • Échecs d’authentification
  • Indisponibilité du serveur

Limites de débit

Le connecteur implémente la limitation du débit de 100 appels par période de 60 secondes par connexion pour garantir une utilisation équitable du système ICM.

Utilisation avancée

Découverte d’outils dynamiques

Utilisez tools/list au début de vos flux pour découvrir dynamiquement les outils disponibles et leurs schémas. Cela garantit que vos flux fonctionnent même lorsque de nouveaux outils sont ajoutés.

Flux de travail complexes

Chaînez plusieurs appels d’outils pour créer des workflows de gestion des incidents sophistiqués qui tirent parti de la puissance totale de l’écosystème MCP.

Essai

Test rapide : Outils de liste

  1. Créer un flux avec l’action « Appeler le serveur MCP »
  2. Définir la méthode sur tools/list
  3. Laissez les paramètres vides : {}
  4. Exécuter le flux pour afficher tous les outils disponibles

Test : Obtenir les détails de l’incident

  1. Utiliser la méthode tools/call
  2. Définissez les paramètres sur :
    {
      "name": "get_incident_details_by_id",
      "arguments": {
        "incident_id": "your-test-incident-id"
      }
    }
    
  3. Vérifier que la réponse contient des informations sur l’incident

Ensemble d’outils de croissance

L’écosystème des outils MCP est en constante expansion. De nouveaux outils sont régulièrement ajoutés pour améliorer les fonctionnalités de gestion des incidents. Utilisez la tools/list méthode pour rester à jour sur les nouveaux outils disponibles et leurs fonctionnalités.

Support

  • Pour les problèmes liés au connecteur : Contactez l’équipe Power Platform
  • Pour les questions spécifiques à ICM : Contacter icmsupport@microsoft.com
  • Pour obtenir une prise en charge générale de Power Platform : visitez la communauté Microsoft Power Platform

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Fournir toutes les informations de contexte détaillées

Fournissez toutes les informations de contexte détaillées, toutes les métadonnées d’origine pour l’incident et la panne

Fournir un impact global pour l’incident spécifié

Fournir un impact global sur l’incident ou la panne spécifiés.

ICM MCP

Appel direct des opérations de serveur MCP ICM

Obtenir des demandes de support et des tickets de support (SRs) et SevA (CritSit)

Obtenez des demandes de support/tickets de support (SRs) et SevA (CritSit) liés à un incident/panne donné.

Obtenir des indicateurs d’atténuation pour un ID d’incident donné

Obtenez des indicateurs d’atténuation pour un ID d’incident donné.

Obtenir des informations sur l’emplacement de l’incident

Obtenez des informations d’emplacement sur l’incident et/ou la panne, notamment la région, la zone de disponibilité, le centre de données, le cluster, le nœud et l’alias arm de région.

Obtenir la liste des incidents similaires

Obtenez la liste des incidents similaires pour un ID d’incident donné.

Obtenir la planification des appels pour une équipe

Obtenez la planification des appels pour une équipe par ID d’équipe.

Obtenir le nombre d’abonnements affectés

Obtenez le nombre d’abonnements affectés pour un incident ou une panne donné.

Obtenir le résumé des incidents et des pannes

Obtenez un résumé des incidents et/ou des pannes et uniquement pour le résumé.

Obtenir les clients ACE affectés

Obtenez les clients ACE affectés pour un incident ou une panne donnés.

Obtenir les clients S500 impactés

Obtenez les clients S500 affectés pour un incident ou une panne donnés.

Obtenir les clients « Azure Priority 0 » ou « Vie et sécurité » affectés

Obtenez les clients « Azure Priority 0 » ou « Life and Safety » pour un incident ou une panne donné.

Obtenir les coordonnées par alias de contact

Obtenez les coordonnées par alias de contact.

Obtenir les coordonnées par ID de contact

Obtenez les coordonnées par ID de contact.

Obtenir les détails de l’incident par ID

Obtenez les détails de l’incident par ID.

Obtenir les détails de l’équipe par ID d’équipe

Obtenez les détails de l’équipe par ID d’équipe.

Obtenir les détails de l’équipe par ID public d’équipe

Obtenir les détails de l’équipe par ID public d’équipe. L’ID public ressemble à TenantName\TeamName

Obtenir les détails de l’équipe par nom d’équipe

Obtenez les détails de l’équipe par nom d’équipe.

Obtenir les détails des services par liste de noms

Obtenez les détails des services par liste de noms.

Obtenir les services, régions et clouds affectés

Obtenez les services, régions et clouds affectés pour un incident ou une panne donné.

Obtenir les événements haute priorité impactés

Obtenez les événements haute priorité affectés pour un incident ou une panne donné.

Rechercher des incidents en propriétaire de l’ID de l’équipe

Cet outil recherche les incidents en propriétaire de l’ID de l’équipe.

Vérifier si un client spécifique est affecté

Vérifiez si un client spécifique figure dans la liste des clients concerné par l’ID d’incident/panne. Remarque : Même si le résultat est faux, cela ne signifie pas que le client n’est pas affecté. Demandez à l’utilisateur de vérifier d’autres métriques d’impact telles que les demandes de support, sev A (CritSit) etc.

Fournir toutes les informations de contexte détaillées

Fournissez toutes les informations de contexte détaillées, toutes les métadonnées d’origine pour l’incident et la panne

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Fournir un impact global pour l’incident spécifié

Fournir un impact global sur l’incident ou la panne spécifiés.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

ICM MCP

Appel direct des opérations de serveur MCP ICM

Obtenir des demandes de support et des tickets de support (SRs) et SevA (CritSit)

Obtenez des demandes de support/tickets de support (SRs) et SevA (CritSit) liés à un incident/panne donné.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir des indicateurs d’atténuation pour un ID d’incident donné

Obtenez des indicateurs d’atténuation pour un ID d’incident donné.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir des informations sur l’emplacement de l’incident

Obtenez des informations d’emplacement sur l’incident et/ou la panne, notamment la région, la zone de disponibilité, le centre de données, le cluster, le nœud et l’alias arm de région.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir la liste des incidents similaires

Obtenez la liste des incidents similaires pour un ID d’incident donné.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir la planification des appels pour une équipe

Obtenez la planification des appels pour une équipe par ID d’équipe.

Paramètres

Nom Clé Obligatoire Type Description
teamIds
teamIds True string

ID d’équipe

Obtenir le nombre d’abonnements affectés

Obtenez le nombre d’abonnements affectés pour un incident ou une panne donné.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir le résumé des incidents et des pannes

Obtenez un résumé des incidents et/ou des pannes et uniquement pour le résumé.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir les clients ACE affectés

Obtenez les clients ACE affectés pour un incident ou une panne donnés.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir les clients S500 impactés

Obtenez les clients S500 affectés pour un incident ou une panne donnés.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir les clients « Azure Priority 0 » ou « Vie et sécurité » affectés

Obtenez les clients « Azure Priority 0 » ou « Life and Safety » pour un incident ou une panne donné.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir les coordonnées par alias de contact

Obtenez les coordonnées par alias de contact.

Paramètres

Nom Clé Obligatoire Type Description
alias
alias True string

Alias de contact

Obtenir les coordonnées par ID de contact

Obtenez les coordonnées par ID de contact.

Paramètres

Nom Clé Obligatoire Type Description
contactId
contactId True string

ID de contact

Obtenir les détails de l’incident par ID

Obtenez les détails de l’incident par ID.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir les détails de l’équipe par ID d’équipe

Obtenez les détails de l’équipe par ID d’équipe.

Paramètres

Nom Clé Obligatoire Type Description
teamId
teamId True string

ID d’équipe

Obtenir les détails de l’équipe par ID public d’équipe

Obtenir les détails de l’équipe par ID public d’équipe. L’ID public ressemble à TenantName\TeamName

Paramètres

Nom Clé Obligatoire Type Description
publicId
publicId True string

ID public de l’équipe

Obtenir les détails de l’équipe par nom d’équipe

Obtenez les détails de l’équipe par nom d’équipe.

Paramètres

Nom Clé Obligatoire Type Description
teamName
teamName True string

Nom de l’équipe

Obtenir les détails des services par liste de noms

Obtenez les détails des services par liste de noms.

Paramètres

Nom Clé Obligatoire Type Description
noms
names True string

Noms de service

Obtenir les services, régions et clouds affectés

Obtenez les services, régions et clouds affectés pour un incident ou une panne donné.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Obtenir les événements haute priorité impactés

Obtenez les événements haute priorité affectés pour un incident ou une panne donné.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

Rechercher des incidents en propriétaire de l’ID de l’équipe

Cet outil recherche les incidents en propriétaire de l’ID de l’équipe.

Paramètres

Nom Clé Obligatoire Type Description
teamId
teamId True string

ID d’équipe

Vérifier si un client spécifique est affecté

Vérifiez si un client spécifique figure dans la liste des clients concerné par l’ID d’incident/panne. Remarque : Même si le résultat est faux, cela ne signifie pas que le client n’est pas affecté. Demandez à l’utilisateur de vérifier d’autres métriques d’impact telles que les demandes de support, sev A (CritSit) etc.

Paramètres

Nom Clé Obligatoire Type Description
incidentId
incidentId True string

L’ID d’incident

customerName
customerName True string

Nom du client