ICM MCP
ICM MCP permite que los agentes de MCS internos de Microsoft interactúen con ICM Tickets. Admite herramientas, listas y herramientas de MCP estándar, herramientas y llamadas y herramientas que van desde detalles de incidentes hasta editar y transferir
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Agent365 Microsoft.com |
| URL |
Soporte técnico de Microsoft Power Automate compatibilidad con Microsoft Power Apps |
| Correo electrónico | robsanto@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://eng.ms/docs/products/icm/onboarding/introduction |
| Directiva de privacidad | https://privacy.microsoft.com/en-US/privacystatement |
| Categorías | IA; Productividad |
Conector de herramientas de MCP de ICM
Visión general
El conector de herramientas MCP de ICM proporciona acceso al sistema de administración de incidentes (ICM) de Microsoft a través de la interfaz del Protocolo de contexto de modelo (MCP). Este conector permite que Power Automate y Power Apps interactúen con ICM para la administración de incidentes mediante herramientas con tecnología de IA y funcionalidades completas de análisis de incidentes.
Este conector proporciona acceso directo al servidor MCP, lo que le permite aprovechar un conjunto creciente de eficaces herramientas de administración de incidentes.
Prerrequisitos
- Credenciales corporativas válidas de Microsoft
- Acceso al sistema ICM
- Permisos adecuados para las operaciones que desea realizar
Autenticación
El conector usa la autenticación de OAuth 2.0 con Azure Active Directory. Al crear una conexión, se le pedirá que inicie sesión con sus credenciales corporativas de Microsoft.
Operaciones disponibles
Invocar servidor MCP
El conector proporciona una única operación eficaz que proporciona acceso a todas las herramientas de MCP:
-
Invocar servidor MCP: acceso directo al servidor MCP con compatibilidad con
tools/listmétodos ytools/call
Herramientas de MCP disponibles
Actualmente, el conector admite las siguientes herramientas (esta lista seguirá creciendo):
Análisis de incidentes
-
get_incident_details_by_id- Recuperar información detallada sobre un incidente específico -
get_incident_context- Obtención de información contextual y datos relacionados para un incidente -
get_incident_location- Obtener información de ubicación para un incidente -
get_incident_customer_impact- Análisis del impacto del cliente de un incidente -
get_similar_incidents- Buscar incidentes similares para el análisis de patrones -
get_ai_summary- Obtención del resumen generado por ia de la información de incidentes -
get_mitigation_hints- Obtención de estrategias de mitigación sugeridas
Análisis de impacto en el cliente
-
get_impacted_s500_customers- Obtener la lista de clientes de S500 afectados -
get_impacted_ace_customers- Obtener la lista de clientes ace afectados -
get_impacted_azure_priority0_customers- Obtener la lista de clientes afectados de Prioridad 0 de Azure -
get_impacted_subscription_count- Obtención del recuento de suscripciones afectadas -
is_specific_customer_impacted- Comprobar si un cliente específico se ve afectado
Servicio e infraestructura
-
get_impacted_services_regions_clouds- Obtener información sobre los servicios, regiones y nubes afectados -
get_services_by_names- Recuperación de la información del servicio por nombres -
get_outage_high_priority_events- Obtención de eventos de interrupción de alta prioridad
Administración de equipos y contactos
-
get_teams_by_public_id- Buscar equipos por su identificador público -
get_teams_by_name- Buscar equipos por nombre -
get_team_by_id- Obtención de información del equipo por identificador -
get_contact_by_alias- Obtención de información de contacto por alias -
get_contact_by_id- Obtención de información de contacto por identificador -
get_on_call_schedule_by_team_id- Obtener programación de llamada para un equipo
Búsqueda y consultas
-
search_incidents_by_owning_team_id- Búsqueda de incidentes por parte del equipo propietario -
get_support_requests_crisit- Obtención de solicitudes de soporte técnico críticas
Uso del conector
1. Enumerar herramientas disponibles
Para ver todas las herramientas disponibles, use el tools/list método :
Solicitud:
{
"jsonrpc": "2.0",
"method": "tools/list",
"params": {},
"id": 1
}
Respuesta:
{
"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. Llamar a herramientas específicas
Para llamar a una herramienta específica, use el tools/call método :
Ejemplo: Obtener detalles del incidente
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_incident_details_by_id",
"arguments": {
"incident_id": "12345678"
}
},
"id": 1
}
Respuesta:
{
"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
}
Ejemplo: Obtención del análisis de impacto del cliente
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_impacted_s500_customers",
"arguments": {
"incident_id": "12345678"
}
},
"id": 1
}
Ejemplo: Buscar incidentes por equipo
{
"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
}
Ejemplo: Obtener resumen de IA
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_ai_summary",
"arguments": {
"incident_id": "12345678",
"include_mitigation": true
}
},
"id": 1
}
Uso de Power Automate
Configuración de la acción
- Agregue la acción "Invocar servidor MCP" al flujo.
- Establezca el campo de método en:
-
tools/list: para detectar las herramientas disponibles -
tools/call: para ejecutar una herramienta específica
-
- Configurar el objeto params en función del método elegido
Flujo de ejemplo: Análisis automatizado de incidentes
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
Flujo de ejemplo: Evaluación del impacto del cliente
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
Casos de uso comunes
1. Análisis completo de incidentes
Combine varias herramientas para obtener una imagen completa:
-
get_incident_details_by_id- Información básica sobre incidentes -
get_incident_context- Contexto y datos relacionados -
get_ai_summary- Análisis con tecnología de ia -
get_similar_incidents- Patrones históricos -
get_mitigation_hints- Acciones sugeridas
2. Evaluación del impacto en el cliente
Evalúe el ámbito completo del impacto del cliente:
-
get_impacted_s500_customers- Clientes empresariales -
get_impacted_ace_customers- Clientes ace -
get_impacted_azure_priority0_customers- Prioridad 0 clientes -
get_impacted_subscription_count- Impacto total de la suscripción
3. Coordinación del equipo
Coordinar los esfuerzos de respuesta entre los equipos:
-
get_teams_by_name- Búsqueda de equipos relevantes -
get_on_call_schedule_by_team_id- Comprobar quién está en la llamada -
get_contact_by_alias- Obtener información de contacto -
search_incidents_by_owning_team_id- Comprobación de la carga de trabajo del equipo
4. Supervisión del estado del servicio
Supervisión y análisis del estado del servicio:
-
get_impacted_services_regions_clouds- Infraestructura afectada -
get_outage_high_priority_events- Eventos críticos -
get_services_by_names- Detalles del servicio
Detalles técnicos
Flujo de solicitud/respuesta
- Power Automate envía JSON-RPC solicitud con formato al conector
- El conector reenvía la solicitud al servidor MCP con la autenticación adecuada
- El servidor MCP procesa la solicitud y devuelve JSON-RPC respuesta
- El conector controla Server-Sent eventos (SSE) si está presente y se convierte en JSON.
- La respuesta se devuelve a Power Automate en formato JSON estándar
Tratamiento de errores
El conector controla varios escenarios de error:
- Nombres de herramientas no válidos
- Faltan argumentos obligatorios
- Errores de autenticación
- No disponibilidad del servidor
Límites de velocidad
El conector implementa la limitación de velocidad de 100 llamadas por período de 60 segundos por conexión para garantizar un uso justo del sistema ICM.
Uso avanzado
Detección dinámica de herramientas
Use tools/list al principio de los flujos para detectar dinámicamente las herramientas disponibles y sus esquemas. Esto garantiza que los flujos funcionen incluso cuando se agreguen nuevas herramientas.
Flujos de trabajo complejos
Encadene varias llamadas a herramientas para crear flujos de trabajo sofisticados de administración de incidentes que aprovechen toda la eficacia del ecosistema de MCP.
Testing
Prueba rápida: Herramientas de lista
- Crear un nuevo flujo con la acción "Invocar servidor MCP"
- Establecer el método en
tools/list - Deje los parámetros vacíos:
{} - Ejecución del flujo para ver todas las herramientas disponibles
Prueba: Obtener detalles del incidente
- Usar método
tools/call - Establezca los parámetros en:
{ "name": "get_incident_details_by_id", "arguments": { "incident_id": "your-test-incident-id" } } - Comprobación de que la respuesta contiene información sobre incidentes
Conjunto de herramientas de crecimiento
El ecosistema de herramientas MCP se está expandiendo continuamente. Las nuevas herramientas se agregan periódicamente para mejorar las funcionalidades de administración de incidentes. Use el tools/list método para mantenerse actualizado en las herramientas recién disponibles y sus funcionalidades.
Apoyo
- Para problemas de conectores: póngase en contacto con el equipo de Power Platform.
- Para preguntas específicas de ICM: Póngase en contacto con icmsupport@microsoft.com
- Para obtener soporte técnico general de Power Platform: visite la comunidad de Microsoft Power Platform.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Buscar incidentes mediante el identificador del equipo propietario |
Esta herramienta busca incidentes mediante el identificador del equipo propietario. |
| Comprobar si un cliente específico se ve afectado |
Compruebe si un cliente específico está en la lista de clientes afectada por el identificador de incidente o interrupción. Nota: Aunque el resultado sea false, no significa que el cliente no se vea afectado. Pida al usuario que compruebe otras métricas de impacto, como solicitudes de soporte técnico, sev A (CritSit), etc. |
| ICM MCP |
Invocación directa de operaciones de servidor MCP de ICM |
| Obtención de clientes ace afectados |
Obtenga clientes ace afectados por un incidente o una interrupción dados. |
| Obtención de clientes afectados "Prioridad 0" o "Vida y seguridad" afectados |
Obtenga los clientes de "Prioridad 0" o "Vida y seguridad" afectados por un incidente o interrupción dados. |
| Obtención de clientes de S500 afectados |
Obtenga clientes de S500 afectados por un incidente o una interrupción dados. |
| Obtención de detalles del equipo por identificador de equipo |
Obtenga los detalles del equipo por identificador de equipo. |
| Obtención de detalles del equipo por identificador público del equipo |
Obtener los detalles del equipo por identificador público del equipo. El identificador público tiene el aspecto de TenantName\TeamName |
| Obtención de detalles del incidente por identificador |
Obtenga los detalles del incidente por identificador. |
| Obtención de eventos de prioridad alta afectados |
Obtenga eventos de prioridad alta afectados para un incidente o una interrupción dados. |
| Obtención de los detalles de contacto por alias de contacto |
Obtenga los detalles de contacto por alias de contacto. |
| Obtención de los detalles de los servicios por lista de nombres |
Obtenga los detalles de los servicios por lista de nombres. |
| Obtención de los detalles del equipo por nombre del equipo |
Obtenga los detalles del equipo por nombre del equipo. |
| Obtención de servicios, regiones y nubes afectados |
Obtenga servicios, regiones y nubes afectados para un incidente o interrupción determinados. |
|
Obtención de solicitudes de soporte técnico y incidencias de soporte técnico (SR) y SevA (Crit |
Obtenga solicitudes de soporte técnico o incidencias de soporte técnico (SR) y SevA (CritSit) vinculadas a incidentes o interrupciones dados. |
| Obtención de sugerencias de mitigación para un identificador de incidente determinado |
Obtenga sugerencias de mitigación para un identificador de incidente determinado. |
| Obtención del recuento de suscripciones afectados |
Obtenga el recuento de suscripciones afectado para un incidente o una interrupción dados. |
| Obtención del resumen de incidentes y interrupciones |
Obtenga el resumen de incidentes o interrupciones y solo para el resumen. |
| Obtener información de ubicación del incidente |
Obtenga información de ubicación del incidente o interrupción, incluida la región, la zona de disponibilidad, el centro de datos, el clúster, el nodo y el alias del brazo de región. |
| Obtener la programación de llamada para un equipo |
Obtenga la programación de llamada para un equipo por identificador de equipo. |
| Obtener los detalles de contacto por identificador de contacto |
Obtenga los detalles de contacto por identificador de contacto. |
| Obtener una lista de incidentes similares |
Obtenga una lista de incidentes similares para un identificador de incidente determinado. |
| Proporcionar toda la información de contexto detallada |
Proporcionar toda la información de contexto detallada, todos los metadatos originales para el incidente y la interrupción |
| Proporcionar un impacto general para el incidente especificado |
Proporcione un impacto general para el incidente o interrupción especificados. |
Buscar incidentes mediante el identificador del equipo propietario
Esta herramienta busca incidentes mediante el identificador del equipo propietario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
teamId
|
teamId | True | string |
Identificador del equipo |
Comprobar si un cliente específico se ve afectado
Compruebe si un cliente específico está en la lista de clientes afectada por el identificador de incidente o interrupción. Nota: Aunque el resultado sea false, no significa que el cliente no se vea afectado. Pida al usuario que compruebe otras métricas de impacto, como solicitudes de soporte técnico, sev A (CritSit), etc.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
|
nombreDelCliente
|
customerName | True | string |
El nombre del cliente |
ICM MCP
Invocación directa de operaciones de servidor MCP de ICM
Obtención de clientes ace afectados
Obtenga clientes ace afectados por un incidente o una interrupción dados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención de clientes afectados "Prioridad 0" o "Vida y seguridad" afectados
Obtenga los clientes de "Prioridad 0" o "Vida y seguridad" afectados por un incidente o interrupción dados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención de clientes de S500 afectados
Obtenga clientes de S500 afectados por un incidente o una interrupción dados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención de detalles del equipo por identificador de equipo
Obtenga los detalles del equipo por identificador de equipo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
teamId
|
teamId | True | string |
Identificador del equipo |
Obtención de detalles del equipo por identificador público del equipo
Obtener los detalles del equipo por identificador público del equipo. El identificador público tiene el aspecto de TenantName\TeamName
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
publicId
|
publicId | True | string |
Identificador público del equipo |
Obtención de detalles del incidente por identificador
Obtenga los detalles del incidente por identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención de eventos de prioridad alta afectados
Obtenga eventos de prioridad alta afectados para un incidente o una interrupción dados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención de los detalles de contacto por alias de contacto
Obtenga los detalles de contacto por alias de contacto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
alias
|
alias | True | string |
Alias de contacto |
Obtención de los detalles de los servicios por lista de nombres
Obtenga los detalles de los servicios por lista de nombres.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
names
|
names | True | string |
Nombres de servicio |
Obtención de los detalles del equipo por nombre del equipo
Obtenga los detalles del equipo por nombre del equipo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
teamName
|
teamName | True | string |
Nombre del equipo |
Obtención de servicios, regiones y nubes afectados
Obtenga servicios, regiones y nubes afectados para un incidente o interrupción determinados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención de solicitudes de soporte técnico y incidencias de soporte técnico (SR) y SevA (CritSit)
Obtenga solicitudes de soporte técnico o incidencias de soporte técnico (SR) y SevA (CritSit) vinculadas a incidentes o interrupciones dados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención de sugerencias de mitigación para un identificador de incidente determinado
Obtenga sugerencias de mitigación para un identificador de incidente determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención del recuento de suscripciones afectados
Obtenga el recuento de suscripciones afectado para un incidente o una interrupción dados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtención del resumen de incidentes y interrupciones
Obtenga el resumen de incidentes o interrupciones y solo para el resumen.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtener información de ubicación del incidente
Obtenga información de ubicación del incidente o interrupción, incluida la región, la zona de disponibilidad, el centro de datos, el clúster, el nodo y el alias del brazo de región.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Obtener la programación de llamada para un equipo
Obtenga la programación de llamada para un equipo por identificador de equipo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
teamIds
|
teamIds | True | string |
Identificadores de equipo |
Obtener los detalles de contacto por identificador de contacto
Obtenga los detalles de contacto por identificador de contacto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
contactId
|
contactId | True | string |
Identificador de contacto |
Obtener una lista de incidentes similares
Obtenga una lista de incidentes similares para un identificador de incidente determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Proporcionar toda la información de contexto detallada
Proporcionar toda la información de contexto detallada, todos los metadatos originales para el incidente y la interrupción
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |
Proporcionar un impacto general para el incidente especificado
Proporcione un impacto general para el incidente o interrupción especificados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
El identificador del incidente |