عیب یابی سرویس دستیار گوگل
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مسائل مربوط به اعتبارنامه
هنگام تلاش برای ایجاد اعتبار با ابزار مجوز، این ابزار از شما می خواهد که از یک URL بازدید کرده و به حساب Google خود وارد شوید. سپس صفحه یک پیغام خطا را نمایش می دهد (به عنوان مثال، "مشکلی پیش آمد").
مسائل مربوط به مجوزها
دستیار Google پاسخ می دهد در واقع، برخی از تنظیمات اولیه وجود دارد که ابتدا به اجازه شما نیاز دارند...
مشکلات تشخیص صدا
دستیار پاسخ می دهد من نمی دانم چگونه در این مورد کمک کنم یا نمی فهمم.
- بررسی کنید که صدای شما به درستی شناسایی شده است. خروجی کد نمونه را برای رونوشت درخواست کاربر بررسی کنید. شما همچنین می توانید به فعالیت من نگاه کنید. میتوانید برای بررسی مشکلات کیفیت صدا، صدای دریافتشده توسط «دستیار» را پخش کنید. اگر نویز بیش از حد شنیدید یا صدا مخدوش است، بررسی کنید که میکروفون شما به درستی پیکربندی شده باشد یا میکروفون دیگری را امتحان کنید.
مسائل مربوط به صفت
«دستیار» ویژگیای را که به مدل اضافه کردهاید تشخیص نمیدهد.
مطمئن شوید که صفت به مدل اضافه شده است (به ثبت ویژگی های دستگاه مراجعه کنید).
اگر نمونه دستگاهی را برای یک مدل ایجاد کرده باشید، وقتی مدل آن توسط کاربران دیگر تغییر میکند، نمونه دستگاه بهطور خودکار بهروزرسانی نمیشود . باید به صورت دستی نمونه دستگاه را با استفاده از ابزار خط فرمان ثبت نام یا REST API دوباره ثبت کنید. می توانید پیدا کنید شناسه نمونه دستگاه در خروجی نمونه
مشکلات Device Actions
دستیار Google پاسخ می دهد که برنامه شما در دستگاه شما پشتیبانی نمی شود.
- در « کنسول کنشها» ، میتوانید قابلیتهای سطح برنامه «دستیار» خود را تنظیم کنید. اگر خروجی صفحه را مورد نیاز تنظیم کنید، اقدامات سفارشی شما کار نمی کنند. Google Assistant SDK در حال حاضر از قابلیت های صفحه نمایش پشتیبانی نمی کند.
همچنین ببینید
- بخش عیبیابی سرویس Google Assistant نمونه README
پشتیبانی کنید
هنوز مشکل دارید؟ صفحه پشتیبانی ما را ببینید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]