Compartilhar via

ICM MCP

O MCP do ICM permite que os Agentes MCS Internos da Microsoft interajam com tíquetes do ICM. Ele dá suporte a ferramentas/listas e ferramentas/chamadas e ferramentas padrão do MCP, desde detalhes de incidentes até edição e transferência

Esse conector está disponível nos seguintes produtos e regiões:

Service Classe Regions
Copilot Studio Standard Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Apps Standard Todas as regiões Power Apps exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Standard Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Agente365 Microsoft.com
URL suporte Power Automate < >c0>Microsoft
< suporte Power Apps >c0>Microsoft
Email robsanto@microsoft.com
Metadados do conector
Publicador Microsoft
Site https://eng.ms/docs/products/icm/onboarding/introduction
Política de privacidade https://privacy.microsoft.com/en-US/privacystatement
Categorias IA; Produtividade

Conector de Ferramentas do MCP do ICM

Visão geral

O conector de Ferramentas MCP do ICM fornece acesso ao sistema ICM (Gerenciamento de Incidentes) da Microsoft por meio da interface MCP (Model Context Protocol). Esse conector permite que o Power Automate e o Power Apps interajam com o ICM para gerenciamento de incidentes usando ferramentas de IA e recursos abrangentes de análise de incidentes.

Esse conector fornece acesso direto ao servidor MCP, permitindo que você aproveite um conjunto crescente de ferramentas avançadas de gerenciamento de incidentes.

Pré-requisitos

  • Credenciais corporativas válidas da Microsoft
  • Acesso ao sistema ICM
  • Permissões apropriadas para as operações que você deseja executar

Autenticação

O conector usa a autenticação OAuth 2.0 com o Azure Active Directory. Ao criar uma conexão, você será solicitado a entrar com suas credenciais corporativas da Microsoft.

Operações disponíveis

Invocar servidor MCP

O conector fornece uma única operação poderosa que fornece acesso a todas as ferramentas MCP:

  • Invocar o SERVIDOR MCP: acesso direto ao servidor MCP com suporte tools/list e tools/call métodos

Ferramentas MCP disponíveis

Atualmente, o conector dá suporte às seguintes ferramentas (essa lista continuará a crescer):

Análise de Incidentes

  • get_incident_details_by_id - Recuperar informações detalhadas sobre um incidente específico
  • get_incident_context – Obter informações contextuais e dados relacionados para um incidente
  • get_incident_location – Obter informações de localização para um incidente
  • get_incident_customer_impact – Analisar o impacto do cliente de um incidente
  • get_similar_incidents - Localizar incidentes semelhantes para análise de padrões
  • get_ai_summary – Obter um resumo gerado por IA das informações de incidentes
  • get_mitigation_hints – Obter estratégias de mitigação sugeridas

Análise de Impacto do Cliente

  • get_impacted_s500_customers – Obter lista de clientes do S500 afetados
  • get_impacted_ace_customers - Obter lista de clientes ace afetados
  • get_impacted_azure_priority0_customers – Obter lista de clientes afetados do Azure Priority 0
  • get_impacted_subscription_count – Obter contagem de assinaturas afetadas
  • is_specific_customer_impacted – Verificar se um cliente específico foi afetado

Serviço e infraestrutura

  • get_impacted_services_regions_clouds – Obter informações sobre serviços, regiões e nuvens afetados
  • get_services_by_names – Recuperar informações de serviço por nomes
  • get_outage_high_priority_events – Obter eventos de interrupção de alta prioridade

Gerenciamento de Equipe e Contato

  • get_teams_by_public_id - Localizar equipes por sua ID pública
  • get_teams_by_name - Localizar equipes por nome
  • get_team_by_id – Obter informações da equipe por ID
  • get_contact_by_alias – Obter informações de contato por alias
  • get_contact_by_id – Obter informações de contato por ID
  • get_on_call_schedule_by_team_id – Obter agendamento de chamada para uma equipe

Pesquisar e consultar

  • search_incidents_by_owning_team_id – Pesquisar incidentes por meio da equipe proprietária
  • get_support_requests_crisit – Obter solicitações de suporte críticas

Como usar o conector

1. Listar Ferramentas Disponíveis

Para ver todas as ferramentas disponíveis, use o tools/list método:

Solicitação:

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

Resposta:

{
  "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. Chamar ferramentas específicas

Para chamar uma ferramenta específica, use o tools/call método:

Exemplo: Obter detalhes do incidente

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

Resposta:

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

Exemplo: Obter análise de impacto do cliente

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

Exemplo: pesquisar incidentes por equipe

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

Exemplo: Obter resumo da IA

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

Uso do Power Automate

Configurando a ação

  1. Adicione a ação "Invocar Servidor MCP" ao seu fluxo
  2. Defina o campo do método como:
    • tools/list – para descobrir as ferramentas disponíveis
    • tools/call – para executar uma ferramenta específica
  3. Configurar o objeto params com base no método escolhido

Fluxo de exemplo: análise automatizada 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

Fluxo de exemplo: Avaliação de impacto do 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 comuns

1. Análise abrangente de incidentes

Combine várias ferramentas para obter uma imagem completa:

  • get_incident_details_by_id - Informações básicas sobre incidentes
  • get_incident_context - Contexto e dados relacionados
  • get_ai_summary – Análise de IA
  • get_similar_incidents - Padrões históricos
  • get_mitigation_hints - Ações sugeridas

2. Avaliação de impacto do cliente

Avalie o escopo completo do impacto do cliente:

  • get_impacted_s500_customers – Clientes corporativos
  • get_impacted_ace_customers – Clientes ace
  • get_impacted_azure_priority0_customers – Prioridade 0 clientes
  • get_impacted_subscription_count – Impacto total da assinatura

3. Coordenação de Equipe

Coordene os esforços de resposta entre as equipes:

  • get_teams_by_name - Localizar equipes relevantes
  • get_on_call_schedule_by_team_id - Verificar quem está de plantão
  • get_contact_by_alias – Obter informações de contato
  • search_incidents_by_owning_team_id - Verificar a carga de trabalho da equipe

4. Monitoramento de Integridade do Serviço

Monitorar e analisar a integridade do serviço:

  • get_impacted_services_regions_clouds - Infraestrutura afetada
  • get_outage_high_priority_events - Eventos críticos
  • get_services_by_names - Detalhes do serviço

Detalhes técnicos

Fluxo de solicitação/resposta

  1. O Power Automate envia JSON-RPC solicitação formatada para o conector
  2. O conector encaminha a solicitação para o servidor MCP com autenticação adequada
  3. O servidor MCP processa a solicitação e retorna JSON-RPC resposta
  4. O conector manipula eventos de Server-Sent (SSE) se estiverem presentes e convertidos em JSON
  5. A resposta é retornada ao Power Automate no formato JSON padrão

Tratamento de erros

O conector manipula vários cenários de erro:

  • Nomes de ferramentas inválidos
  • Argumentos necessários ausentes
  • Falhas de autenticação
  • Indisponibilidade do servidor

Limites de taxa

O conector implementa a limitação de taxa de 100 chamadas por período de 60 segundos por conexão para garantir o uso justo do sistema ICM.

Uso Avançado

Descoberta dinâmica de ferramentas

Use tools/list no início de seus fluxos para descobrir dinamicamente as ferramentas disponíveis e seus esquemas. Isso garante que seus fluxos funcionem mesmo quando novas ferramentas são adicionadas.

Fluxos de trabalho complexos

Encadear várias chamadas de ferramentas para criar fluxos de trabalho sofisticados de gerenciamento de incidentes que aproveitam todo o poder do ecossistema do MCP.

Testes

Teste Rápido: Listar Ferramentas

  1. Criar um novo fluxo com a ação "Invocar Servidor MCP"
  2. Definir o método como tools/list
  3. Deixe os parâmetros vazios: {}
  4. Executar o fluxo para ver todas as ferramentas disponíveis

Teste: Obter detalhes do incidente

  1. Usar método tools/call
  2. Defina os parâmetros como: 
    {
  "name": "get_incident_details_by_id",
  "arguments": {
    "incident_id": "your-test-incident-id"
  }
}
  3. Verificar se a resposta contém informações sobre incidentes

Conjunto de Ferramentas de Crescimento

O ecossistema de ferramentas do MCP está se expandindo continuamente. Novas ferramentas são adicionadas regularmente para aprimorar os recursos de gerenciamento de incidentes. Use o tools/list método para se manter atualizado sobre as ferramentas recém-disponíveis e suas funcionalidades.

Suporte

  • Para problemas de conector: contate a equipe do Power Platform
  • Para perguntas específicas do ICM: Contato icmsupport@microsoft.com
  • Para obter suporte geral do Power Platform: visite a Comunidade do Microsoft Power Platform

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Fornecer impacto geral para o incidente especificado

Forneça impacto geral para o incidente ou interrupção especificado.
Fornecer todas as informações de contexto detalhadas

Forneça todas as informações de contexto detalhadas, todos os metadados originais para o incidente e a interrupção
ICM MCP

Invocação direta de operações de servidor MCP do ICM
Obter a agenda de chamada para uma equipe

Obtenha a agenda de chamada para uma ID de equipe por equipe.
Obter a contagem de assinaturas afetada

Obtenha a contagem de assinaturas afetada para determinado incidente ou interrupção.
Obter clientes ACE afetados

Obtenha clientes ace afetados para determinado incidente ou interrupção.
Obter clientes afetados 'Azure Priority 0' ou 'Life and Safety'

Obtenha clientes afetados como "Prioridade do Azure 0" ou "Vida e Segurança" para determinado incidente ou interrupção.
Obter clientes do S500 afetados

Obter clientes S500 afetados para determinado incidente ou interrupção.
Obter detalhes da equipe pelo nome da equipe

Obtenha detalhes da equipe pelo nome da equipe.
Obter detalhes da equipe por ID da equipe

Obtenha detalhes da equipe por ID da equipe.
Obter detalhes da equipe por ID pública da equipe

Obter detalhes da equipe por ID pública da equipe. A ID pública se parece com TenantName\TeamName
Obter detalhes do contato por alias de contato

Obtenha detalhes do contato por alias de contato.
Obter detalhes do contato por ID de contato

Obtenha detalhes do contato por ID de contato.
Obter detalhes do incidente por id

Obter detalhes do incidente por ID.
Obter dicas de mitigação para uma determinada ID de incidente

Obtenha dicas de mitigação para uma determinada ID de incidente.
Obter eventos de alta prioridade afetados

Obtenha eventos de Alta Prioridade afetados para determinado incidente ou interrupção.
Obter informações de localização do incidente

Obtenha informações de localização do incidente e/ou interrupção, incluindo região, zona de disponibilidade, data center, cluster, nó e alias do braço da região.
Obter os detalhes dos serviços por lista de nomes

Obtenha os detalhes dos serviços por lista de nomes.
Obter resumo de incidentes e interrupções

Obtenha o resumo do incidente e/ou da interrupção e apenas para resumo.
Obter serviços, regiões e nuvens afetados

Obtenha serviços, regiões e nuvens afetados para determinado incidente ou interrupção.
Obter solicitações de suporte e Tíquetes de suporte (SRs) e SevA (CritSit)

Obtenha SRs (solicitações de suporte/tíquetes de suporte) e SevA (CritSit) vinculados a determinado incidente/interrupção.
Obter uma lista de incidentes semelhantes

Obtenha uma lista de incidentes semelhantes para uma determinada ID de incidente.
Pesquisar incidentes por meio da ID da equipe

Essa ferramenta pesquisa incidentes por meio da ID da equipe.
Verificar se um cliente específico é afetado

Verifique se um cliente específico está na lista de clientes afetados pela ID de incidente/interrupção. Observação: mesmo que o resultado seja falso, não significa que o cliente não seja afetado. Peça ao usuário para verificar outras métricas de impacto, como solicitações de suporte, Sev A (CritSit) etc.

Fornecer impacto geral para o incidente especificado

ID da operação:
GetIncidentCustomerImpact

Forneça impacto geral para o incidente ou interrupção especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Fornecer todas as informações de contexto detalhadas

ID da operação:
GetIncidentContext

Forneça todas as informações de contexto detalhadas, todos os metadados originais para o incidente e a interrupção

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

ICM MCP

ID da operação:
InvokeServer

Invocação direta de operações de servidor MCP do ICM

Obter a agenda de chamada para uma equipe

ID da operação:
GetOnCallScheduleByTeamId

Obtenha a agenda de chamada para uma ID de equipe por equipe.

Parâmetros

Nome Chave Obrigatório Tipo Description
teamIds
 teamIds True string

As IDs da equipe

Obter a contagem de assinaturas afetada

ID da operação:
GetImpactedSubscriptionCount

Obtenha a contagem de assinaturas afetada para determinado incidente ou interrupção.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter clientes ACE afetados

ID da operação:
GetImpactedAceCustomers

Obtenha clientes ace afetados para determinado incidente ou interrupção.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter clientes afetados 'Azure Priority 0' ou 'Life and Safety'

ID da operação:
GetImpactedAzurePriority0Customers

Obtenha clientes afetados como "Prioridade do Azure 0" ou "Vida e Segurança" para determinado incidente ou interrupção.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter clientes do S500 afetados

ID da operação:
GetImpactedS500Customers

Obter clientes S500 afetados para determinado incidente ou interrupção.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter detalhes da equipe pelo nome da equipe

ID da operação:
GetTeamsByName

Obtenha detalhes da equipe pelo nome da equipe.

Parâmetros

Nome Chave Obrigatório Tipo Description
teamName
 teamName True string

O nome da equipe

Obter detalhes da equipe por ID da equipe

ID da operação:
GetTeamById

Obtenha detalhes da equipe por ID da equipe.

Parâmetros

Nome Chave Obrigatório Tipo Description
teamId
 teamId True string

A ID da equipe

Obter detalhes da equipe por ID pública da equipe

ID da operação:
GetTeamsByPublicId

Obter detalhes da equipe por ID pública da equipe. A ID pública se parece com TenantName\TeamName

Parâmetros

Nome Chave Obrigatório Tipo Description
publicId
 publicId True string

A ID pública da equipe

Obter detalhes do contato por alias de contato

ID da operação:
GetContactByAlias

Obtenha detalhes do contato por alias de contato.

Parâmetros

Nome Chave Obrigatório Tipo Description
alias
 alias True string

O alias de contato

Obter detalhes do contato por ID de contato

ID da operação:
GetContactById

Obtenha detalhes do contato por ID de contato.

Parâmetros

Nome Chave Obrigatório Tipo Description
contactId
 contactId True string

A ID do contato

Obter detalhes do incidente por id

ID da operação:
GetIncidentDetailsById

Obter detalhes do incidente por ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter dicas de mitigação para uma determinada ID de incidente

ID da operação:
GetMitigationHints

Obtenha dicas de mitigação para uma determinada ID de incidente.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter eventos de alta prioridade afetados

ID da operação:
GetOutageHighPriorityEvents

Obtenha eventos de Alta Prioridade afetados para determinado incidente ou interrupção.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter informações de localização do incidente

ID da operação:
GetIncidentLocation

Obtenha informações de localização do incidente e/ou interrupção, incluindo região, zona de disponibilidade, data center, cluster, nó e alias do braço da região.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter os detalhes dos serviços por lista de nomes

ID da operação:
GetServicesByNames

Obtenha os detalhes dos serviços por lista de nomes.

Parâmetros

Nome Chave Obrigatório Tipo Description
names
 names True string

Os nomes de serviço

Obter resumo de incidentes e interrupções

ID da operação:
GetAiSummary

Obtenha o resumo do incidente e/ou da interrupção e apenas para resumo.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter serviços, regiões e nuvens afetados

ID da operação:
GetImpactedServicesRegionsClouds

Obtenha serviços, regiões e nuvens afetados para determinado incidente ou interrupção.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter solicitações de suporte e Tíquetes de suporte (SRs) e SevA (CritSit)

ID da operação:
GetSupportRequestsCrisit

Obtenha SRs (solicitações de suporte/tíquetes de suporte) e SevA (CritSit) vinculados a determinado incidente/interrupção.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Obter uma lista de incidentes semelhantes

ID da operação:
GetSimilarIncidents

Obtenha uma lista de incidentes semelhantes para uma determinada ID de incidente.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente

Pesquisar incidentes por meio da ID da equipe

ID da operação:
SearchIncidentsByOwningTeamId

Essa ferramenta pesquisa incidentes por meio da ID da equipe.

Parâmetros

Nome Chave Obrigatório Tipo Description
teamId
 teamId True string

A ID da equipe

Verificar se um cliente específico é afetado

ID da operação:
IsSpecificCustomerImpacted

Verifique se um cliente específico está na lista de clientes afetados pela ID de incidente/interrupção. Observação: mesmo que o resultado seja falso, não significa que o cliente não seja afetado. Peça ao usuário para verificar outras métricas de impacto, como solicitações de suporte, Sev A (CritSit) etc.

Parâmetros

Nome Chave Obrigatório Tipo Description
incidentId
 incidentId True string

A ID do incidente
nomeDoCliente
 customerName True string

O nome do cliente