對話動作已於 2023 年 6 月 13 日淘汰。詳情請參閱「
對話動作已淘汰」。
Google 助理服務疑難排解
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
憑證問題
使用授權工具產生憑證時,工具會提示您前往網址並登入 Google 帳戶。然後頁面會顯示錯誤訊息 (例如「發生錯誤」)。
權限問題
Google 助理會回覆「有一些基本設定需要先經過您的許可...」
語音辨識問題
Google 助理回應「我不知道該如何提供協助」或「我不瞭解」。
- 確認系統是否正確辨識你的聲音。檢查使用者要求的轉錄稿範例程式碼輸出內容。你也可以查看「我的活動」頁面。你可以播放 Google 助理收到的音訊,檢查音訊品質問題。如果聽到過多噪音或音訊失真,請檢查麥克風是否設定正確,或嘗試使用其他麥克風。
特徵問題
Google 助理無法辨識您新增至模型的特徵。
裝置動作問題
Google 助理會回應,表示裝置不支援該應用程式。
- 在 Actions 管理中心,您可以設定 Google 助理應用程式的介面功能。如果將螢幕輸出設為必要,自訂動作將無法運作。Google 助理 SDK 目前不支援螢幕功能。
另請參閱
- Google 助理服務範例 README 的「疑難排解」部分
支援
問題仍未解決?請參閱「支援」頁面。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間: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."]]