Compartir a través de


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/list métodos y tools/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

  1. Agregue la acción "Invocar servidor MCP" al flujo.
  2. Establezca el campo de método en:
    • tools/list : para detectar las herramientas disponibles
    • tools/call : para ejecutar una herramienta específica
  3. 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

  1. Power Automate envía JSON-RPC solicitud con formato al conector
  2. El conector reenvía la solicitud al servidor MCP con la autenticación adecuada
  3. El servidor MCP procesa la solicitud y devuelve JSON-RPC respuesta
  4. El conector controla Server-Sent eventos (SSE) si está presente y se convierte en JSON.
  5. 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

  1. Crear un nuevo flujo con la acción "Invocar servidor MCP"
  2. Establecer el método en tools/list
  3. Deje los parámetros vacíos: {}
  4. Ejecución del flujo para ver todas las herramientas disponibles

Prueba: Obtener detalles del incidente

  1. Usar método tools/call
  2. Establezca los parámetros en:
    {
      "name": "get_incident_details_by_id",
      "arguments": {
        "incident_id": "your-test-incident-id"
      }
    }
    
  3. 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 (CritSit)

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