Solución de problemas del servicio del Asistente de Google
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Problemas con las credenciales
Cuando intentas generar credenciales con la herramienta de autorización, esta te solicita que visites una URL y accedas a tu Cuenta de Google. Luego, la página muestra un mensaje de error (por ejemplo, "Se produjo un error").
Problemas de permisos
Asistente de Google responde: Algunos ajustes básicos necesitan tu permiso primero…
Problemas con el reconocimiento de voz
El Asistente responde No sé cómo puedo ayudarte con eso o No entiendo.
- Verifica que se haya reconocido tu voz correctamente. Verifica el resultado del código de muestra para obtener una transcripción de la solicitud del usuario. También puedes consultar Mi actividad. Puedes reproducir el audio que recibe Asistente para verificar si hay problemas de calidad. Si escuchas demasiado ruido o el audio se distorsiona, verifica que el micrófono esté configurado correctamente o prueba con otro.
Problemas relacionados con los atributos
El asistente no reconoce un rasgo que agregaste a un modelo.
Problemas con las acciones del dispositivo
El Asistente de Google responde que tu app no es compatible con tu dispositivo.
- En la Consola de Actions, puedes establecer las capacidades de la superficie de tu app para el Asistente. Si configuras la salida de pantalla como obligatoria, tus acciones personalizadas no funcionarán. Por el momento, el SDK de Asistente de Google no admite capacidades de pantalla.
Consulta también
Asistencia
¿Sigues teniendo problemas? Consulta nuestra página de Asistencia.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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."]]