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.
| Ferramenta | Nome técnico | Para quê |
|---|---|---|
| Saúde geral da rede | get_network_health | Nota composta, camadas e cobertura. |
| Lista de prioridades | get_priority_list | O que atacar primeiro. |
| Incidentes de PON | get_pon_incidents | Quedas coletivas ativas ou resolvidas. |
| Detalhe do incidente de PON | get_pon_incident_detail | Quem está dentro de um incidente. |
| Localizar assinante | resolve_subscriber | Acha o cliente por nome, login ou documento. |
| Saúde do assinante | get_subscriber_health | Estado, caso aberto, cadeia e histórico de um assinante. |
| Tendência da saúde | get_health_trend | A nota ao longo do tempo. |
| Resultados e funil | get_results_funnel | Se 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)
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".
- 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.
- 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.
- 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)
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.
- 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.
- 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.
- 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.
- 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.
- 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)
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):
Nome Login Sinal Mariana Correia demo_mariana_correia -29,1 dBm (pior) Juliana Nunes demo_juliana_nunes -27 dBm Aline Nunes demo_aline.nunes -25,6 dBm Rafael Correia demo_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)
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:
- 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.
- 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.
- 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)
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)
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:
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.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.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) ecpe.optical_rx_low(única com melhora confirmada por medição, nos casos demo). …Antes de mexer nas regras, confira por que
with_ownereactedestã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)
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)
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
- 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).
- 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.
- 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
- 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).
- Designar responsável para os 84 casos sem dono, começando pelos 16 críticos.
- Pedir à equipe que registre as ações feitas nos casos. Hoje o painel mostra 0 ações, e isso impede provar resultado.
- 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.