排查 Google 助理服务问题
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
凭据问题
尝试使用授权工具生成凭据时,该工具会提示您访问某个网址并登录您的 Google 账号。然后,该页面会显示一条错误消息(例如“出了点问题”)。
权限问题
Google 助理会回答:实际上,有些基本设置需要您先授予权限…
语音识别问题
Google 助理会回答我不知道如何提供这方面的帮助或我不明白。
- 验证您的声音是否已正确识别。检查示例代码输出,查看用户请求的转写内容。您还可以查看我的活动记录。您可以播放助理收到的音频,以检查是否存在音频质量问题。如果您听到过大的噪音或音频失真,请检查麦克风是否配置正确,或尝试使用其他麦克风。
特征问题
Google 助理无法识别您添加到模型中的特征。
设备操作问题
Google 助理会回应说,您的设备不支持该应用。
- 在 Actions 控制台中,您可以设置 Google 助理应用的支持平台功能。如果您将屏幕输出设置为必需,自定义操作将无法正常运行。Google Assistant SDK 目前不支持屏幕功能。
另请参阅
- Google 助理服务示例 README 的问题排查部分
支持
如果您仍遇到问题,请参阅我们的支持页面。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\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."]]