Casos de uso do Conector de IA

Oito conversas reais com o Conector de IA (MCP) sobre a saúde da rede — a pergunta para copiar, as ferramentas usadas e a resposta — para NOC, atendimento e gestão.

Casos de uso do Conector de IA

Antes de começar: configure o Conector de IA (MCP) no seu cliente de IA.
Permissões usadas: as suas — a IA só enxerga o que o seu usuário já pode ver.

Esta página mostra oito conversas reais, feitas com o Claude conectado ao Made4Graph. Cada caso traz quem costuma usar, a pergunta exata para copiar e colar, as ferramentas que a IA usou e um trecho fiel da resposta.

Todos os exemplos usam dados de demonstração (OLTs DEMO, clientes demo_…). Os números, nomes e datas são fictícios e servem só para mostrar o formato das respostas. Na sua rede, a IA responde com os seus dados. Listas longas foram encurtadas com ….

Ferramentas que a IA usa

Você não escolhe a ferramenta: a IA decide qual usar a partir da pergunta. Os nomes abaixo aparecem nos casos.

FerramentaNome técnicoPara quê
Saúde geral da redeget_network_healthNota composta, camadas e cobertura.
Lista de prioridadesget_priority_listO que atacar primeiro.
Incidentes de PONget_pon_incidentsQuedas coletivas ativas ou resolvidas.
Detalhe do incidente de PONget_pon_incident_detailQuem está dentro de um incidente.
Localizar assinanteresolve_subscriberAcha o cliente por nome, login ou documento.
Saúde do assinanteget_subscriber_healthEstado, caso aberto, cadeia e histórico de um assinante.
Tendência da saúdeget_health_trendA nota ao longo do tempo.
Resultados e funilget_results_funnelSe as regras geram ação real ou ruído.

1. Começar o dia: como está a rede?

Quem usa: NOC e técnicos de plantão.

Pergunta para copiar:

Como está a saúde da rede agora? Responda em português, objetivo, para o técnico do provedor.

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Saúde geral da rede (get_network_health).

Resposta da IA (resumida):

Rede em atenção, nota 82/100 (caiu 1 ponto em 24h). Dados de OLTs "DEMO".

  1. Fibra da rua é o gargalo (nota 48/100). 5 PONs com defeito ativo. Cada uma afeta várias casas ao mesmo tempo, então é planta e não problema de casa. Acione equipe externa, um chamado por PON:
    • Sul-02 gpon-0/3/1: 23 casas, aberta desde 24/09.
    • Sul-02 gpon-0/2/1: 18 casas, desde 28/09.
    • Centro-01 gpon-0/1/2: 18 casas, desde 28/09.
    • Sul-02 gpon-0/3/2: 17 casas, desde 29/09.
    • Centro-01 gpon-0/1/1: 8 casas, nova, começou hoje às 12h.
  2. Fila da equipe parada. 101 casos abertos, 16 críticos e 73 altos. 84 estão sem responsável, e todos são das PONs acima. Atribua tudo ao chamado de cada PON em vez de tratar caso a caso.
  3. Roteador do cliente: atenção moderada (nota 79/100). 16 com fibra chegando fraca na casa, 16 com temperatura alta e 12 com Wi-Fi fraco. …

Sem problema: conexão/sessão (99) e NAS (100) estão ok. Nenhum cliente estourando conexões (CGNAT).

Limite dos dados: só 75% dos clientes têm ONU vinculada. A leitura de fibra pode estar incompleta.

Veja o significado de cada número em Saúde (visão geral).

2. O que atacar primeiro

Quem usa: NOC e coordenação de campo.

Pergunta para copiar:

Saúde da rede do provedor: o que devo atacar primeiro hoje na rede? Me dê os 5 itens mais importantes com o motivo de cada um.

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Saúde geral da rede (get_network_health) e Lista de prioridades (get_priority_list, 5 itens).

Resposta da IA (resumida):

Saúde geral: atenção (nota 82/100). A parte que atende as casas (fibra/rua) está em 48, bem pior que o resto. Os 5 itens abaixo são todos defeito de rua. Cada um precisa de um chamado de equipe externa, não de visita casa a casa. Juntos eles cobrem 84 dos 101 casos abertos.

  1. Sul-02, porta gpon-0/3/1 (23 casas). Motivo: é a que afeta mais gente, e o problema está aberto desde 24/09, há mais de um mês. Ação: mande a equipe externa verificar cabo e caixa dessa rua.
  2. Sul-02, porta gpon-0/2/1 (18 casas). Motivo: aberta desde 28/09, com 6 casas já abaixo do limite de sinal. Ação: equipe externa. Aproveite a mesma OLT (Sul-02) para agrupar as visitas.
  3. Centro-01, porta gpon-0/1/2 (18 casas). Motivo: aberta desde 28/09, sem resolução. Ação: equipe externa. Confira também a emenda e o conector perto da OLT.
  4. Sul-02, porta gpon-0/3/2 (17 casas). Motivo: aberta desde 29/09, com 6 casas com sinal fraco. Ação: equipe externa. Ela fica na mesma OLT que os itens 1 e 2, então vale ver se há causa em comum no equipamento.
  5. Centro-01, porta gpon-0/1/1 (8 casas). Motivo: surgiu hoje às 12h, então ainda é fresca. Dos 7 clientes da porta, 4 estão com sinal baixo. Pegar agora evita que vire problema antigo como os outros. Ação: equipe externa. Pode ser algo recente, como um cabo mexido ou uma obra.

Dois pontos de atenção:

  • 59 casos são recorrentes e 84 estão sem responsável. Atribua os casos dessas 5 portas à equipe externa para a fila diminuir.
  • Os nomes das OLTs vêm como "DEMO". Se este não for o ambiente real do provedor, os dados são de demonstração.

3. Incidente de PON: quem foi afetado

Quem usa: NOC e atendimento N2.

Pergunta para copiar:

Quais incidentes de PON estão ativos? Pegue o maior e me diga quem foi afetado (nome, login e sinal medido).

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Incidentes de PON (get_pon_incidents) e Detalhe do incidente de PON (get_pon_incident_detail, para o incidente 67).

Resposta da IA (resumida):

5 incidentes ativos. O maior é a PON gpon-0/3/1 da DEMO OLT Sul-02, com 23 casas afetadas. Está aberto desde 24/09.

Ação: é defeito na rua, não nas casas. Abra um chamado só para a equipe externa nessa PON, e ele cobre todos os clientes. Não mande técnico casa a casa.

Quem tem sinal medido (fibra chegando fraca):

NomeLoginSinal
Mariana Correiademo_mariana_correia-29,1 dBm (pior)
Juliana Nunesdemo_juliana_nunes-27 dBm
Aline Nunesdemo_aline.nunes-25,6 dBm
Rafael Correiademo_rafael_correia-25,5 dBm

Esses 4 estão críticos, e nenhum tem responsável atribuído. Atenda primeiro Mariana, a pior.

Os outros 19 não têm sinal individual medido. Entraram no incidente só por estarem na mesma PON, que tem 5 ONUs com sinal ruim. Logins (todos demo_...): Zeca Silva (zeca.silva), Bruna Nunes (bruna.nunes), Gabriela Santos (gabriela.santos), …

Atenção: Rafael Correia (79 °C) e Isabela Melo (85 °C) têm o roteador muito quente. Isso é problema da casa, à parte do incidente. Peça para ventilarem o aparelho.

Mais sobre o tema em Incidentes de PON.

4. Atendimento: cliente reclamando de lentidão

Quem usa: atendimento N1 e N2.

Pergunta para copiar:

A cliente com login demo_carla.alves está reclamando de lentidão. O que está acontecendo com ela e o que o atendimento deve fazer?

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Saúde do assinante (get_subscriber_health).

Resposta da IA (resumida):

Carla Alves (demo_carla.alves) tem a fibra chegando fraca na casa. Esse é o problema principal. O caso está aberto desde 14/09 como crítico, ainda sem responsável.

O que fazer, em ordem:

  1. Abra chamado para a equipe externa. Peça para verificar a fibra, o conector e a caixa da rua que atende a casa dela. O caso é crítico e está parado há mais de 6 semanas, então atribua alguém hoje. Não há incidente de rua cobrindo esse caso, então o chamado precisa ser aberto à parte. Reiniciar o roteador não resolve fibra fraca.
  2. Veja os vizinhos. Sem dado da OLT e da porta, não dá para saber se é só a casa dela ou a rua toda. Se outras casas da mesma caixa também estiverem com sinal fraco, o defeito é na rua. Nesse caso, um chamado único resolve todas.
  3. Peça ao cliente para olhar o cabo e reiniciar o roteador. Esse é só um paliativo.

Outros sinais:

  • Roteador: a nota de saúde está em 50 (baixa). Pode ser consequência do sinal fraco. Se continuar baixa depois do reparo da fibra, encaminhe para o N2 avaliar a troca do equipamento.
  • Upload maior que download: o sinal já era leve e não é atual (visto até 24/09). Não é prioridade.
  • Histórico (24 a 29/09): vários episódios de cliente abrindo conexões demais, dois de memória do roteador alta e um de temperatura alta. Todos já resolvidos.

Os dados de OLT e porta da rua vieram vazios, então a localização exata da falha na rua precisa ser confirmada pela equipe externa.

Veja o que o atendimento enxerga nas telas em Saúde do assinante nas telas.

5. A rede piorou?

Quem usa: NOC e gestão.

Pergunta para copiar:

A rede piorou nos últimos 7 dias? Use a tendência de 168 horas e me diga quando e em qual camada. Responda em português, objetivo.

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Tendência da saúde (get_health_trend, pedindo 168 horas = 7 dias).

Resposta da IA (resumida):

Piora pequena, só no último ponto, e a camada é o acesso (a rua, onde ficam as PONs).

  • Quando: de 27/10 18h até 29/10 12h (UTC) tudo ficou idêntico, nota geral 83. Em 30/10 12h (UTC) a nota caiu para 82 e o acesso foi de 53 para 50.
  • Camada: acesso (PON/fibra). CPE (roteador do cliente) ficou em 79, sessão em 99 e NAS em 100, sem mudança.
  • Problema maior que a piora: o acesso já estava ruim (53) a semana inteira, com 4 incidentes de PON ativos o tempo todo. Isso é defeito crônico na rua, não queda nova.
  • Motivos ativos: subiram de 154 para 167. As demandas abertas caíram de 100 para 96.

O que fazer: acione a equipe externa para as 4 PONs com incidente. Posso listar quais são, se quiser.

Os dados têm lacunas. Há só 12 pontos em 168h, e faltam registros de 29/10 e do começo de 30/10. A hora exata da virada é aproximada.

Repare na ressalva: a IA avisa quando a série histórica é curta ou parada. A tendência só é confiável se a coleta periódica estiver rodando. Veja Execuções.

6. Minhas regras geram ação ou ruído?

Quem usa: gestão e coordenação do NOC.

Pergunta para copiar:

Nos últimos 30 dias, as regras de saúde estão gerando ação real ou só ruído? Quais regras eu deveria revisar?

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Resultados e funil (get_results_funnel, 30 dias).

Resposta da IA (resumida):

Quase nenhuma regra gera ação real. Dos 22 problemas detectados, 5 viraram caso. Nenhum teve responsável, ação registrada ou recuperação confirmada. O sistema resolveu 3 sozinho e nenhuma pessoa resolveu algum. Nos 30 dias anteriores, 2 recuperações; agora 0.

Atenção: os 3 casos com prova de melhora são de clientes demo_*, com duração de cerca de 1.450 h. Parecem dados de demonstração, então a leitura abaixo pode estar distorcida.

Regras para revisar, por prioridade:

  1. onu.rx_low_in_pon (ONUs com sinal ruim na mesma PON): 8 ativações e 0 resolvidas. É a regra com mais valor, porque aponta defeito na rua e um acionamento da equipe externa resolve vários clientes. Ela fica aberta sem ninguém agir. O problema parece ser o fluxo de dono e ação, não a regra.
  2. cpe.temperature_high (temperatura alta): a mais ruidosa. São 11 ativações, e o sistema fechou 3 sozinho. Considere subir o limite ou exigir que persista por mais tempo.
  3. cpe.memory_high (memória do equipamento alta): resolveu 5 e ativou só 3. Na prática oscila e se resolve sozinha. Mesma dúvida da temperatura.

Menor prioridade: cgnat.port_exhaustion (os números não batem entre as duas contagens; vale conferir) e cpe.optical_rx_low (única com melhora confirmada por medição, nos casos demo). …

Antes de mexer nas regras, confira por que with_owner e acted estão em 0. Se a equipe não está assumindo os casos, nenhuma regra vai parecer eficaz.

Para ajustar os limites, veja Regras; para entender o funil, veja Resultados.

7. Avisar os clientes de um incidente

Quem usa: atendimento e comunicação com o cliente.

Pergunta para copiar:

Escreva uma mensagem curta de WhatsApp para os clientes afetados pelo maior incidente de PON ativo, avisando que a equipe já está verificando.

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Incidentes de PON (get_pon_incidents).

Resposta da IA (resumida):

Maior incidente: PON gpon-0/3/1 (DEMO OLT Sul-02), 23 clientes, sinal fraco.

Mensagem pronta:

Olá! Aqui é da [Provedor]. Identificamos uma instabilidade na rede da sua região que pode estar deixando sua internet lenta ou com quedas. Nossa equipe já está verificando e trabalhando para normalizar o mais rápido possível. Não precisa fazer nada por enquanto. Avisaremos assim que resolver. Obrigado pela paciência! 🙏

Troque [Provedor] pelo nome da empresa. Sem prazo de normalização na mensagem, porque não tenho previsão. Incidente aberto desde 24/09, então talvez valha acionar equipe externa. Quer a lista nominal dos 23 clientes para o envio?

A IA escreve a mensagem, mas não envia nada: o conector é somente leitura. Revise o texto e envie pelo seu canal de atendimento.

8. Resumo para o gestor

Quem usa: gestão e diretoria.

Pergunta para copiar:

Monte um resumo executivo da saúde da rede para o gestor: situação, principais riscos, o que a equipe resolveu nos últimos 30 dias e próximos passos.

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Conversa real no Claude Code com o Conector de IA (dados de demonstração)

Ferramentas usadas: Saúde geral da rede (get_network_health), Lista de prioridades (get_priority_list, 5 itens), Incidentes de PON (get_pon_incidents), Resultados e funil (get_results_funnel, 30 dias) e Tendência da saúde (get_health_trend, 168 horas). Uma só pergunta aciona várias ferramentas.

Resposta da IA (resumida):

Resumo executivo: saúde da rede (30/10/2026)

Situação: atenção. Nota 82/100, estável nos últimos 30 dias (83 → 82). Fibra/acesso: 50/100, a camada mais fraca. Roteadores dos clientes: 79/100. Conexões e servidores de acesso: 99 e 100. Cobertura parcial: só 75% dos clientes (90 de 120) têm ONU medida, então os números podem subestimar o problema.

Principais riscos

  1. Defeito na rua (planta) em 5 PONs, cerca de 84 casas. Quatro PONs estão abertas há 1 a 5 semanas, desde 24/09, sem solução. A pior é Sul-02 gpon-0/3/1, com 23 casas. Ação: abrir chamado de equipe externa por PON, não por cliente. A mais recente é Centro-01 gpon-0/1/1: 8 casas, nova hoje (12h).
  2. Fila sem dono. 101 casos abertos e 84 sem responsável. 89 são de gravidade alta ou crítica. 59 casos são recorrentes.
  3. Casos críticos individuais parados. 16 críticos de sinal fraco na casa do cliente, alguns abertos desde agosto.

O que a equipe resolveu nos últimos 30 dias

  • Foram resolvidos 46 casos no total, mas o funil de resultados não registra nenhum com responsável ou ação humana.
  • A rede resolveu sozinha 3 casos: temperatura alta, memória alta e estouro de portas CGNAT. A melhora foi confirmada por medição.
  • Nenhuma das 5 PONs com defeito foi resolvida. Recuperações confirmadas: 0 neste período, contra 2 no período anterior.
  • Atenção: a base é de demonstração (OLTs "DEMO"), então esses números podem não refletir a operação real.

Próximos passos

  1. Despachar equipe externa nas 5 PONs, começando por Sul-02 gpon-0/3/1 e pela PON nova (Centro-01 gpon-0/1/1).
  2. Designar responsável para os 84 casos sem dono, começando pelos 16 críticos.
  3. Pedir à equipe que registre as ações feitas nos casos. Hoje o painel mostra 0 ações, e isso impede provar resultado.
  4. Ampliar a cobertura de ONU de 75% para perto de 100%.

Dicas para perguntar

  • Peça o período: "nos últimos 7 dias", "nas últimas 24 horas", "nos últimos 30 dias". A tendência aceita de 1 a 720 horas e o balanço de resultados cobre 7, 30 ou 90 dias.
  • Peça um limite: "os 5 mais importantes", "os 10 piores". A lista de prioridades traz até 50 itens.
  • Informe a chave do assinante: o login PPPoE, o serial da ONU, o id da ONU ou o id da CPE no ACS. Para só procurar, use nome, login ou documento.
  • Escolha o formato: "em tabela", "em uma mensagem curta de WhatsApp", "em um resumo de 5 linhas para o gestor", "para o técnico de campo".
  • Peça o próximo passo: "o que o atendimento deve fazer?" faz a IA terminar com uma ação sugerida.
  • A IA só lê, não altera nada: ela não abre, move nem encerra casos, não muda regras e não mexe em equipamento. Para agir, use as telas da Fila.
  • Ela respeita as suas permissões: sem a permissão necessária (por exemplo, health.view), a ferramenta não devolve os dados, igual à tela. Veja Conector de IA (MCP).

Limites

  • Somente leitura. Nenhuma ferramenta altera dados nem dispara comandos no ACS, na OLT ou no RADIUS.
  • Só o que as suas permissões permitem. Cada chamada usa o seu token, igual ao que a tela mostra.
  • A cobertura depende da ONU vinculada. Clientes sem ONU ou CPE vinculada aparecem como sem medição — o que não é o mesmo que estar bem (veja o caso 1).
  • A tendência depende da coleta. Sem retratos periódicos, a série é curta ou parada e a IA avisa (veja o caso 5).
  • A IA interpreta números, não os mede. Confira os valores nas telas antes de uma decisão importante, e revise os textos que ela escreve antes de enviá-los ao cliente.

Nesta página