Solução de problemas na Biblioteca Google Assistente
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Instalar/fazer upgrade da biblioteca
Você recebe uma mensagem de erro semelhante a E: Unable to locate package python3-venv
enquanto tenta configurar um novo ambiente virtual de Python.
Em versões mais antigas do Ubuntu, o pacote meta para a biblioteca virtual Python 3
(python3-venv) não está disponível. Use uma versão totalmente qualificada
como alternativa:
sudo apt-get install python3-dev python3.4-venv
Você recebe uma mensagem de erro semelhante a No matching distribution found
ou <wheel> is not a supported wheel on this platform.
Verifique a arquitetura de hardware:
uname -a Linux raspberrypi 4.9.24-v7+ #993 SMP Wed Apr 26 18:01:23 BST 2017 armv7l GNU/Linux
A biblioteca só tem suporte em hardwares com linux-armv7l e linux-x86_64
arquitetônicas. Para outro hardware, use o serviço do Google Assistente.
como alternativa.
Problemas com credenciais
Ao tentar gerar credenciais com a ferramenta de autorização, a ferramenta solicita
que você acesse um URL e faça login na sua Conta do Google. A página mostra
(por exemplo, "Algo deu errado").
O Google Assistente responde Não sei como ajudar com isso ou Não sei como ajudar.
entender.
Verifique se sua voz foi reconhecida corretamente. Conferir o exemplo de código
saída para uma transcrição da solicitação do usuário. Você também pode ver
minha atividade. Você
pode tocar o áudio recebido pelo Google Assistente para verificar a qualidade do áudio
problemas. Se você ouvir muito ruído ou o áudio estiver distorcido, verifique
se o microfone está configurado corretamente ou tente uma
ao microfone do meu dispositivo.
Problemas de traços
O Google Assistente não reconhece uma característica que você adicionou a um modelo.
Se você gerou uma instância de dispositivo para um modelo, essa instância não será
é atualizado automaticamente quando o modelo é alterado por outros usuários. Você precisa
registre de novo a instância do dispositivo de forma manual usando a ferramenta de linha de comando de registro.
ou a API REST.
O está disponível
ID da instância do dispositivo
na saída da amostra.
Problemas de ações no dispositivo
O Google Assistente responde informando que seu app não é compatível com seu
dispositivo.
No Console do Actions,
pode definir os recursos de superfície do seu app do Assistente. Se você configurar a tela
saída seja obrigatória, suas ações personalizadas não funcionarão. A página
No momento, o SDK do Assistente não é compatível com recursos de tela.
Problemas de hotword
O Google Assistente parece não responder a frases que começam com Ok Google ou
Ok Google.
Se você ainda tiver pouco ou nenhum reconhecimento de sua voz, tente calibrar
a sensibilidade do microfone:
Encerre (Ctrl+C) qualquer exemplo de código que esteja em execução no momento.
Execute este comando:
export ASSISTANT_MIC_SENSITIVITY=-6
Execute o exemplo de código e tente de novo. Volte para a etapa 1, mas continue descendo
o valor de ASSISTANT_MIC_SENSITIVITY em intervalos de -6 (por exemplo, -6, -12,
-18, -24...) até achar que o reconhecimento de voz é o ideal. Se você
chegar a -60, verifique seu microfone.
Problemas com alarmes e timers
O Google Assistente não segue comandos verbais (por exemplo, pausar)
ou interromper um timer).
Este é um problema se você tiver o estado StartStop
ou OnOff ativada para um
modelo de dispositivo específico. Remova essa característica do modelo do dispositivo e
vão funcionar.
Problemas ao abrir podcasts e notícias
O Google Assistente não segue os comandos de reprodução (por exemplo, pausar)
ou interromper um podcast).
Este é um problema se você tiver o estado StartStop
ou OnOff ativada para um determinado
modelo de dispositivo. Remova essa característica do modelo do dispositivo e dos comandos de reprodução
vai funcionar.
Problemas de transmissão
O Google Assistente não pode transmitir mensagens de um dispositivo para outro.
Defina a localização do dispositivo no app Google Assistente.
Os dois dispositivos precisam ter o mesmo endereço no app.
Suporte
Ainda está com problemas? Consulte nossa página de suporte.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eThe Google Assistant Library for Python is deprecated; use the Google Assistant Service instead.\u003c/p\u003e\n"],["\u003cp\u003eThe library is supported only on hardware with linux-armv7l and linux-x86_64 architectures.\u003c/p\u003e\n"],["\u003cp\u003eFor credential issues, ensure the Google Assistant API is enabled and the OAuth consent screen is configured.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshoot voice recognition by checking audio quality, microphone configuration, and user request transcript.\u003c/p\u003e\n"],["\u003cp\u003eFor device action issues, avoid requiring screen output in the Actions Console, as the SDK doesn't currently support it.\u003c/p\u003e\n"]]],["The Google Assistant Library for Python is deprecated; use the Google Assistant Service instead. Common issues include: virtual environment errors (install `python3-dev python3.4-venv`), hardware architecture mismatch (only `linux-armv7l` and `linux-x86_64` supported), credential errors (enable the API and OAuth), permission problems (set activity controls), voice recognition problems (check audio quality and microphone), trait issues (register traits and re-register devices), device action problems (don't require screen output), hotword issues (adjust mic sensitivity), and issues with certain traits (remove `StartStop` and `OnOff` traits).\n"],null,["# Troubleshooting the Google Assistant Library\n\n| **Warning:** The Google Assistant Library for Python is deprecated as of June 28th, 2019. Use the [Google Assistant Service](/assistant/sdk/guides/service/python) instead.\n\n\u003cbr /\u003e\n\nInstalling/upgrading the library\n--------------------------------\n\nYou get an error message similar to `E: Unable to locate package python3-venv`\nwhile trying to configure a new Python virtual environment.\n\n- On older versions of Ubuntu, the meta package for the Python 3 virtual\n environment (`python3-venv`) is not available. Use a fully-qualified version\n instead:\n\n ```\n sudo apt-get install python3-dev python3.4-venv\n ```\n\nYou get an error message similar to `No matching distribution found`\nor `\u003cwheel\u003e is not a supported wheel on this platform`.\n\n- Check the hardware architecture:\n\n ```\n uname -a\n Linux raspberrypi 4.9.24-v7+ #993 SMP Wed Apr 26 18:01:23 BST 2017 armv7l GNU/Linux\n ```\n\n \u003cbr /\u003e\n\n The library is only supported on hardware with linux-armv7l and linux-x86_64\n architectures. For other hardware, use the [Google Assistant Service](/assistant/sdk/overview#sdk_components)\n instead.\n\nCredentials issues\n------------------\n\nWhen trying to generate credentials with the authorization tool, the tool prompts\nyou to visit a URL and sign in to your Google account. The page then displays an\nerror message (for example, \"Something went wrong\").\n\n- Make sure you enabled the Google Assistant API and configured the OAuth consent screen in [Configure a Developer Project and Account Settings](/assistant/sdk/guides/library/python/embed/config-dev-project-and-account#config-dev-project).\n\nPermissions issues\n------------------\n\nThe Google Assistant responds *Actually, there are some basic settings that need\nyour permission first...*\n\n- [Set activity controls](/assistant/sdk/guides/activity-controls) for the account that you used when setting the authorization code.\n\nVoice recognition issues\n------------------------\n\nAssistant responds *I don't know how to help with that* or *I don't\nunderstand.*\n\n- Verify that your voice was recognized properly. Check the sample code output for a transcript of the user request. You can also look at [my activity](https://myactivity.google.com/myactivity?restrict=vaa). You can play the audio received by the Assistant to check for audio quality issues. If you hear excessive noise or if the audio is distorted, check that your microphone is configured properly or try a different microphone.\n\nTrait issues\n------------\n\nAssistant does not recognize a trait that you added to a model.\n\n- Make sure the trait was added to the model\n (see [Register Traits for the\n Device](/assistant/sdk/guides/library/python/extend/register-device-traits)).\n\n- If you generated a device instance for a model, the device instance will **not**\n automatically update when its model is changed by other users. You need to\n manually re-register the device instance using the [registration command line tool](/assistant/sdk/reference/device-registration/device-tool#register-device)\n or the [REST API](/assistant/sdk/reference/device-registration/register-device-manual#register-instance).\n You can find the\n [device instance ID](/assistant/sdk/guides/library/python/embed/run-sample#get-device-id)\n in the output of the sample.\n\nDevice Actions issues\n---------------------\n\nThe Google Assistant responds saying that your app is not supported on your\ndevice.\n\n- In the [Actions Console](https://console.actions.google.com/), you can set the surface capabilities of your Assistant app. If you set screen output to be required, your custom actions will not function. The Google Assistant SDK does not support screen capabilities at this time.\n\nHotword issues\n--------------\n\nAssistant does not seem to respond to sentences that begin with *Ok Google* or\n*Hey Google*.\n\n- If you still get little to no recognition of your voice, try calibrating\n your microphone sensitivity:\n\n 1. Terminate (Ctrl+C) any sample code that is currently running.\n 2. Run the following command: \n\n ```\n export ASSISTANT_MIC_SENSITIVITY=-6\n ```\n 3. Run the sample code and try again. Go back to step 1, but keep lowering the `ASSISTANT_MIC_SENSITIVITY` value in intervals of -6 (e.g., -6, -12, -18, -24...) until you find that voice recognition is optimal. If you get to -60, check your microphone.\n\nAlarms and timers issues\n------------------------\n\nThe Assistant does not follow verbal commands (for example, pausing\nor stopping a timer).\n\n- This is an issue if you have the [StartStop](/assistant/sdk/reference/traits/startstop) or [OnOff](/assistant/sdk/reference/traits/onoff) trait enabled for a given device model. Remove this trait from the device model and verbal commands will work.\n\nPodcast and news playback issues\n--------------------------------\n\nThe Assistant does not follow playback commands (for example, pausing\nor stopping a podcast).\n\n- This is an issue if you have the [StartStop](/assistant/sdk/reference/traits/startstop) or [OnOff](/assistant/sdk/reference/traits/onoff) trait enabled for a given device model. Remove this trait from the device model and playback commands will work.\n\nBroadcast issues\n----------------\n\nThe Assistant cannot broadcast messages from one device to the other.\n\n- Make sure to set the device location in the Google Assistant [app](/assistant/sdk/reference/assistant-app/assistant-settings). Both devices must have the same address in the app.\n\nSupport\n-------\n\nStill having trouble? See our [Support](/assistant/sdk/support) page."]]
