Como solucionar problemas do serviço do Google Assistente
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Problemas de credenciais
Ao tentar gerar credenciais com a ferramenta de autorização, ela solicita que você acesse um URL e faça login na sua Conta do Google. Em seguida, a página mostra uma mensagem de erro, por exemplo, "Algo deu errado".
Problemas de permissões.
O Google Assistente responde Então, existem algumas configurações básicas que precisam da sua permissão antes de continuarmos...
Problemas com o reconhecimento de voz
O Google Assistente responde Não sei como ajudar com isso ou Não entendi.
- Verifique se sua voz foi reconhecida corretamente. Confira a saída do exemplo de código para uma transcrição da solicitação do usuário. Você também pode acessar
Minha atividade. Você
pode reproduzir o áudio recebido pelo Google Assistente para verificar problemas de
qualidade. Se você ouvir muito ruído ou se o áudio estiver distorcido, verifique se o microfone está configurado corretamente ou use outro.
Problemas de traços
O Google Assistente não reconhece uma característica que você adicionou a um modelo.
Problemas com as ações do dispositivo
O Google Assistente responde dizendo que o app não é compatível com seu dispositivo.
- No Actions Console, você
pode definir os recursos de superfície do seu app Google Assistente. Se você definir a saída
de tela como obrigatória, suas ações personalizadas não vão funcionar. No momento, o SDK do Google Assistente não é compatível com recursos de tela.
Consulte também
Suporte
Ainda está com problemas? Acesse nossa página de Suporte.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eEnsure the Google Assistant API is enabled and the OAuth consent screen is properly configured to resolve credential issues.\u003c/p\u003e\n"],["\u003cp\u003eVerify activity controls are set for the account used during authorization setup to address permission problems.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshoot voice recognition issues by reviewing the voice transcript, checking audio quality, and microphone configuration.\u003c/p\u003e\n"],["\u003cp\u003eFor trait-related problems, confirm trait addition to the model and re-register the device instance after model updates.\u003c/p\u003e\n"],["\u003cp\u003eIf encountering device action issues, review surface capabilities settings in the Actions Console, ensuring screen output is not required.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting the Google Assistant Service\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/service/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/service/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/service/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\nSee also\n--------\n\n- [Troubleshooting](https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-sdk/googlesamples/assistant/grpc#troubleshooting) section of the Google Assistant Service sample README\n\nSupport\n-------\n\nStill having trouble? See our [Support](/assistant/sdk/support) page."]]
