Delen via


ICM MCP

Met ICM MCP kunnen interne MCS-agents van Microsoft communiceren met ICM Tickets. Het ondersteunt standaard MCP-hulpprogramma's/lijsten en hulpprogramma's/aanroepen en hulpprogramma's, variërend van incidentdetails tot bewerken en overdragen

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst klasse Regions
Copilot Studio Standard Alle Power Automate regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Apps Standard Alle Power Apps regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Standard Alle Power Automate regio's behalve:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
contact opnemen met
Naam Agent365-Microsoft.com
URL Ondersteuning voor Microsoft Power Automate
Ondersteuning voor Microsoft Power Apps
E-mailadres robsanto@microsoft.com
Connectormetagegevens
Publisher Microsoft
Website https://eng.ms/docs/products/icm/onboarding/introduction
Privacybeleid https://privacy.microsoft.com/en-US/privacystatement
Categorieën AI; Productiviteit

ICM MCP Tools Connector

Overzicht

De ICM MCP Tools-connector biedt toegang tot het ICM-systeem (Incident Management) van Microsoft via de MCP-interface (Model Context Protocol). Met deze connector kunnen Power Automate en Power Apps communiceren met ICM voor incidentbeheer met behulp van ai-hulpprogramma's en uitgebreide mogelijkheden voor incidentanalyse.

Deze connector biedt directe toegang tot de MCP-server, zodat u een groeiende set krachtige hulpprogramma's voor incidentbeheer kunt gebruiken.

Vereiste voorwaarden

  • Geldige bedrijfsreferenties van Microsoft
  • Toegang tot het ICM-systeem
  • Juiste machtigingen voor de bewerkingen die u wilt uitvoeren

Authentication

De connector maakt gebruik van OAuth 2.0-verificatie met Azure Active Directory. Wanneer u een verbinding maakt, wordt u gevraagd u aan te melden met uw microsoft-bedrijfsreferenties.

Beschikbare bewerkingen

MCP-server aanroepen

De connector biedt één krachtige bewerking waarmee u toegang hebt tot alle MCP-hulpprogramma's:

  • MCP-server aanroepen: directe toegang tot de MCP-server met ondersteuning voor tools/list en tools/call methoden

Beschikbare MCP-hulpprogramma's

De connector ondersteunt momenteel de volgende hulpprogramma's (deze lijst blijft groeien):

Incidentanalyse

  • get_incident_details_by_id - Gedetailleerde informatie over een specifiek incident ophalen
  • get_incident_context - Contextuele informatie en gerelateerde gegevens voor een incident ophalen
  • get_incident_location - Locatiegegevens voor een incident ophalen
  • get_incident_customer_impact - Klantimpact van een incident analyseren
  • get_similar_incidents - Vergelijkbare incidenten zoeken voor patroonanalyse
  • get_ai_summary - Door AI gegenereerde samenvatting van incidentinformatie ophalen
  • get_mitigation_hints - Voorgestelde risicobeperkingsstrategieën ophalen

Analyse van klantimpact

  • get_impacted_s500_customers - Lijst met betrokken S500-klanten ophalen
  • get_impacted_ace_customers - Lijst met betrokken ACE-klanten ophalen
  • get_impacted_azure_priority0_customers - Lijst met betrokken Klanten met Azure Priority 0 ophalen
  • get_impacted_subscription_count - Het aantal betrokken abonnementen ophalen
  • is_specific_customer_impacted - Controleren of een specifieke klant wordt beïnvloed

Service en infrastructuur

  • get_impacted_services_regions_clouds - Informatie ophalen over betrokken services, regio's en clouds
  • get_services_by_names - Servicegegevens ophalen op namen
  • get_outage_high_priority_events - Storingsgebeurtenissen met hoge prioriteit ophalen

Team- en contactpersoonbeheer

  • get_teams_by_public_id - Teams zoeken op hun openbare id
  • get_teams_by_name - Teams zoeken op naam
  • get_team_by_id - Teamgegevens ophalen op id
  • get_contact_by_alias - Contactgegevens ophalen per alias
  • get_contact_by_id - Contactgegevens ophalen op id
  • get_on_call_schedule_by_team_id - Planning op oproep voor een team

Zoeken en query's

  • search_incidents_by_owning_team_id - Zoeken naar incidenten door het team te bezitten
  • get_support_requests_crisit - Kritieke ondersteuningsaanvragen ophalen

De connector gebruiken

1. Beschikbare hulpprogramma's weergeven

Als u alle beschikbare hulpprogramma's wilt zien, gebruikt u de tools/list methode:

Verzoek:

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

Antwoord:

{
  "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. Specifieke hulpmiddelen aanroepen

Als u een specifiek hulpprogramma wilt aanroepen, gebruikt u de tools/call methode:

Voorbeeld: Details van incident ophalen

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

Antwoord:

{
  "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
}

Voorbeeld: Klantimpactanalyse ophalen

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

Voorbeeld: Incidenten zoeken per team

{
  "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
}

Voorbeeld: AI-samenvatting ophalen

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

Power Automate-gebruik

De actie instellen

  1. Voeg de actie 'MCP-server aanroepen' toe aan uw stroom
  2. Stel het methodeveld in op een van de volgende opties:
    • tools/list - om beschikbare hulpprogramma's te detecteren
    • tools/call - om een specifiek hulpprogramma uit te voeren
  3. Het parameterobject configureren op basis van de gekozen methode

Voorbeeldstroom: Geautomatiseerde incidentanalyse

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

Voorbeeldstroom: Evaluatie van klantimpact

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

Veelvoorkomende gebruiksvoorbeelden

1. Uitgebreide incidentanalyse

Combineer meerdere hulpprogramma's om een volledig beeld te krijgen:

  • get_incident_details_by_id - Basisinformatie over incidenten
  • get_incident_context - Gerelateerde context en gegevens
  • get_ai_summary - Analyse op basis van AI
  • get_similar_incidents - Historische patronen
  • get_mitigation_hints - Voorgestelde acties

2. ImpactEvaluatie van klantimpact

Beoordeel het volledige bereik van de impact van de klant:

  • get_impacted_s500_customers - Enterprise-klanten
  • get_impacted_ace_customers - ACE-klanten
  • get_impacted_azure_priority0_customers - Klanten met prioriteit 0
  • get_impacted_subscription_count - Totale impact op het abonnement

3. Teamcoördinatie

Reactie-inspanningen coördineren in teams:

  • get_teams_by_name - Relevante teams zoeken
  • get_on_call_schedule_by_team_id - Controleren wie er bellen
  • get_contact_by_alias - Contactgegevens ophalen
  • search_incidents_by_owning_team_id - Teamworkload controleren

4. Service Health Monitoring

Servicestatus bewaken en analyseren:

  • get_impacted_services_regions_clouds - Betrokken infrastructuur
  • get_outage_high_priority_events - Kritieke gebeurtenissen
  • get_services_by_names - Servicedetails

Technische details

Aanvraag-/antwoordstroom

  1. Power Automate verzendt JSON-RPC opgemaakte aanvraag naar de connector
  2. De connector stuurt de aanvraag door naar de MCP-server met de juiste verificatie
  3. MCP-server verwerkt de aanvraag en retourneert JSON-RPC antwoord
  4. Connector verwerkt Server-Sent gebeurtenissen (SSE) indien aanwezig en converteert naar JSON
  5. Antwoord wordt geretourneerd naar Power Automate in standaard JSON-indeling

Foutafhandeling

De connector verwerkt verschillende foutscenario's:

  • Ongeldige namen van hulpprogramma's
  • Vereiste argumenten ontbreken
  • Authenticatiefouten
  • Server is niet beschikbaar

Frequentielimieten

De connector implementeert snelheidsbeperking van 100 aanroepen per periode van 60 seconden per verbinding om eerlijk gebruik van het ICM-systeem te garanderen.

Geavanceerd gebruik

Detectie van dynamische hulpprogramma's

Gebruik tools/list aan het begin van uw stromen om dynamisch beschikbare hulpprogramma's en hun schema's te detecteren. Dit zorgt ervoor dat uw stromen werken, zelfs wanneer er nieuwe hulpprogramma's worden toegevoegd.

Complexe werkstromen

Koppel meerdere hulpprogramma's aan elkaar om geavanceerde werkstromen voor incidentbeheer te maken die gebruikmaken van de volledige kracht van het MCP-ecosysteem.

Testing

Snelle test: Hulpmiddelen voor lijsten

  1. Een nieuwe stroom maken met de actie MCP-server aanroepen
  2. Methode instellen op tools/list
  3. Laat params leeg: {}
  4. Voer de stroom uit om alle beschikbare hulpprogramma's weer te geven

Test: Details van incident ophalen

  1. Methode gebruiken tools/call
  2. Parameters instellen op:
    {
      "name": "get_incident_details_by_id",
      "arguments": {
        "incident_id": "your-test-incident-id"
      }
    }
    
  3. Controleer of het antwoord incidentgegevens bevat

Groeiende hulpprogrammaset

Het MCP-hulpprogramma-ecosysteem wordt voortdurend uitgebreid. Er worden regelmatig nieuwe hulpprogramma's toegevoegd om de mogelijkheden voor incidentbeheer te verbeteren. Gebruik de methode om op de tools/list hoogte te blijven van nieuw beschikbare hulpprogramma's en hun mogelijkheden.

Support

  • Voor connectorproblemen: Neem contact op met het Power Platform-team
  • Voor ICM-specifieke vragen: Contact opnemen icmsupport@microsoft.com
  • Ga naar de Microsoft Power Platform-community voor algemene ondersteuning voor Power Platform

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Algemene impact bieden voor het opgegeven incident

Algemene impact bieden voor het opgegeven incident of de opgegeven storing.

Betrokken ACE-klanten krijgen

Get impacted ACE customers for given incident or outage.

Betrokken gebeurtenissen met hoge prioriteit ophalen

Krijg gevolgen voor gebeurtenissen met hoge prioriteit voor een bepaald incident of storing.

Betrokken klanten van Azure Priority 0 of 'Life and Safety' krijgen

Krijg gevolgen voor klanten van Azure Priority 0 of Life and Safety voor een bepaald incident of storing.

Betrokken S500-klanten krijgen

Krijg betrokken S500-klanten voor een bepaald incident of storing.

Betrokken services, regio's en clouds ophalen

Betrokken services, regio's en clouds ophalen voor een bepaald incident of storing.

Contactgegevens ophalen op contactpersoon-id

Contactgegevens ophalen op basis van contactpersoon-id.

Contactgegevens ophalen op contactpersoonalias

Contactgegevens ophalen op basis van de alias van de contactpersoon.

Controleren of een specifieke klant wordt beïnvloed

Controleer of een specifieke klant in de lijst met betrokken klanten staat op basis van de incident-/storings-id. Opmerking: Zelfs als het resultaat onwaar is, betekent dit niet dat de klant niet wordt beïnvloed. Vraag de gebruiker om andere impactgegevens te controleren, zoals ondersteuningsaanvragen, Sev A (CritSit) enzovoort.

De servicesgegevens ophalen op basis van een lijst met namen

De servicesgegevens ophalen op basis van een lijst met namen.

Een lijst met vergelijkbare incidenten ophalen

Haal een lijst met vergelijkbare incidenten op voor een bepaalde incident-id.

Geef alle gedetailleerde contextinformatie op

Geef alle gedetailleerde contextinformatie, alle oorspronkelijke metagegevens voor het incident en storing op

Get impacted subscription count

Get impacted subscription count for given incident or outage.

Het oproepschema voor een team ophalen

Haal het oproepschema voor een team op op team-id.

Hints voor risicobeperking ophalen voor een bepaalde incident-id

Oplossingen voor een bepaalde incident-id ophalen.

ICM MCP

Directe aanroep van ICM MCP-serverbewerkingen

Incidentdetails ophalen op id

Details van incidenten ophalen op id.

Incidenten doorzoeken door de id van het team te bezitten

Met dit hulpprogramma wordt gezocht naar incidenten door de team-id te bezitten.

Locatiegegevens van het incident ophalen

Locatiegegevens ophalen van het incident en/of de storing, waaronder regio, beschikbaarheidszone, datacenter, cluster, knooppunt en regio arm-alias.

Ondersteuningsaanvragen en ondersteuningstickets (SRs) en SevA (CritSit) ophalen

Ontvang ondersteuningsaanvragen/ondersteuningstickets (SR's) en SevA (CritSit) die zijn gekoppeld aan een bepaald incident/storing.

Samenvatting van incidenten en storingen ophalen

Samenvatting van incidenten en/of storingen ophalen en alleen voor samenvatting.

Teamgegevens ophalen op openbare team-id

Haal teamgegevens op op openbare team-id. Openbare id ziet eruit als TenantName\TeamName

Teamgegevens ophalen op team-id

Haal teamgegevens op per team-id.

Teamgegevens ophalen op teamnaam

Haal teamdetails op teamnaam op.

Algemene impact bieden voor het opgegeven incident

Algemene impact bieden voor het opgegeven incident of de opgegeven storing.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Betrokken ACE-klanten krijgen

Get impacted ACE customers for given incident or outage.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Betrokken gebeurtenissen met hoge prioriteit ophalen

Krijg gevolgen voor gebeurtenissen met hoge prioriteit voor een bepaald incident of storing.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Betrokken klanten van Azure Priority 0 of 'Life and Safety' krijgen

Krijg gevolgen voor klanten van Azure Priority 0 of Life and Safety voor een bepaald incident of storing.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Betrokken S500-klanten krijgen

Krijg betrokken S500-klanten voor een bepaald incident of storing.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Betrokken services, regio's en clouds ophalen

Betrokken services, regio's en clouds ophalen voor een bepaald incident of storing.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Contactgegevens ophalen op contactpersoon-id

Contactgegevens ophalen op basis van contactpersoon-id.

Parameters

Name Sleutel Vereist Type Description
contactId
contactId True string

De contactpersoon-id

Contactgegevens ophalen op contactpersoonalias

Contactgegevens ophalen op basis van de alias van de contactpersoon.

Parameters

Name Sleutel Vereist Type Description
alias
alias True string

De alias van de contactpersoon

Controleren of een specifieke klant wordt beïnvloed

Controleer of een specifieke klant in de lijst met betrokken klanten staat op basis van de incident-/storings-id. Opmerking: Zelfs als het resultaat onwaar is, betekent dit niet dat de klant niet wordt beïnvloed. Vraag de gebruiker om andere impactgegevens te controleren, zoals ondersteuningsaanvragen, Sev A (CritSit) enzovoort.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

klantnaam
customerName True string

De naam van de klant

De servicesgegevens ophalen op basis van een lijst met namen

De servicesgegevens ophalen op basis van een lijst met namen.

Parameters

Name Sleutel Vereist Type Description
names
names True string

De servicenamen

Een lijst met vergelijkbare incidenten ophalen

Haal een lijst met vergelijkbare incidenten op voor een bepaalde incident-id.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Geef alle gedetailleerde contextinformatie op

Geef alle gedetailleerde contextinformatie, alle oorspronkelijke metagegevens voor het incident en storing op

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Get impacted subscription count

Get impacted subscription count for given incident or outage.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Het oproepschema voor een team ophalen

Haal het oproepschema voor een team op op team-id.

Parameters

Name Sleutel Vereist Type Description
teamIds
teamIds True string

De team-id's

Hints voor risicobeperking ophalen voor een bepaalde incident-id

Oplossingen voor een bepaalde incident-id ophalen.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

ICM MCP

Directe aanroep van ICM MCP-serverbewerkingen

Incidentdetails ophalen op id

Details van incidenten ophalen op id.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Incidenten doorzoeken door de id van het team te bezitten

Met dit hulpprogramma wordt gezocht naar incidenten door de team-id te bezitten.

Parameters

Name Sleutel Vereist Type Description
teamId
teamId True string

De team-id

Locatiegegevens van het incident ophalen

Locatiegegevens ophalen van het incident en/of de storing, waaronder regio, beschikbaarheidszone, datacenter, cluster, knooppunt en regio arm-alias.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Ondersteuningsaanvragen en ondersteuningstickets (SRs) en SevA (CritSit) ophalen

Ontvang ondersteuningsaanvragen/ondersteuningstickets (SR's) en SevA (CritSit) die zijn gekoppeld aan een bepaald incident/storing.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Samenvatting van incidenten en storingen ophalen

Samenvatting van incidenten en/of storingen ophalen en alleen voor samenvatting.

Parameters

Name Sleutel Vereist Type Description
incidentId
incidentId True string

De incident-id

Teamgegevens ophalen op openbare team-id

Haal teamgegevens op op openbare team-id. Openbare id ziet eruit als TenantName\TeamName

Parameters

Name Sleutel Vereist Type Description
publicId
publicId True string

De openbare id van het team

Teamgegevens ophalen op team-id

Haal teamgegevens op per team-id.

Parameters

Name Sleutel Vereist Type Description
teamId
teamId True string

De team-id

Teamgegevens ophalen op teamnaam

Haal teamdetails op teamnaam op.

Parameters

Name Sleutel Vereist Type Description
teamNaam
teamName True string

De teamnaam