13 de novembro de 2026

Inteligência Artificial, Skills, Claude Code, Configurador, Integradores, Novidade, guia

ES • EN • PT

Como configurar um rastreador GPS com Claude Code e sua IA

Configurar um rastreador GPS sempre foi um trabalho de manual: procurar o comando, montar a regra, testar e corrigir. Agora você pode pedir isso à IA que já usa. Publicamos os skills oficiais da Rinho para Claude Code, Codex, Cursor, Gemini CLI e Claude.ai: você diz o que precisa no seu idioma e sua IA monta a configuração, valida com o mesmo motor do configurador web e, se você pedir, carrega no equipamento por USB.

🎯 Para quem é este artigo: técnicos, instaladores e integradores que configuram equipamentos Rinho Zero IoT, Spider IoT ou Smart IoT e já trabalham com um assistente de IA.

O que é um skill

Um skill é um pacote de instruções e ferramentas que ensina uma tarefa específica a um agente de IA. Ele usa o formato aberto Agent Skills, por isso o mesmo pacote funciona no Claude Code, Claude.ai, Codex, Cursor, Gemini CLI e em qualquer agente compatível.

Os skills da Rinho dão à sua IA três coisas que ela não tem sozinha: a documentação pública dos comandos, um conjunto de receitas testadas e o validador do configurador oficial. Por isso ela não improvisa: se um comando não existe ou o seu firmware não o suporta, ela avisa.

Os três skills

rinho-config: Monta regras, alarmes, saídas, relatórios e modos de baixo consumo a partir de 31 receitas testadas. Valida cada linha e avisa o que o seu firmware não suporta.
rinho-diagnostics: Guia o diagnóstico de um equipamento com consultas somente de leitura: por que não reporta, por que não tem posição, o que está configurado e o que falta.
rinho-zones: Converte um KML, KMZ ou CSV no arquivo de zonas do equipamento (até 4096 figuras em 512 zonas) e monta as regras de entrada e saída.

Os três são gratuitos, de código aberto (Apache-2.0) e estão no repositório do GitHub.

Instalação

Você precisa do Node.js 18 ou superior.

Claude Code, Codex, Cursor e outros agentes:

npx skills add fernandorvs/rinho-skills

No Claude Code, adicione -a claude-code no final, ou instale como plugin para receber as atualizações:

/plugin marketplace add fernandorvs/rinho-skills
/plugin install rinho@rinho

Claude.ai e Claude Desktop: baixe o arquivo .zip de cada skill em config.rinho.com.ar/skills e adicione em Configurações → Recursos → Skills.

Um exemplo: excesso de velocidade com buzzer

Com os skills instalados, o pedido é escrito como você diria a um técnico:

Que o buzzer toque se o veículo passar de 110 km/h

A IA pergunta o modelo e a versão de firmware, escolhe a receita "Excesso de velocidade com buzzer" e entrega as linhas já validadas:

>SVL00E01101<
>SVL01E01001<
>SRL16E;TRG=VL00+;ACC={GER53H;@LOG}{SSSXP0111}<
>SRL17E;TRG=VL01-;CND=XP01;ACC={GER54H;@LOG}{SSSXP0100}<

O buzzer liga ao passar de 110 km/h e desliga quando a velocidade cai abaixo de 100 km/h, para não tocar de forma intermitente perto do limite. Nos dois casos o equipamento reporta um evento à sua plataforma.

A partir daí você tem dois caminhos:

Colar as linhas no configurador web, no modo Código, revisar e enviar por lá.
Pedir à IA que as carregue, com o equipamento conectado por USB e indicando a porta: "Carregue no equipamento pela COM4".

Outros pedidos para testar

"Meu equipamento não reporta à plataforma, o que eu verifico?" O skill de diagnóstico consulta o estado do equipamento (rede celular, GPS, alimentação, destino configurado) e delimita a causa passo a passo.
"Quero um aviso se a porta ficar aberta por mais de cinco minutos."
"Corte de motor com pré-aviso de buzzer, somente em baixa velocidade."
"Converta este KML de depósitos em zonas e faça o equipamento reportar quando um caminhão sair de uma."
"Explique o que esta configuração faz", colando um bloco existente.

Proteções incorporadas

As proteções estão no código da ferramenta, não nas instruções da IA:

Valida cada linha com o mesmo motor do configurador antes de entregá-la.
Só grava no equipamento quando você pede de forma explícita, e apenas pela porta serial que você indica.
Faz backup da configuração atual antes de alterá-la.
Envia linha por linha e para no primeiro erro.
Pede confirmação antes de ativar saídas ou executar comandos sensíveis.
Oculta APN, senhas e credenciais no que mostra.
Não usa comandos de segurança, restauração de fábrica nem atualização de firmware.

⚠️ Importante: se a configuração aciona uma saída (corte de motor, sirene, buzzer), teste primeiro com o veículo parado.

O configurador web

Os skills se apoiam no configurador web, a ferramenta gratuita para configurar os equipamentos Rinho pelo navegador. Se você prefere trabalhar com formulários, ou quer revisar o que a sua IA montou antes de enviar, este é o lugar.

Configurador web da Rinho aberto no navegador

Sem instalar programas: você conecta o equipamento por USB e configura pelo Chrome, Edge ou Opera.
Formulários por seção: comunicação, WiFi, celular, GPS, entradas e saídas, Bluetooth e eventos.
Três modos de trabalho: Básico, com módulos guiados; Avançado, com todos os parâmetros; e Código, para editar a configuração completa como texto. No modo Código você cola o que os skills entregam.
Validação antes de enviar: revisa a configuração e avisa dos erros antes de gravá-la no equipamento.
Estado ao vivo: com o equipamento conectado você vê o estado dele e pode atualizar o firmware por cabo.
Uma configuração para toda a frota: você salva em um arquivo e carrega em cada equipamento.
Em espanhol, inglês e português.

O configurador inclui ainda um assistente ao qual você pede o que precisa em linguagem natural, disponível para clientes Rinho com acesso habilitado. Você pode solicitá-lo pelo formulário de contato.

Perguntas frequentes

Preciso saber programar?

Não. Você pede à sua IA o que precisa no seu idioma e ela monta e valida a configuração. Se preferir não usar IA, o configurador web funciona com formulários no navegador.

Tem custo?

Os skills e o configurador web são gratuitos para equipamentos Rinho. Você só precisa da IA que já usa.

Funciona com firmware anterior?

Sim. Cada função indica qual versão de firmware exige, e a validação avisa se o seu equipamento precisa ser atualizado antes de usá-la.

Os alertas são gerados pelo equipamento ou pela plataforma?

As regras rodam no equipamento: ele liga o buzzer, corta uma saída ou reporta um evento. As notificações, os relatórios e os painéis são configurados na sua plataforma de rastreamento (Wialon, Traccar ou a que você usa) a partir desses eventos.

Recursos

Testou os skills? Conte para nós como foi: o que você nos contar ajuda a somar novas receitas. E se forem úteis, uma estrela no GitHub faz com que mais gente os encontre.