Pular para o conteúdo da ajuda
Central de Ajuda

Conheça seu DoguIA.
Domine cada recurso.

Guias completos para configurar, personalizar e aproveitar ao máximo seu cachorro-robô.

Fale com o suporte

Precisa de ajuda com o seu DoguIA ou com o aplicativo? Escreva abaixo — respondemos por e-mail.

E-mail[email protected]
AtendimentoSegunda a sexta, das 9h às 18h

Ou mande sua mensagem por aqui

Para pedidos de exclusão de conta e dados, use exclusão de conta ou escreva para o e-mail acima.

Conectando ao Wi-Fi via doguia.local

O DoguIA precisa de conexao Wi-Fi para funcionar. A configuracao e feita pela interface local do dispositivo.

O que e o doguia.local?

Quando o DoguIA entra em modo de configuracao, ele cria uma rede Wi-Fi propria chamada DoguIA-XXXXX. Ao conectar nessa rede pelo celular ou computador, voce e redirecionado automaticamente para a interface em http://doguia.local/.

Essa interface permite:

  • Selecionar a rede Wi-Fi da sua casa
  • Digitar a senha do Wi-Fi
  • Ver o status da conexao
  • Visualizar o codigo de verificacao de 6 digitos

Passo a passo para conectar

1
Ativar modo de configuracao

Com o DoguIA ligado, clique duas vezes no botao que fica embaixo da cabeca do robo. O LED ficara piscando indicando que o modo de configuracao esta ativo.

2
Conectar na rede do DoguIA

No seu celular ou computador, abra as configuracoes de Wi-Fi e procure por uma rede chamada DoguIA-XXXXX (onde XXXXX sao caracteres unicos do seu dispositivo). Conecte-se a essa rede.

3
Acessar a interface de configuracao

Apos conectar, o navegador abrira automaticamente a pagina http://doguia.local/. Se nao abrir automaticamente, digite esse endereco no navegador.

Importante: o celular precisa estar conectado somente no Wi-Fi — desative os dados moveis (3G/4G/5G). O endereco doguia.local so funciona quando o celular esta na mesma rede, sem internet movel ativa.
Se doguia.local nao funcionar, tente http://192.168.4.1 no navegador.
4
Selecionar e configurar sua rede

Na interface, voce vera a lista de redes Wi-Fi disponiveis. Selecione a rede da sua casa e digite a senha. Clique em "Conectar".

5
Anotar o codigo de verificacao

Apos conectar com sucesso, o display do DoguIA exibira um codigo de 6 digitos. Anote esse codigo — voce precisara dele no proximo passo para vincular o dispositivo no Painel.

Calibracao do Dispositivo

O DoguIA realiza calibracoes automaticas para garantir o melhor desempenho:

Calibracao do Microfone

Na primeira vez que voce falar com o DoguIA (via navegador web), ele realiza uma calibracao automatica de 2 segundos. Nesse momento, fique em silencio — o sistema esta medindo o nivel de ruido ambiente para ajustar o limiar de deteccao de voz.

Calibracao dos Servos

Os 4 servos do DoguIA (patas dianteiras e traseiras) ja vem calibrados de fabrica com posicoes neutras pre-definidas. A calibracao e armazenada na memoria NVS do dispositivo e e preservada mesmo em atualizacoes de firmware.

Memoria NVS (Non-Volatile Storage)

A regiao NVS do ESP32 armazena dados criticos como credenciais Wi-Fi, calibracao de sensores e configuracoes do dispositivo. Essa regiao e preservada automaticamente em atualizacoes de firmware quando feitas pelo Painel.

Assistente de Configuracao (Wizard)

O wizard guia voce em 5 passos para configurar completamente seu DoguIA.

Acesse o wizard em doguia.com.br/painel/#/wizard. Antes de iniciar, um alerta importante aparece pedindo que voce conecte o dispositivo ao carregador para evitar desligamentos durante a configuracao.

Passo 1

Wi-Fi

Este passo exibe um video tutorial (YouTube) mostrando como conectar o DoguIA ao Wi-Fi. Assista ao video para entender o processo visual e, quando estiver pronto, avance para o proximo passo.

Se voce ja configurou o Wi-Fi antes, pode pular este passo clicando em "Proximo".
Passo 2

Dispositivo (Codigo de Verificacao)

Aqui voce vincula o dispositivo fisico ao sistema. O DoguIA exibe um codigo de 6 digitos no display apos conectar ao Wi-Fi.

Codigo de Verificacao
1
2
3
4
5
6

Digite os 6 digitos exibidos no display do DoguIA. Cada caixa aceita apenas 1 numero e o cursor avanca automaticamente. Use Backspace para voltar.

Passo 3

Modelo de IA

Neste passo voce da um nome ao seu agente e escolhe qual modelo de inteligencia artificial ele vai usar.

Nome do Agente
Ex: Marvin, Rex, Buddy, Luna...

Este sera o nome pelo qual seu DoguIA se apresentara e respondera. Ao dizer "qual seu nome?", ele dira esse nome. Pode ser qualquer nome que voce quiser.

Modelo de IA

Escolha o "cerebro" do seu DoguIA. Cada modelo tem caracteristicas diferentes:

XiaoZhi Lite
Padrao
Respostas rapidas e leves. Ideal para a maioria dos usos. Recomendado para iniciantes.
Qwen
Recomendado
Respostas rapidas e naturais. Excelente para conversacao fluida e execucao confiavel dos comandos do robo.
DeepSeek V4
Avancado
Raciocinio profundo e respostas elaboradas. Ideal para perguntas complexas, analise e tarefas que exigem mais inteligencia.
DouBao Seed 2.0
Robusto
Modelo da ByteDance com boa compreensao contextual e respostas detalhadas.
Clique no botao ao lado de cada modelo para ver uma descricao detalhada.
Passo 4

Voz

Escolha como seu DoguIA vai soar! Selecione o idioma e a voz de sintese (TTS).

Idioma

Selecione o idioma principal do agente. O DoguIA sera instruido a sempre responder nesse idioma. Idiomas disponiveis incluem Portugues, Ingles, Espanhol, Frances, Alemao, Italiano, Japones, Coreano, Chines e Russo.

Portugues aparece sempre primeiro na lista por padrao.
Voz TTS

Para cada idioma, ha diversas opcoes de voz com timbres diferentes — vozes masculinas, femininas e neutras. Clique no botao ao lado de cada voz para ouvir uma demonstracao antes de escolher.

Somente uma demonstracao toca por vez. Ao clicar em outra voz, a anterior para automaticamente.
Passo 5

Personalidade

Defina o comportamento e a personalidade do seu DoguIA. Este e o campo mais criativo!

Templates de Personalidade

Selecione um template pre-pronto clicando nos chips. Cada template preenche automaticamente o campo de texto abaixo com uma personalidade detalhada. Templates disponiveis:

Companheiro Guardiao Filhote Curioso Professor Terapeuta Secretario Gourmet Atleta Poliglota Financeiro Contador de Historias Cuidador Tech Nerd Jardineiro DJ Musical
Texto de Personalidade

Escreva livremente como voce quer que seu DoguIA se comporte. Voce pode personalizar completamente ou editar um template. Limite de 1.000 caracteres.

Exemplo: "Voce e um cachorro-robo chamado Rex, muito brincalhao e curioso. Adora fazer piadas e sempre tenta animar o dono. Quando feliz, faz uma dancinha especial."

O que e adicionado automaticamente?

O sistema adiciona automaticamente ao texto da personalidade:

  • Bloco [Identidade] — Define o nome do agente para que ele saiba como se apresentar.
  • Regras Obrigatorias — Instrucoes tecnicas para que o robo execute movimentos fisicos corretamente (use ferramentas, nao peca confirmacao, etc).
  • Idioma Obrigatorio — Instrucao para que sempre responda no idioma selecionado.

Conclusao

Ao finalizar o wizard, o sistema executa automaticamente:

  1. Cria o agente com o nome escolhido
  2. Vincula o dispositivo fisico usando o codigo de verificacao
  3. Aplica todas as configuracoes (modelo, voz, personalidade)
  4. Ativa automaticamente as habilidades MCP (movimentos, luzes, melodias)

Apos isso, seu DoguIA esta pronto para conversar! Basta falar com ele.

Aplicativo DoguIA para Celular

Controle seu cachorro-robo direto do seu celular ou tablet, em qualquer lugar.

Baixar o Aplicativo

O DoguIA tem um app oficial para Android e iPhone:

Google Play
App Store

Tela Inicial

Apos abrir o app, você ve:

  • Card do robo — mostra o nome, bateria e status
  • Botoes de controle — ligar/desligar, conectar, versão do firmware
  • Status da bateria — quanto tempo falta de carga
  • Menu — acesso ao painel, Wi-Fi e mais

Tela do Robo (Controlar)

Clique no card do robo para entrar no modo de controle:

  • Conversar — segure o botao para falar com ele
  • Botoes de movimento — andar, pular, dançar
  • Cores e luzes — mude a cor dos olhos
  • Sons — faça ele latir, roncar, cantar

Conectar no Robo Local (WiFi)

Você pode controlar o robo sem internet, so ligado no mesmo WiFi:

1
Ligue o robo e conecte no WiFi da sua casa

Veja a secao "Conectar Wi-Fi" acima para instruçoes.

2
Abra o app no seu celular

O app automaticamente procura o robo na sua rede e mostra uma opçao "Controle Local".

3
Clique em "Controle Local" ou "Conectar"

Pronto! Agora voce pode controlar sem internet.

Modo Demonstração (Demo)

Pode experimentar sem ter um robo fisico! O app tem um robo virtual:

  • Basta entrar em modo demo na tela inicial
  • Um robo tridimensional aparece na tela
  • Voce pode falar com ele e ve-lo se mover
  • Perfeito para testar antes de comprar

Painel do Agente — Configuracoes Avancadas

Apos criar seu agente pelo wizard, voce pode ajustar tudo em detalhes pelo painel.

Acesse em doguia.com.br/painel/#/agents → clique no seu agente. O painel tem 7 abas:

Aba 1: Configuracao

A aba principal onde voce ajusta todas as configuracoes do agente.

Configuracoes Gerais

Nome do Agente
Texto

O nome pelo qual o DoguIA se apresenta. Altere quando quiser dar um novo nome.

Modelo IA
Selecao

Troque o modelo de IA a qualquer momento. Cada modelo tem velocidade e capacidade diferentes.

Voz e Idioma

Idioma
Selecao

Ao trocar o idioma, as vozes disponiveis sao automaticamente filtradas para o idioma selecionado.

Voz TTS
Selecao + Preview

Teste diferentes vozes clicando no play. A voz sera usada para todas as respostas faladas.

Velocidade da Fala
Selecao

Lenta, Normal ou Rapida. Ajuste conforme sua preferencia de velocidade de fala.

Nomes e Memoria

Nome Assistente
Texto

Nome usado no bloco de identidade. Normalmente igual ao nome do agente.

Nome Usuario
Texto

Como o DoguIA vai te chamar. Padrao: "Dono".

Memoria
Selecao

Desligada: esquece tudo apos cada conversa. Curto Prazo: lembra durante a conversa atual. Longo Prazo: lembra entre conversas diferentes. Recomendado: Longo Prazo.

Personalidade

Textarea grande para definir a personalidade (limite: 2.500 caracteres no painel). Possui:

  • Dropdown de Templates — Selecione um template para preencher automaticamente.
  • Botao Otimizar — Usa IA para melhorar e refinar seu texto de personalidade.
  • Contador de Caracteres — Mostra quantos caracteres voce ja usou.
Lembre-se de clicar em "Salvar Configuracao" apos fazer alteracoes. O sistema confirma se a personalidade foi salva corretamente.

Aba 2: Dispositivos

Gerencie os dispositivos fisicos vinculados ao agente.

Vincular Dispositivo

Clique em "Vincular" e insira o codigo de 6 digitos do display do DoguIA para adicionar um novo dispositivo.

Renomear

De um apelido ao dispositivo para identificar facilmente (ex: "DoguIA da Sala", "DoguIA do Quarto").

Status Online/Offline

Indica em tempo real se o dispositivo esta conectado e funcionando (verde = online, cinza = offline).

Auto-update

Checkbox que ativa/desativa atualizacao automatica de firmware. Quando ativo, o dispositivo atualiza sozinho.

Desvincular

Remove o dispositivo do agente. O dispositivo precisara ser vinculado novamente com um novo codigo.

Aba 3: Conversas

Historico completo de todas as conversas que o DoguIA teve.

  • Expandir — Clique em uma conversa para ver todas as mensagens trocadas.
  • Audio — Mensagens com audio incluem um player para ouvir a gravacao.
  • Duracao — Mostra quanto tempo durou cada conversa.
  • Excluir — Apague conversas individuais quando desejar.

Aba 4: Reconhecimento de Voz

Configure perfis de locutores para que o DoguIA reconheca quem esta falando.

  • Adicionar Locutor — Selecione uma amostra de voz (gravada automaticamente pelo dispositivo), de um nome (ex: "Papai", "Mamae") e uma descricao opcional.
  • Preview — Ouca a amostra de voz antes de confirmar para garantir que e a pessoa certa.
  • Remover — Delete perfis que nao sao mais necessarios.

Aba 5: Habilidades (MCP)

Gerencie as habilidades do DoguIA baseadas no protocolo MCP (Model Context Protocol).

MCP Endpoint

Gera uma URL WebSocket (wss://...) para conectar ferramentas MCP externas ao seu agente. Copie a URL com um clique.

Ativar/Desativar Funcoes

Cada habilidade possui varias funcoes individuais. Ative ou desative cada funcao conforme sua necessidade e clique em "Salvar Alteracoes".

Logs em Tempo Real

Visualize os logs do processo MCP para depuracao. Mostra chamadas de ferramentas (azul), resultados (verde) e erros (vermelho).

Reiniciar Servico

Reinicia o processo MCP caso ele pare de responder ou apresente erros.

Aba 6: Conhecimento

Crie bases de conhecimento para que o DoguIA tenha acesso a informacoes especificas.

  • Criar Base — De um nome (ex: "FAQ do Produto", "Manual Tecnico") e descricao.
  • Organizacao — Cada base e identificada por nome e descricao para facil referencia.
  • Excluir — Remova bases que nao sao mais necessarias.

Aba 7: Memorias

Veja e edite as memorias que o DoguIA acumulou durante as conversas.

  • Editar — Cada memoria e editavel. Altere o texto e clique no para salvar.
  • Excluir Individual — Remova memorias especificas que voce nao quer que o DoguIA lembre.
  • Limpar Tudo — Apague todas as memorias de uma vez (acao irreversivel).
A aba de memorias so funciona se a memoria estiver ativada na aba Configuracao (Curto ou Longo Prazo).

Atualizacao de Firmware

Mantenha seu DoguIA sempre com a versao mais recente do firmware.

Acesse em doguia.com.br/painel/#/firmware, em um computador. A instalacao acontece dentro do proprio navegador, sem instalar nenhum programa.

Como funciona?

Sao 3 passos, e leva cerca de 2 minutos:

1
Conecte o cabo

Ligue um cabo USB-C no DoguIA e a outra ponta no computador. Precisa ser um cabo de dados — o mesmo que carrega o celular serve, desde que nao seja um cabo so de carga.

2
Clique em "Instalar firmware" e escolha o aparelho

O navegador abre uma janelinha com a lista de aparelhos conectados. Escolha o que aparecer e clique em Conectar. E a unica vez que voce escolhe o aparelho. Se o DoguIA nao aparecer na lista, o painel explica como entrar no modo de gravacao: desconecte o cabo, segure o botao da placa (fica atras da cabeca), conecte o cabo com o botao apertado e so entao solte.

3
Aguarde e reconecte

A barra de progresso mostra o andamento. Nao desconecte o cabo nem feche a janela durante a gravacao. Ao terminar, desconecte o cabo USB e conecte de novo — e isso que liga o DoguIA no firmware novo. Depois e so recolocar a cabeca.

Antes de gravar qualquer coisa, o painel le qual chip esta conectado e confere se o firmware serve para ele. Se nao servir, a instalacao para sem escrever nada.

Deu erro no meio. Estraguei o DoguIA?

Quase certamente nao. O modo de gravacao do chip fica numa memoria que nao pode ser apagada, entao o DoguIA sempre aceita uma nova tentativa — mesmo que a gravacao anterior tenha parado no meio e ele nao esteja mais ligando.

Repita a instalacao entrando no modo de gravacao na mao: desconecte o cabo, segure o botao da placa, conecte o cabo com o botao apertado, solte o botao e clique em "Instalar firmware" de novo. Se o erro se repetir, troque o cabo por um de dados e ligue direto no computador, sem hub USB.

Preservacao de Dados (NVS)

Quando a atualizacao e feita pelo Painel, o firmware e dividido em partes que pulam a regiao NVS (Non-Volatile Storage). Isso garante que:

Credenciais Wi-Fi
Calibracao dos servos
Configuracoes do dispositivo
Dados de ativacao
A gravacao escreve so as partes do firmware, pulando a regiao onde ficam esses dados. Nao existe opcao de "apagar tudo" na tela.

Requisitos e Compatibilidade

Google Chrome
Microsoft Edge
Opera
Firefox 151 ou mais novo
Safari (nao suportado)
Celular e tablet (nao suportado)

A conversa com o cabo USB depende da Web Serial API, que existe so em navegador de computador e so em paginas https://. Em celular e tablet nao ha como gravar. Se o seu navegador nao servir, a propria tela avisa antes de voce comecar.

Habilidades MCP — Movimentos, Luzes e Melodias

Tudo que seu DoguIA pode fazer fisicamente, controlado por IA via protocolo MCP.

Como ativar uma habilidade

Toda habilidade do DoguIA é acionada por voz: basta falar com ele em português natural. A IA interpreta o pedido e dispara a habilidade certa via MCP.

  1. Acorde o DoguIA — espere o LED indicar que ele está ouvindo (ou diga o nome dele se você configurou wake-word).
  2. Fale o que você quer em linguagem natural, sem precisar decorar comando. Ex: "da uma volta", "toca uma música feliz", "modo filhote".
  3. Combine habilidades numa só frase: "Faz a coreografia de boas-vindas com luz arco-íris".
Dica: as habilidades convivem com o chat normal — você pode conversar e pedir movimentos na mesma conversa.

50+ Movimentos

Seu DoguIA possui 68 movimentos pre-programados divididos em categorias. Basta pedir por voz!

Locomocao

Movimentos de deslocamento e caminhada.

Andar para frente Andar para tras Virar esquerda Virar direita Parar Trotar Galopar Moonwalk
Exemplo de comando por voz: "Anda pra frente!" / "Faz o moonwalk!" / "Vira pra esquerda"

Posturas

Posicoes estaticas e de descanso.

Deitar Sentar Recolher patas Dormir
Exemplo: "Senta!" / "Deita ai" / "Hora de dormir"

Gestos

Gestos expressivos e interativos.

Reverencia Dar a pata Pedir (implorar) Espiar Farejar Cumprimentar Abanar rabo Cocar Cutucar Inclinar
Exemplo: "Da a patinha!" / "Abana o rabo!" / "Faz reverencia"

Acrobacias

Movimentos avancados e atleticos.

Pular pra frente Bananeira (plantar) Dar bote Flexoes Corcovear Pular no lugar
Exemplo: "Faz uma bananeira!" / "Faz flexao!" / "Pula!"

Danca e Expressao

Dancas, alongamentos e expressoes corporais.

Dancar Balancar Yoga Alongar Sapateado Shimmy Marchar Twist
Exemplo: "Danca pra mim!" / "Faz yoga!" / "Marca passo!"

Truques Especiais

Truques divertidos e dramaticos.

Se fingir de morto Rolar Andar sorrateiro Pulo de coelho Acenar Tippy taps Estampar patinhas
Exemplo: "Finge de morto!" / "Rola!" / "Faz sneaky!"

20 Reacoes Emocionais

O DoguIA combina automaticamente movimento + LED para reagir a emocoes. Basta conversar naturalmente que a IA decide qual reacao usar.

😊FelizAbanar rabo + LED dourado
😢TristeDeitar + LED azul
😠BravoTremer + LED vermelho
😰AssustadoSobressaltar + LED roxo
🤩EmpolgadoGirar feliz + LED laranja
😍ApaixonadoCumprimentar + LED rosa
🤔CuriosoFarejar + LED verde
😴SonolentoDormir + LED azul
🧐PensandoEspiar + LED branco
👏OrgulhosoFlexoes + LED laranja
😵ConfusoTonto + LED roxo
🎉FestivoSapateado + LED magenta

Efeitos de LED

O DoguIA possui 4 LEDs RGB WS2812 com 16,7 milhoes de cores. Alem de cores solidas, tem efeitos animados:

PoliciaVermelho/azul alternando
Arco-irisEspectro completo
PulsacaoBrilho pulsante branco
FogoChamas laranja/vermelho
BatimentoPulso duplo vermelho
RespiracaoOnda ciano suave
DiscoCores aleatorias
AuroraVerde/azul/roxo
VelaChama amarela tremula
Exemplo de comando: "Liga o efeito arco-iris!" / "Faz a luz de policia!" / "Acende a vela"

15 Coreografias

Sequencias pre-programadas que combinam varios movimentos em ordem:

Boas-vindasReverencia → Cumprimento → Abanar rabo
Show de DancaDancar → Girar → Moonwalk → Reverencia
Hora de DormirAlongar → Yoga → Dormir
BrincadeiraPular → Galopar → Andar → Abanar
GuerreiroFlexoes → Bananeira → Pular → Reverencia
FofuraImplorar → Dar pata → Abanar → Reverencia
ExercicioAlongar → Flexoes → Yoga → Andar
PalhacoTonto → Moonwalk → Cocar → Girar
PredadorFarejar → Espiar → Pular → Abanar
MeditacaoSentar → Yoga → Alongar → Sentar
NinjaSorrateiro → Bote → Pular → Reverencia
Show de TruquesBananeira → Rolar → Corcovear → Acenar
SapateioSapateado → Shimmy → Marchar → Reverencia
Drama QueenSobressaltar → Morto → Tremer → Cumprimentar
AquecimentoPisar → Tippy taps → Twist → Pular
Exemplo: "Faz o show de danca!" / "Faz a coreografia de boas-vindas!" / "Modo ninja!"

Jogos Interativos

O DoguIA tem jogos interativos que voce pode jogar por voz:

Quiz de Animais

Perguntas de multipla escolha sobre animais. 3 dificuldades: facil, medio e dificil. O DoguIA reage conforme voce acerta ou erra!

Diga: "Vamos jogar quiz!" ou "Quiz dificil!"
Imitar Animais

O DoguIA imita 10 animais diferentes com movimentos e luzes: gato, passaro, cobra, urso, coelho, macaco, pinguim, touro, tartaruga e cachorro!

Diga: "Imita um gato!" ou "Faz de macaco!"
Adestramento

Treine seu DoguIA com exercicios em 3 niveis: basico (sentar, deitar, dar pata), intermediario (reverencia, implorar) e avancado (flexoes, bananeira, moonwalk).

Diga: "Vamos treinar!" ou "Treino avancado!"
Simon Says (Memoria)

Jogo de memoria com sequencias de movimentos. 10 rodadas progressivas — cada rodada adiciona um movimento novo!

Diga: "Vamos jogar Simon Says!"
Historias Interativas

5 temas de historias narradas com movimentos: Aventura, Misterio, Ninar, Circo e Espaco. O DoguIA atua enquanto conta!

Diga: "Conta uma historia de aventura!" ou "Historia pra dormir!"

200+ Melodias

O DoguIA pode tocar melodias no buzzer! Sao mais de 200 musicas organizadas por categoria:

Infantis 45+ musicas

Brilha Brilha Estrelinha, Parabens, Marcha Soldado, Cai Cai Balao...

Natal 5+ musicas

Jingle Bells, Noite Feliz, We Wish You...

Classico 30+ musicas

Bach, Mozart, Vivaldi, Beethoven, Chopin...

Cinema/TV 30+ musicas

Star Wars, Harry Potter, James Bond, Missao Impossivel...

Games 25+ musicas

Mario, Zelda, Sonic, Pokemon, Tetris...

Rock/Pop 30+ musicas

Beatles, Queen, Michael Jackson, AC/DC...

Brasil 30+ musicas

Garota de Ipanema, Aquarela, Asa Branca, Mas que Nada...

Alertas 10+ sons

Sirene, Campainha, Alarme, Sucesso, Nokia...

Exemplo: "Toca a marcha imperial!" / "Toca Garota de Ipanema!" / "Toca o tema do Mario!"

5 Modos de Personalidade

Alem da personalidade configurada no Painel, voce pode ativar modos temporarios por voz:

🐶
Filhote

Animado e cheio de energia! Abana o rabo o tempo todo, pula de empolgacao.

🦵
Velho Sabio

Calmo e ponderado. Fica sentado, faz reverencias suaves, pondera antes de agir.

🤡
Brincalhao

Travesso e imprevisivel! Danca, surpreende, faz piadas com movimentos inesperados.

😰
Medroso

Timido e cauteloso. Espia antes de agir, se assusta facilmente, movimentos contidos.

🏋
Atleta

Energico e competitivo! Faz flexoes, pula, exercicios e esta sempre ativo.

Exemplo: "Modo filhote!" / "Seja um velho sabio!" / "Ativa modo atleta!"

Bateria e Autonomia

Entenda como funciona a bateria do seu DoguIA.

Como Funciona (Nao e um Sensor)

O DoguIA nao tem sensor de bateria. Entao como sabe quanto de carga tem?

Simples: o firmware calcula o consumo de energia ao longo do tempo. E como contar quanto dinheiro voce gastou — o robo sabe o quanto usa a cada minuto e vai contando.

Por isso o percentual que mostra (ex: ~62%) nao e 100% preciso. E uma estimativa, como dizer "acho que tenho 2 horas de bateria". Quando voce realmente sabe? Quando a bateria acaba!

Quanto de Tempo Falta?

Ao inves de percentual, o app mostra quantas horas faltam:

  • Bateria cheia = 2 horas
  • Meia bateria = 1 hora
  • Bateria baixa = menos de 30 minutos

Essa escala de 2 horas nao muda — e sempre a mesma.

Como Carregar

1
Desconecte o robo

Coloque-o na base carregadora.

2
Aguarde carregar

O LED pisca durante o carregamento e fica fixo quando esta cheio.

3
Informe ao app quando carregar terminou

Clique em "Bateria Carregada" no menu. Isso reinicializa a contagem.

Importante: O app nao sabe sozinho que terminou de carregar. Voce precisa clicar no botao para ele resetar a estimativa.

Quando a Bateria Acaba (Brownout)

Se a bateria realmente esvaziar, o robo desliga sozinho. Isso se chama "brownout".

Quando isso acontece, o app mostra um aviso especial: "a bateria esta muito fraca". Isso e a unica certeza de que a bateria esta realmente acabando — mesmo que o percentual diga outra coisa.

Se ver esse aviso, carregue o robo imediatamente.

Volume e Protecao da Audicao

Configure o volume com seguranca.

Como Funciona o Volume

O DoguIA pode ficar bem alto — ate 200%! Mas existe um limite seguro para nao prejudicar a audicao:

  • Nivel Seguro = ate 100% (totalmente seguro)
  • Acima de 100% = cuidado, pode machucar os ouvidos
  • Maximo = 200% (so use por pouco tempo)

Aviso de Seguranca

Quando voce tenta aumentar o volume acima de 100%, o app mostra um aviso:

"Cuidado! Volume alto pode prejudicar seus ouvidos. Tem certeza?"

Voce pode clicar "Sim, aumentar" ou "Nao, manter seguro".

Se clicar sim, o volume sobe. Mas voce so ve esse aviso uma vez por sessao do app — depois pode aumentar sem avisos.

Dicas de Uso

  • Para criancas pequenas, mantenha sempre em 100% ou menos
  • Se vai usar acima de 100%, use so por alguns minutos
  • O firmware do robo tambem respeita o limite — nunca vai ficar mais alto que o permitido

Calibracao de Servos — Ajuste via doguia.local

Se os movimentos do DoguIA parecem tortos, desalinhados ou estranhos, a calibracao resolve.

Quando calibrar?

Voce deve calibrar os servos se perceber qualquer um destes sintomas:

  • Patas desalinhadas — O DoguIA nao fica reto em pe, uma pata fica mais alta ou baixa que as outras.
  • Movimentos tortos — Ao andar, ele puxa para um lado ou as patas se cruzam.
  • Posicao neutra errada — Em repouso, as patas nao ficam paralelas ou simetricas.
  • Ruidos mecanicos — Servos forcando porque estao calibrados fora do centro.
  • Apos trocar um servo — Se voce substituiu um servo motor, ele precisa ser recalibrado.

Hardware dos Servos

O DoguIA possui 4 servo-motores independentes (180 graus de amplitude) controlados por PWM a 50Hz:

FL
Dianteira Esquerda
GPIO 21
Neutro: 70°
FR
Dianteira Direita
GPIO 19
Neutro: 110°
DoguIA
BL
Traseira Esquerda
GPIO 20
Neutro: 110°
BR
Traseira Direita
GPIO 18
Neutro: 70°
Note o padrao espelhado: as patas esquerdas tem neutro em 70° e 110°, e as direitas o inverso. Isso porque os motores sao montados em lados opostos.

Como ajustar a calibracao

A interface de calibracao e acessada pelo navegador em http://doguia.local/ quando o DoguIA esta conectado na sua rede Wi-Fi.

1
Acessar a interface

Com o DoguIA ligado e conectado ao Wi-Fi, abra o navegador no computador ou celular (que esteja na mesma rede) e acesse http://doguia.local/. Se nao funcionar, tente http://192.168.X.X (o IP do DoguIA na sua rede).

2
Localizar os controles de porcentagem (%)

Na interface, voce encontrara 4 sliders de porcentagem, um para cada servo (FL, FR, BL, BR). Cada slider controla o offset (desvio) em relacao a posicao neutra do servo.

3
Entender os valores

O valor de porcentagem representa quanto o servo desvia do seu ponto neutro:

0%
Posicao neutra (padrao de fabrica) — pata centralizada
+%
Desloca o servo no sentido positivo (para frente nas patas direitas, para tras nas esquerdas)
-%
Desloca o servo no sentido negativo (para tras nas patas direitas, para frente nas esquerdas)
4
Ajustar cada pata

Movimente o slider de cada servo em pequenos incrementos (1-3% por vez) ate que a pata fique na posicao desejada. O DoguIA vai mover a pata em tempo real conforme voce ajusta.

Coloque o DoguIA em uma superficie plana e ajuste ate que as 4 patas fiquem paralelas e o corpo fique nivelado.
5
Salvar a calibracao

Apos ajustar, clique em Salvar. Os valores sao gravados na memoria NVS do dispositivo e persistem mesmo apos atualizacoes de firmware (desde que feitas pelo Painel).

Valores Padrao de Fabrica

Se voce precisa restaurar os valores originais, estes sao os valores padrao de cada servo:

Servo Posicao GPIO Neutro Offset Padrao Range Seguro
FL Dianteira Esq. GPIO 21 70° 0% -50 a +50
FR Dianteira Dir. GPIO 19 110° 0% -50 a +50
BL Traseira Esq. GPIO 20 110° 0% -50 a +50
BR Traseira Dir. GPIO 18 70° 0% -50 a +50

Sobre os motores espelhados

Os motores sao montados em lados opostos do corpo, entao para o mesmo movimento fisico:

  • Pata para frente: lado direito (FR, BR) = offset positivo, lado esquerdo (FL, BL) = offset negativo
  • Pata para tras: lado direito = offset negativo, lado esquerdo = offset positivo
  • Abaixar corpo: FL negativo, FR positivo, BL positivo, BR negativo

O range maximo e de -80 a +80, mas recomendamos ficar entre -50 a +50 para evitar forcamento mecanico.

Dicas de Calibracao

Ajuste em superficie plana

Sempre calibre com o DoguIA apoiado em uma mesa ou superficie plana e nivelada.

Ajuste pouco a pouco

Mude 1-3% por vez. Movimentos bruscos podem forcar as engrenagens do servo.

Teste com um movimento simples

Apos calibrar, peca ao DoguIA para "sentar" ou "ficar em pe" para verificar se os movimentos estao corretos.

Nao ultrapasse o range seguro

Evite valores acima de +50 ou abaixo de -50. Valores extremos (-80/+80) podem causar travamento mecanico e danificar os servos.

Calibracao e persistente

Os valores ficam salvos na NVS e sobrevivem a reinicializacoes e atualizacoes de firmware feitas pelo Painel.

Som picotado — calibrar a reserva de audio

Quando a fala do DoguIA sai cortada, o conserto quase sempre e este — e ele nao exige abrir o robo.

Por que a fala pica

O DoguIA nao guarda a resposta inteira antes de falar: o audio chega da internet em pedacinhos de alguns milissegundos e ele vai reproduzindo. Se um pedaco atrasa, o alto-falante fica sem dado novo por um instante — e e isso que se ouve como estalo ou corte no meio da frase. Nao e peca queimada nem alto-falante ruim.

A defesa e guardar um pouco de audio adiantado antes de comecar a falar. Guardar mais deixa a fala lisa e a resposta um tiquinho mais lenta; guardar menos e o contrario. O aplicativo chama isso de reserva, e ela tem quatro niveis: Rapido, Padrao, Estavel e Maximo.

Como calibrar, pelo aplicativo

O caminho e Operar o robo → Avancado → Calibrar o som, com o robo ligado e na mesma rede Wi-Fi do celular. O aplicativo nao pede que voce escolha um nivel no escuro: ele faz um teste de verdade.

  1. Fazer ele falar. O robo conta uma historia curta. E durante a fala que o defeito existe, e e durante a fala que da para medir.
  2. O aplicativo mede. Enquanto ele fala, sao lidos os contadores do proprio robo: falhas no meio da fala, esperas no comeco e a maior interrupcao.
  3. O veredito. Sai em portugues: a fala saiu lisa, ou faltou reserva, ou o problema e outro. Se faltou reserva, o botao seguinte ja sobe um nivel e ouve de novo.
  4. Repete ate sair liso. Ai aparece Guardar no robo — e e esse toque que faz o ajuste sobreviver ao proximo desligamento.
Dois casos que subir a reserva NAO resolve

Quando o audio nao chega do servidor, o problema e a rede — nenhuma reserva inventa o que nao foi recebido, e o aplicativo trava os botoes para voce nao gastar reserva a toa. E quando falta memoria no robo, ele desce um nivel sozinho: foi longe demais.

Experimentar nao grava nada

Trocar de nivel vale na hora, inclusive com ele falando, e nao escreve na memoria do robo. So o botao de guardar grava. Sem guardar, tudo volta ao normal quando ele reiniciar — e assim de proposito, para um ajuste ruim se desfazer sozinho.

O nivel Maximo tem preco

Na maior reserva a memoria do robo fica no limite e a carinha dele pode travar de vez em quando. Pode ser exatamente a troca que voce quer — desde que seja escolha, e nao surpresa.

Da para voltar atras

O botao Restaurar o padrao devolve o ajuste de fabrica e esquece o que estava guardado — inclusive para o robo acompanhar as melhorias das proximas versoes de firmware, em vez de ficar preso no ajuste de hoje.

E a palavra magica?

O DoguIA padrao nao tem palavra de despertar: ele nao fica escutando a espera de um nome, e chamar por ele em voz alta nao faz nada. A conversa comeca com um toque no botao da cabeca — ou pelo aplicativo, tocando no rosto dele na tela inicial. Nao e defeito: sem escuta continua, o microfone so entra em acao quando alguem toca no robo.

O DoguIA Pro tem o detector no proprio aparelho e aceita uma palavra sua, com duas condicoes: duas palavras ou mais e escrita em ingles — o reconhecedor dele so sabe pronunciar ingles, entao hey doggy dispara e ei cachorrinho e aceito, grava sem erro e nunca funciona. Ela passa a valer depois de reiniciar o robo, porque a lista de palavras e carregada uma vez, ao ligar.

Antes de calibrar, confira o basico

Picote e quase sempre sinal de Wi-Fi fraco no lugar onde o robo esta. Aproxime do roteador e teste: se resolver, nao ha o que calibrar. A calibracao existe para a casa onde o sinal e o que e e nao da para melhorar.

Perguntas Frequentes

Duvidas comuns respondidas de forma direta.

Na maioria das vezes e por causa da internet movel. O endereco doguia.local so funciona quando o celular esta somente no Wi-Fi, na mesma rede do DoguIA. Desative os dados moveis (3G/4G/5G) e tente de novo. Se ainda assim nao abrir, digite o IP direto no navegador: http://192.168.4.1 (durante a configuracao) ou o IP do DoguIA na sua rede.

Atualmente: XiaoZhi Lite (padrao, rapido e leve), Qwen (recomendado, respostas naturais), DeepSeek V4 (raciocinio avancado) e DouBao Seed 2.0 (robusto, boa compreensao). Voce troca a qualquer momento na aba "Configuracao" do painel.

Nao. O DoguIA precisa de conexao Wi-Fi ativa para funcionar, pois a inteligencia artificial roda em servidores na nuvem. Sem internet, ele nao consegue processar voz nem responder.

Sim! Voce pode trocar o modelo de IA a qualquer momento pela aba "Configuracao" no painel do agente. Basta selecionar outro modelo e clicar em "Salvar Configuracao".

A memoria permite que o DoguIA lembre informacoes entre conversas. Com memoria de longo prazo, ele lembra seu nome, preferencias e contexto de conversas anteriores. Voce pode ver e editar essas memorias na aba "Memorias" do painel.

Para resetar as configuracoes do agente, voce pode deletar o agente no painel e criar um novo pelo wizard. Para resetar o firmware e Wi-Fi, faca uma atualizacao de firmware usando um arquivo binario "merged" (unico), que sobrescreve toda a memoria incluindo NVS.

Sim! Na aba "Dispositivos" voce pode vincular varios DoguIAs ao mesmo agente. Todos compartilharao a mesma personalidade, modelo e configuracoes.

Recomendamos manter o firmware atualizado para ter acesso a novos recursos e correcoes. A atualizacao e feita pelo menu Firmware, com o DoguIA ligado por cabo USB a um computador. Leva cerca de 2 minutos.

Nao! Quando a atualizacao e feita pelo Painel, o sistema preserva automaticamente o Wi-Fi, calibracao e dados do dispositivo (NVS). As configuracoes do agente (personalidade, modelo, voz) ficam no servidor e nao sao afetadas.

O painel de gerenciamento funciona em qualquer navegador moderno. Ja a atualizacao de firmware depende da Web Serial API: funciona no Google Chrome, Microsoft Edge, Opera e no Firefox 151 ou mais novo, sempre em computador. Safari e navegadores de celular nao conseguem gravar — a propria tela avisa antes de voce comecar.

MCP (Model Context Protocol) e o protocolo que permite ao DoguIA executar acoes fisicas como movimentos, luzes e melodias. As habilidades MCP sao os "servicos" que traduzem comandos de voz em acoes fisicas no robo. Elas sao ativadas automaticamente ao criar o agente pelo wizard.

Sim! O DoguIA suporta animacoes com keyframes. A IA pode criar movimentos ineditos combinando posicoes dos 4 servos em sequencia. Tambem tem 15 padroes geradores (onda, batimento, samba, robot, etc) que criam movimentos dinamicos. Basta descrever o que voce quer: "Faz um movimento de samba!" ou "Cria uma danca nova!"

Alguns dispositivos e redes nao suportam mDNS. Nesse caso, tente acessar http://192.168.4.1 diretamente no navegador. Certifique-se de que voce esta conectado na rede Wi-Fi do DoguIA (DoguIA-XXXXX) e nao na sua rede domestica.

Verifique: (1) Se o dispositivo esta online (indicador verde no painel). (2) Se o Wi-Fi esta funcionando. (3) Se as habilidades MCP estao ativas na aba "Habilidades". (4) Tente reiniciar o servico MCP clicando no botao de reiniciar na aba "Habilidades".