Manual de Gestão de Rede

Gestão de Rede não é um painel que olha sua rede de fora. É um agente de IA com um terminal dentro: abre sessões SSH contra seus roteadores, OLTs e servidores, executa comandos lá e responde com o que leu. O agente se chama NetAdmin de fábrica e você pode mudar o nome.

Você escreve em linguagem corrente, como escreveria para um técnico: "quais clientes estão conectados no roteador do Nodo Sul?", "o cliente Pérez está sem navegar, veja o que acontece", "me dê o sinal das ONUs da OLT do centro". O agente decide quais comandos rodar, roda e responde com a conclusão.

O agente não roda dentro do seu ISP. Roda em um contêiner Debian dedicado à sua empresa, na nuvem da PlenoAgent, e chega aos seus equipamentos por um túnel OpenVPN que sai do seu roteador de borda em nossa direção. Você não abre portas nem expõe nada à internet: a conexão é iniciada pelo seu roteador.

Dentro do contêiner, o agente tem python3 com paramiko e netmiko, ssh, ping, nmap, snmpwalk e curl. Com isso alcança qualquer equipamento alcançável a partir do seu roteador de borda, não só MikroTik.

A aba Estado do módulo traz um Guia de configuração que lê seu estado real: cada passo se marca sozinho, e se um voltar a pendente, ali se rompeu a conexão. São três passos até a primeira resposta.

3.1Passo 1 — a VPN e o contêiner

Tudo isso vive em Ajustes → VPN.

1. Pressione Configurar VPN. Preparam-se o ambiente privado e as credenciais às quais seu roteador se conectará. Leva cerca de um minuto e não consome créditos.

2. Se o agente aparece como Inativo, pressione Configurar Workspace: o túnel pode existir e o agente ainda não ter onde executar. Segue fora de linha até dizer Em Execução.

3. Escolha sua versão do RouterOS (7.x ou 6.x — você a vê no Winbox, em System → Packages) e pressione Copiar script. O script já leva suas credenciais; não há nada a completar.

4. Abra o terminal do seu roteador de borda (Winbox → New Terminal) e cole o script.

5. Pressione Testar VPN. O túnel deve dizer Conectado e o roteador responder em poucos segundos.

3.2Passo 2 — o modelo de IA

Em Estado, escolha o modelo com o qual o agente pensa. Sem modelo atribuído, o agente se nega a rodar, porque não haveria como cobrar esse uso.

Junto a cada modelo você vê sua janela de contexto e seu preço em créditos por milhão de tokens. Se escolher um caro, aparece um aviso âmbar com o que custaria uma pergunta: uma consulta típica deste módulo move cerca de 33.000 tokens de entrada, porque quase tudo que entra é a saída dos equipamentos que o agente acabou de ler. Esse número, e não o preço por milhão, é o que decide quanto dura seu saldo.

Opcionalmente escolha um Modelo de Transcrição. Só é necessário se você for mandar notas de voz pelo WhatsApp; sem ele, o áudio é ignorado.

3.3Passo 3 — a primeira pergunta

Abra a aba Chat e escreva. Não precisa de nenhum telefone: o chat do painel é o agente. Comece por algo que você mesmo possa verificar — "qual versão do RouterOS tem o roteador de borda?", "liste as interfaces do roteador X e me diga quais estão caídas" — e siga daí.

Ao mesmo agente se escreve por dois lados, e os dois são formas normais de trabalhar. É o mesmo contêiner, o mesmo túnel, as mesmas credenciais, as mesmas habilidades e a mesma memória: a única coisa que muda é onde você escreve e como os arquivos chegam.

O agente sabe em qual das duas está respondendo, então não vai dizer "abra o anexo" enquanto você olha o navegador, nem "clique no link" enquanto você está no telefone. Nas duas responde em texto puro: nenhuma das duas interpreta Markdown, por isso você nunca verá tabelas nem negritos formatados.

4.1O chat do painel

Há uma conversa por empresa, não uma por usuário: Gestão de Rede é o console de quem opera a rede, e parti-la em duas no dia em que você entra com outra conta só daria ao agente duas memórias paralelas da mesma rede. Quem tem a permissão Usar o chat do agente vê e continua essa conversa.

O botão de parar aborta a tarefa em curso; o de limpar apaga o histórico desse chat e começa do zero. Uma tarefa longa segue rodando mesmo se você fechar a aba: ao voltar, você a encontra em andamento, com a caixa de escrita bloqueada até terminar.

4.2WhatsApp, quando você quiser

É opcional e se adiciona quando lhe servir. Em Estado, pressione Conectar WhatsApp e escaneie o QR com o telefone que vai hospedar o agente.

A Lista de permitidos decide quem pode falar com ele: só esses números recebem resposta, o resto é ignorado. Adicione-os com código de país e sem símbolos (por exemplo 593987654321). Se a lista estiver vazia, ninguém pode usar o agente pelo WhatsApp.

Dentro do chat também funcionam as notas de voz, desde que você tenha escolhido um modelo de transcrição.

5.1Perguntas que ele resolve bem

Fale como falaria com um técnico recém-chegado que ainda não conhece a rede. Quanto mais concreto o pedido, menos voltas ele dá — e menos créditos gasta.

• "Quais clientes estão conectados agora no roteador do Nodo Sul (10.0.0.5)?"
• "O cliente Pérez está sem navegar. Revise sua sessão PPPoE e sua queue, e me diga o que encontrou."
• "Me dê o sinal das ONUs da OLT 10.0.0.20 e liste só as que estão abaixo de −26 dBm."
• "Compare o uso de CPU e memória dos três roteadores de nodo e me diga qual está pior."
• "Gere o mapa da rede e me mande."
• "O que mudou no log do roteador de borda nas últimas duas horas?"

Quando algo falha, o agente interroga o próprio equipamento (?, help, print) e consulta a documentação do fabricante se você passar a URL. O que ele não faz é inventar sintaxe: se não puder resolver, ele diz o modelo, a versão e o que não conseguiu determinar.

5.2Como ele pede autorização para uma mudança

Nos seus equipamentos, o estado padrão do agente é apenas leitura. Qualquer comando que mude algo — por pequeno, rotineiro ou obviamente correto que pareça — precisa da sua autorização nessa conversa.

Na prática você verá uma linha curta: "Vou adicionar a queue de 20M ao cliente X no RB do Nodo Sul — aplico?". Quatro detalhes que convém conhecer:

• A autorização é específica e do momento. Um "arrume o que for preciso" não autoriza nada em concreto. Vale para esse comando, nesse equipamento, nessa conversa: não se arrasta para uma segunda mudança nem para o dia seguinte.
• Guarda o valor anterior. Antes de modificar, imprime como estava, e o inclui no relatório. Se não puder mostrar como estava, não muda nada.
• Raio de alcance. Toca só o cliente, a interface ou a regra que você nomeou. O compartilhado por muitos assinantes — queues pai, cadeias de firewall globais, a WAN, DNS, DHCP, protocolos de roteamento — fica de fora, a menos que você o nomeie explicitamente.
• Verifica depois. Volta a ler o que tocou, confirma o efeito e diz como revertê-lo.

Tampouco ele vende a mudança: seu trabalho é diagnosticar e explicar. Se ele reporta um problema e você não responde a pergunta, isso também é uma resposta.

Escrevem-se igual nas duas portas. Respondem na hora, não gastam créditos e funcionam mesmo enquanto o agente executa uma tarefa.

Escrever uma mensagem nova enquanto o agente trabalha também cancela a tarefa anterior: a nova rodada continua do que ele já alcançou fazer, não do zero.

Uma automatização é uma instrução que roda sozinha no horário que você colocar. Ela é executada por uma nova instância do agente, sem histórico: não lembra a conversa em que você a criou.

7.1Criá-las

Você pode pedir ao agente no chat ("me avise toda segunda às 8 se a CPU do roteador principal passar de 80%") ou montá-la à mão na aba Automatizações com Nova Automatização. No formulário você escolhe:

Há um mínimo de 10 minutos entre execuções e um teto de automatizações conforme seu plano. Cada execução consome créditos como qualquer pergunta.

7.2Onde você vai ler o relatório

O relatório chega ao destino que você escolheu. Escolha-o por onde você estará quando rodar, não por onde o criou.

7.3As execuções sem acompanhamento são de apenas leitura

Quando a automatização dispara, não há ninguém do outro lado, então ninguém pode autorizar nada: o agente não muda nada nessa execução, nem mesmo o que pareça óbvio. Se um equipamento não responde ou um comando falha, ele tenta de novo um par de vezes e reporta o que tentou, o que falhou e o que suspeita. Esse relatório é o resultado; não escala para reiniciar nada.

Por isso a recomendação para o que roda sozinho é que seja de leitura: que revise, meça e avise, e que a decisão de mexer em algo seja sua.

A aba Topologia mostra a rede que o agente conhece: os sites, os equipamentos de cada site e os enlaces entre eles, como os tem registrados em sua própria base, dentro de seu contêiner.

Enche-se falando com ele: peça no chat que adicione um site, um equipamento ou um enlace, ou que registre o que acabou de descobrir escaneando. Não há cadastro manual nesta tela — o que você vê é o reflexo do que o agente anotou.

Você pode arrastar os sites para acomodar o diagrama; a disposição é salva. Restabelecer disposição volta ao acomodo automático e Restabelecer zoom reenquadra. Ao clicar em um site, abrem-se seus equipamentos e seus enlaces internos.

Tudo que o agente fez fica registrado em dois lugares distintos, e servem para perguntas distintas.

9.1Chats

Lista as conversas do agente — as de WhatsApp e também a do painel. Ao abrir uma, você vê a conversa à esquerda e, ao selecionar qualquer turno ou qualquer ferramenta, o detalhe à direita: os argumentos exatos com que foi chamada e a saída crua que o equipamento devolveu. É aí que você verifica qual comando rodou e o que o roteador respondeu.

9.2Histórico de Ações

Registra o que o agente fez dentro da PlenoAgent através da API: criar um cliente, bloquear uma assinatura, registrar uma OLT. Cada linha traz a ação, o identificador, quem a disparou, a duração e se saiu bem; ao clicar, abre o detalhe com o erro, se houve. É o que responde "isto foi a IA ou foi alguém?" em um só lugar.

10.1Comportamento

10.2Permissões do agente

Define o que o agente pode fazer através da API da PlenoAgent: criar clientes, bloquear assinaturas, registrar uma OLT, criar automatizações. Tudo começa desligado e se liga uma por uma; a mudança é salva na hora. Ler dados é sempre permitido e sempre limitado à sua empresa.

10.3Instruções, memória e habilidades

O agente traz de fábrica sua identidade, suas regras de operação e um conjunto de habilidades por família de equipamento (MikroTik, OLTs V-SOL e Huawei, Ubiquiti, topologia, automatizações). A plataforma mantém essas peças em dia; não há o que mexer.

O que é seu:

• Instruções próprias — a caixa editável onde você escreve o que é particular da sua rede: convenções de nomes, qual nodo é prioritário, como você quer os relatórios. É salva com o botão de salvar e entra em cada conversa.
• Memória — apenas leitura pelo painel: o agente a escreve. Lá ele anota credenciais que funcionaram, falhas recorrentes, instruções suas que devem persistir e marcos. É a única coisa lembrada entre conversas, e é o que as duas portas compartilham.
• Habilidades — a lista de guias que ele pode carregar quando a tarefa pede. O agente também as melhora sozinho quando aprende algo novo de um equipamento seu.

11.1Para onde vão os créditos

Cada pergunta ao agente consome créditos, e a maior parte do que se paga não é seu texto, mas a saída dos equipamentos que ele leu para responder. Quatro coisas movem a conta:

• O modelo escolhido, e não por seu preço por milhão, mas pelo custo de uma pergunta completa.
• O tamanho do histórico: mensagens e tool calls anteriores viajam de novo a cada turno.
• Quão concreta é a pergunta: um pedido vago se traduz em mais leituras.
• As automatizações: cada execução é uma pergunta, mesmo que não reporte nada.

Escreva /usage no chat para ver o saldo, o gasto do módulo e quanto contexto a conversa atual está usando. Se vem crescendo, /new começa limpo.

11.2Diagnóstico rápido

O agente não responde nada

Revise o Guia de configuração em Estado. As causas habituais: o contêiner está parado, o túnel caiu, não há modelo atribuído ou o saldo de créditos acabou.

Diz que não chega a um equipamento

Teste o túnel em Ajustes → VPN com Testar VPN. Se a borda responde e o equipamento não, o problema está entre seu roteador e esse equipamento, não na PlenoAgent.

Pelo WhatsApp não responde

Seu número precisa estar na lista de permitidos, com código de país e sem símbolos. Verifique também se a sessão diz Conectado: se o telefone desconectou, é preciso escanear o QR de novo.

Pede autorização até para o mais simples

É o esperado: qualquer escrita nos seus equipamentos precisa do seu sim explícito. As leituras nunca pedem.

Ficou trabalhando demais

/stop, ou o botão de parar no painel. O que ele já fez é conservado e a próxima pergunta continua daí.

Não lembra o que eu disse semana passada

O histórico de cada chat é limitado de propósito. Se algo deve persistir, peça que ele anote em sua memória; isso sim sobrevive e as duas portas veem.

A resposta vem com asteriscos e traços

O chat mostra texto puro. Se o modelo escreve Markdown, você verá os símbolos como estão; peça que responda sem formatação.

Não chegou o relatório de uma automatização

Abra a automatização e olhe seu destino. Se for o chat do painel, o relatório só é visto ao vivo; para que sempre o encontre, mande-o ao WhatsApp.

A aba Topologia aparece vazia

O agente ainda não registrou nada, ou seu contêiner está parado. Peça no chat que registre os sites e equipamentos que ele já conhece.