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/listentools/callmethoden
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
- Voeg de actie 'MCP-server aanroepen' toe aan uw stroom
- 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
-
- 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
- Power Automate verzendt JSON-RPC opgemaakte aanvraag naar de connector
- De connector stuurt de aanvraag door naar de MCP-server met de juiste verificatie
- MCP-server verwerkt de aanvraag en retourneert JSON-RPC antwoord
- Connector verwerkt Server-Sent gebeurtenissen (SSE) indien aanwezig en converteert naar JSON
- 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
- Een nieuwe stroom maken met de actie MCP-server aanroepen
- Methode instellen op
tools/list - Laat params leeg:
{} - Voer de stroom uit om alle beschikbare hulpprogramma's weer te geven
Test: Details van incident ophalen
- Methode gebruiken
tools/call - Parameters instellen op:
{ "name": "get_incident_details_by_id", "arguments": { "incident_id": "your-test-incident-id" } } - 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 (Crit |
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 |