Caso de uso do Butler

Pedir ao Butler que faça por você

Até aqui, o Butler respondia. Aqui ele age: muda uma configuração, gera um documento ou entrega um arquivo a alguém, sempre dentro do fluxo de confirmação que rege tudo isso.

A situação

Duas coisas bem diferentes cabem neste título, com riscos bem diferentes: alterar um Controlador de Borda de Sessão (SBC) e gerar um relatório para enviar por e-mail.

O que elas têm em comum é o trabalho tedioso que eliminam. Encontrar a chamada, exportar a captura, localizar o arquivo, anexar, escrever o assunto, enviar. Ou então: acessar o equipamento, encontrar a lista de bloqueio, editar, salvar, lembrar de ativar. Nos dois casos, basta uma frase, na mesma conversa em que o problema já estava sendo discutido.

Qualquer profissional experiente vai querer saber o que impede o Butler de fazer uma besteira muito antes de se importar com a rapidez. É disso que as conversas abaixo realmente tratam.

As respostas

Escolha uma pergunta e leia a conversa completa

Todas foram executadas em uma frota de demonstração sintética. Na primeira, observe a ordem das operações, não a velocidade.

#voice-opsChat
EN

Engenheiro 09:07
@VI – Butler Nossa operadora mudou o IP por trás do hostname SIP dela e atualizou o DNS, mas o SBC-SUT-01 continua enviando as chamadas para o endereço antigo. Corrija isso, por favor.
B

VI – Butler APP 09:07
get_host_listlookup_knowledge query=“SBC DNS cache refresh hostname resolution”list_available_actions query=“clear_dns_cache”
Entendo o problema, senhor. Quando uma operadora atualiza o registro DNS do hostname SIP, o SBC precisa renovar a resolução que tem em cache. Encontrei o SBC-SUT-01. Vou verificar o nome exato da ação e os parâmetros de que ela precisa.
B

VI – Butler APP 09:07
Confirmação necessáriaEsta ação vai limpar o cache DNS do SBC-SUT-01, apagando todas as resoluções armazenadas pelos grupos DNS (A, SRV, NAPTR, LOCSRV, MCAST) e os caches DNS da pilha SIP. As entradas DNS locais estáticas são preservadas. Consultas DNS em andamento podem falhar brevemente, e novas consultas serão recusadas até que o cache seja reconstruído. As chamadas estabelecidas não são afetadas. Nenhuma ativação de configuração é necessária após esta ação.
Posso prosseguir com a limpeza do cache DNS do SBC-SUT-01?
EN

Engenheiro 09:08
@VI – Butler sim, pode seguir
B

VI – Butler APP 09:08
device_action clear_dns_cache, params={“confirm”: true}
A limpeza do cache DNS foi aceita no SBC-SUT-01, ID da tarefa mcp_1790327318_10860. As novas consultas DNS vão resolver o hostname da operadora para o endereço atualizado.

O texto da caixa âmbar não é do Butler. Ele chamou a ação diretamente, o equipamento a recusou por ser destrutiva e devolveu a própria descrição do que uma limpeza faz, e o Butler repassou esse texto palavra por palavra e esperou. Essa é a diferença entre um assistente que promete ter cuidado e um que não consegue avançar até que outra coisa concorde. Repare também que ele confirmou o nome exato da ação no catálogo em vez de digitá-lo de memória.

#voice-opsChat
EN

Engenheiro 03:36
@VI – Butler Oi Butler, adicione o 15551234999 à lista de bloqueio no SBC-SUT-01
B

VI – Butler APP 03:36
lookup_knowledge query=“blacklist number add block”list_available_actions category=writeget_host_list
Boa tarde, senhor. Vou adicionar o 15551234999 à lista de bloqueio no SBC-SUT-01. Primeiro, vou procurar a ação correta para gerenciar a lista de bloqueio.
Vejo que a lista de bloqueio é gerenciada por arquivos personalizados. Preciso encontrar o host, buscar o arquivo atual, adicionar o número e gravar o arquivo de volta.
B

VI – Butler APP 03:37
O arquivo da lista de bloqueio existe e atualmente contém:
0000000000,b,,
É um CSV com colunas para o número chamador e o parâmetro dele, depois o número chamado e o parâmetro dele. Um b significa bloqueio. Vou acrescentar uma nova linha: 15551234999,b,,
O arquivo da lista de bloqueio foi atualizado com sucesso. Para concluir, agora é preciso ativar a configuração no SBC-SUT-01 para que a mudança entre em vigor. Faço isso agora, senhor?
EN

Engenheiro 03:37
@VI – Butler Sim, por favor
B

VI – Butler APP 03:37
Senhor, a ação exige confirmação. Esta é a descrição:
Confirmação necessáriaEsta ação vai ATIVAR a configuração pendente no SBC-SUT-01. Mudanças rotineiras (NAPs, rotas, registrars, perfis, portas de proxy, regras de cabeçalho e de firewall) são aplicadas sem impacto nas chamadas, porque os aplicativos recarregam a quente em poucos segundos e as chamadas ativas não caem. Apenas mudanças grandes de infraestrutura (endereços IP, point codes, remoção de interfaces) podem causar uma breve interrupção.
Posso prosseguir com a ativação?
EN

Engenheiro 03:37
@VI – Butler SIM!
B

VI – Butler APP 03:37
Feito, senhor. O 15551234999 foi adicionado à lista de bloqueio no SBC-SUT-01 e a configuração foi ativada. As chamadas desse número agora serão bloqueadas pelo filtro do script de roteamento.

Conte as proteções. O Butler verificou como a lista de bloqueio funciona nesta plataforma antes de mexer em qualquer coisa, buscou o arquivo atual e mostrou o conteúdo a você, depois acrescentou uma única linha sem mudar mais nada. Ele não ativou por conta própria: perguntou. Quando você disse sim, ele ainda não prosseguiu, e explicou o que a ativação afetaria ou não antes de perguntar de novo. Quatro pontos distintos em que uma pessoa continua no controle, em uma mudança que levou menos de um minuto.

#voice-opsChat
B

VI – Butler APP 09:06
Não consigo obter o PCAP neste momento. Em vez disso, posso enviar:
  • Um relatório de chamada detalhado em HTML, com o diagrama SIP completo e a análise da falha
  • Os registros CDR em JSON
Posso gerar o relatório de chamada e enviá-lo por e-mail, senhor?
EN

Engenheiro 09:08
@VI – Butler Sim, gere o relatório de chamada com todos os campos marcados e envie para mim, por favor
B

VI – Butler APP 09:09
vitrace_get_report session_idemail_send to, subject, attachment
Senhor, já gerei o relatório de chamada. Para enviá-lo, pode me informar seu endereço de e-mail?
B

VI – Butler APP 09:17
O relatório de chamada foi enviado por e-mail com o assunto “Call Report, Session #3797941”. O relatório inclui o diagrama SIP completo dos 13 saltos e os detalhes do CDR de cada trecho.

A primeira mensagem é a que importa. Quando pediram uma captura de pacotes que ele não conseguia produzir, o Butler não travou nem fingiu: indicou duas coisas que podia enviar no lugar e perguntou qual você queria. Depois, antes de enviar qualquer coisa, parou para perguntar para onde enviar, porque um endereço não é algo que se presume. Treze saltos de diagrama SIP e o CDR de cada trecho, anexados e enviados, a partir de uma única frase.

#voice-opsChat
EN

Engenheiro 08:56
@VI – Butler Estamos sendo bombardeados por um scanner SIP a partir de 203.0.113.9. Você pode bloquear esse IP no SBC? IMPORTANTE: não execute nenhuma ação de escrita, só me diga exatamente qual ação você usaria e com quais parâmetros.
B

VI – Butler APP 08:56
lookup_knowledge query=“block IP address firewall ACL”
Senhor, para bloquear globalmente o IP de um scanner SIP no SBC, eu usaria:
Açãoblacklist_ip Parâmetros{ “ip”: “203.0.113.9” }
Isso cria um único filtro DROP cobrindo todos os protocolos a partir desse endereço de origem, em qualquer porta de destino, o que é ao mesmo tempo mais simples e mais abrangente do que bloquear cada protocolo separadamente.
A regra ficará preparada, mas não estará ativa até que activate_config seja executado em seguida.
Se fosse necessária uma abordagem mais granular, por exemplo bloquear apenas SIP em UDP em portas específicas, a alternativa seria create_firewall_rule com tipo de entrada DROP, filtros especificando o protocolo, o IP de origem e, opcionalmente, as portas de destino, e uma prioridade, em que a menor é avaliada primeiro.

Os clientes pedem isso o tempo todo: me diga o que você faria, mas não mexa no meu equipamento. Essa também é a melhor forma de conhecer o Butler se o acesso de escrita deixa você inseguro. Quando pediram um conselho em vez de uma ação, ele nomeou a ação, deu o parâmetro exato, avisou por conta própria que nada entra em vigor até a configuração ser ativada e ofereceu a alternativa mais granular para um bloqueio mais restrito. Você pode executar cada uma dessas ações manualmente sem nunca conceder acesso de escrita.

#voice-opsChat
EN

Engenheiro 10:44
@VI – Butler Acabei de receber meu relatório de fraude. Você pode me ajudar a adicionar alguns IPs à ACL?
B

VI – Butler APP 10:44
get_host_listlist_available_actions category=write, query=“firewall”
Bom dia, senhor. Estes são os SBCs disponíveis:
SBC-SUT-00 192.168.101.63SBC-SUT-01 192.168.101.96SBC-SUT-02 192.168.101.88APAC SBC o honeypot
Para adicionar IPs à ACL, preciso de três informações: qual SBC, os endereços do seu relatório e a direção, ou seja, se eles devem ser bloqueados para enviar chamadas de entrada ou para receber chamadas de saída.
EN

Engenheiro 10:46
@VI – Butler Bloqueie todos estes IPs no honeypot: 203.0.113.11,203.0.113.12,203.0.113.13,203.0.113.14,203.0.113.15,203.0.113.16,203.0.113.17,203.0.113.18,203.0.113.19
B

VI – Butler APP 10:47
lookup_knowledge query=“how to block IPs in ACL blacklist”list_available_actions category=write, query=“blacklist”
Encontrei a ação blacklist_ip. Ela está marcada como destructive e requires_confirmation, então primeiro vou mostrar o que ela fará com cada endereço e depois aguardar sua confirmação antes de continuar.
A BLOQUEAR NO APAC SBC, DROP, TODOS OS PROTOCOLOS203.0.113.11203.0.113.12203.0.113.13203.0.113.14203.0.113.15203.0.113.16203.0.113.17203.0.113.18203.0.113.19
EN

Engenheiro 10:48
@VI – Butler confirmado
B

VI – Butler APP 10:48
Feito, senhor. Os nove endereços estão preparados como regras de firewall DROP, bloqueando todo o tráfego de cada origem. As regras estão salvas na configuração e só entrarão em vigor depois que activate_config for executado.
EN

Engenheiro 10:49
@VI – Butler você pode desfazer isso e, em vez de 9 regras, criar uma única regra com 9 filtros, e depois ativar? Não precisa pedir confirmação.
B

VI – Butler APP 10:51
As nove regras foram removidas e substituídas por uma única regra consolidada, já ativada:
HONEYPOT_BLACKLISTentry type DROPpriority 1automatic falsefilters F1 a F9, cada um com protocolo ALL e um /32

Todas as outras conversas deste site terminam com uma resposta. Esta termina com uma mudança concreta, e o monitoramento comprova: o honeypot vinha recebendo de dois a seis trechos de chamada por minuto havia horas e, às 10:51, quando a lista de bloqueio foi ativada, caiu para zero e ficou assim. Dos 117 registros de chamadas dos 45 minutos anteriores, 113 vinham de endereços dessa lista. Um relatório de fraude numa segunda-feira de manhã virou uma mudança de firewall aplicada, por alguém digitando numa janela de chat, em cerca de dez minutos. Leia o meio da conversa para ver o que torna isso seguro: havia quatro equipamentos na frota e o Butler se recusou a adivinhar qual era, depois repetiu os nove endereços e parou completamente até que uma pessoa digitasse “confirmado”. Quando depois disseram para ele não pedir de novo, ele respeitou isso na etapa seguinte e não levou essa permissão para nenhum outro lugar.

Como pedir

Mudanças no SBC

Cada um destes pedidos lê primeiro o estado atual, propõe e espera.

Adicione o 1 555 123 4999 à lista de bloqueio no sbc-01
Quando pedir

Uma origem de chamadas indesejadas ou de fraude foi identificada e você quer interrompê-la antes mesmo de abrir o chamado.

O que você recebe

O arquivo atual, a mudança proposta de uma única linha e depois um pedido para ativar, como etapa separada.

Depois pergunte

Mostre o arquivo de novoAtiveDesfaça isso
Adicione 203.0.113.44 à ACL do NAP UPSTREAM_SOFTSWITCH
Quando pedir

Um parceiro adicionou um novo host de sinalização e as chamadas estão sendo rejeitadas até você liberá-lo.

O que você recebe

O mesmo padrão: a ACL atual, a inclusão proposta, a confirmação e a ativação como etapa própria.

Depois pergunte

O que mais está nesta ACL?As chamadas deles voltaram a funcionar?
E depois

Documentos e envios

Menor risco, e o que as equipes usam todos os dias.

Você pode enviar o PCAP dessa chamada para [email protected] com o assunto “Aos cuidados de David, conforme nossa ligação”?
Quando pedir

Você está ao telefone com o suporte e eles querem a captura do Voice Intelligence Trace. A alternativa são seis etapas manuais em três janelas.

O que você recebe

A confirmação do que foi enviado, para quem e com qual assunto. O Butler não tem credencial de e-mail própria: ele entrega a mensagem a um gateway que é dono da conta e registra tudo o que sai.

Depois pergunte

Me coloque em cópiaInclua o diagrama SIP como texto no corpo
Você pode gerar um PDF da chamada e enviar aqui?
Quando pedir

A investigação terminou e alguém fora da conversa precisa das evidências.

O que você recebe

O relatório como arquivo na conversa, no Slack e no Telegram. No Teams, o Butler envia por e-mail e avisa, em vez de falhar em silêncio.

Depois pergunte

Com todos os campos marcados, por favorEnvie para o cliente em vez disso
Mais exemplos

Sim, gere o relatório de chamada com todos os campos marcados e envie para mim, por favor
Escreva o que acabamos de descobrir como um resumo de incidente de uma página que eu possa enviar ao cliente, e mande para o meu e-mail
Aqui está um PCAP do nosso outro fornecedor. Leia e me diga onde a chamada falhou.
No dia a dia

Como funcionam as proteções

Toda escrita é confirmada antes de ser executada, e ativá-la exige uma segunda confirmação. Uma mudança de cada vez, cada uma reversível em um único passo e mostrada por completo antes, com o efeito descrito antes de pedirem sua aprovação.
Os destinatários de e-mail são restritos por domínio, e essa restrição não fica dentro do Butler. Um gateway é dono da conta de e-mail, define para quais domínios cada Butler pode escrever e registra uma linha de auditoria para cada mensagem, de modo que “envie para o cliente” pode ser permitido enquanto “envie para qualquer lugar” continua bloqueado.
O Butler nunca envia nada por iniciativa própria, embora ofereça. Ele já terminou um diagnóstico sugerindo um relatório como próximo passo natural, e essa oferta continua esperando o seu sim.
Onde o arquivo chega depende do aplicativo de chat, já que o Slack e o Telegram aceitam arquivos na conversa e o Teams não. Nesse caso, o Butler envia o documento por e-mail e avisa que está fazendo isso.
Casos de uso do Butler

Um número e, talvez, um horário. O Butler encontra a chamada e diz de que lado ela foi encerrada.

Contagens, agrupamentos, limites e KPIs sobre um conjunto de chamadas.

Tabelas de roteamento, regex e perfis SDP em linguagem simples.

Pergunte em francês, espanhol ou português e receba a resposta com base na documentação em inglês.

Faça por mim

Mudanças, relatórios, arquivos e e-mails, cada um esperando o seu sim.

Cole a reclamação nas palavras do cliente e deixe o Butler encontrar a chamada.

Todos os casos de uso do Butler

Veja o fluxo de confirmação no seu próprio equipamento

Implantado em 48 horas, com contrato mensal, no aplicativo de chat que sua equipe já tem aberto.

Ao enviar este formulário, suas informações serão processadas de acordo com nossa Política de Privacidade.