عیب یابی Google AI Studio

در صورت بروز مشکل، این صفحه پیشنهادهایی برای عیب‌یابی Google AI Studio ارائه می‌دهد.

خطاهای ۴۰۳ با دسترسی محدود را درک کنید

اگر خطای ۴۰۳ Access Restricted را مشاهده می‌کنید، به این معنی است که از Google AI Studio به روشی استفاده می‌کنید که از شرایط خدمات پیروی نمی‌کند. یکی از دلایل رایج این است که شما در یک منطقه پشتیبانی‌شده قرار ندارید.

حل مشکل عدم نمایش محتوا در گوگل AI Studio

اگر محتوا به هر دلیلی مسدود شده باشد، پیام «محتوای وجود ندارد» در Google AI Studio ظاهر می‌شود. برای مشاهده جزئیات بیشتر، نشانگر ماوس را روی «محتوای وجود ندارد» نگه دارید و روی «ایمنی» کلیک کنید.

اگر پاسخ به دلیل تنظیمات ایمنی مسدود شده باشد و شما خطرات ایمنی را برای مورد استفاده خود در نظر گرفته باشید، می‌توانید تنظیمات ایمنی را برای تأثیرگذاری بر پاسخ برگشتی تغییر دهید.

اگر پاسخ مسدود شده باشد اما نه به دلیل تنظیمات ایمنی، ممکن است پرس‌وجو یا پاسخ، شرایط خدمات را نقض کند یا به هر دلیلی پشتیبانی نشود.

بررسی میزان استفاده و محدودیت‌های توکن

وقتی یک اعلان (prompt) باز است، دکمه‌ی پیش‌نمایش متن (Text Preview) در پایین صفحه، توکن‌های فعلی مورد استفاده برای محتوای اعلان و حداکثر تعداد توکن‌ها برای مدل مورد استفاده را نشان می‌دهد.

مجوزهای IAM گوگل کلود برای AI Studio

اعضای یک پروژه Google Cloud برای انجام اقدامات در Google AI Studio به مجوزهای خاص مدیریت هویت و دسترسی (IAM) نیاز دارند. برای اطلاعات بیشتر در مورد این هویت‌ها، به مرور کلی اصول IAM مراجعه کنید.

کاربرانی که نقش ویرایشگر یا مالک را در پروژه مرتبط با Google Cloud دارند، مجوزهای کامل برای مشاهده داشبوردها و مدیریت کلیدهای API Gemini را دارند. کاربرانی که نقش بیننده را دارند می‌توانند داشبوردها و کلیدهای API را مشاهده کنند، اما نمی‌توانند آنها را ایجاد، به‌روزرسانی یا حذف کنند.

برای کنترل دقیق‌تر، به جدول زیر برای مجوزهای خاص مورد نیاز برای هر ویژگی AI Studio مراجعه کنید. برای دستورالعمل‌های مربوط به نحوه اعطای این مجوزها، به بخش اعطای، تغییر و لغو دسترسی به منابع در مستندات Google Cloud مراجعه کنید.

ویژگی استودیوی هوش مصنوعی مجوزهای مورد نیاز IAM الزامات اضافی
جستجوی پروژه (وارد کردن پروژه‌ها) resourcemanager.projects.get
تغییر نام پروژه resourcemanager.projects.update
نمایش سطح سهمیه ناموجود
ایجاد کلید API مجوزهای جستجوی پروژه را داشته باشید، و:

apikeys.keys.create
serviceusage.services.enable
iam.serviceAccountApiKeyBindings.create
iam.serviceAccounts.create
فهرست کردن کلیدهای API مجوزهای جستجوی پروژه را داشته باشید، و:

apikeys.keys.list
serviceusage.services.get
پروژه Google Cloud باید رابط برنامه‌نویسی کاربردی زبان مولد (Generative Language API) را فعال داشته باشد.
تغییر نام کلیدهای API apikeys.keys.update
کلیدهای API را حذف کنید apikeys.keys.delete
داشبورد استفاده مجوزهای جستجوی پروژه را داشته باشید، و:

monitoring.timeSeries.list
داشبورد محدودیت نرخ مجوزهای داشبورد استفاده را داشته باشید، و:

cloudquotas.quotas.get
هزینه (سقف صورتحساب) billing.resourceCosts.get (برای مشاهده هزینه)
billing.resourcebudgets.read (برای مشاهده سقف بودجه)
billing.resourcebudgets.write (برای تنظیم سقف بودجه)
داشبورد صورتحساب billing.accounts.get

سایر بررسی‌های دسترسی

علاوه بر مجوزهای IAM گوگل کلود، AI Studio بررسی‌های امنیتی و انطباق را نیز انجام می‌دهد. اگر شرایط زیر را نداشته باشید، ممکن است با خطای PERMISSION_DENIED یا خطای محدودیت دسترسی در رابط کاربری AI Studio یا در پاسخ‌های API مواجه شوید:

  • بررسی‌های امنیتی: درخواست شما باید از بررسی‌های امنیتی خودکار عبور کند.
  • شرایط خدمات: شما باید شرایط خدمات گوگل و شرایط خدمات اضافی هوش مصنوعی مولد را بپذیرید.
  • منطقه پشتیبانی‌شده: شما باید در یک منطقه پشتیبانی‌شده قرار داشته باشید.
  • اعتماد و ایمنی: پروژه گوگل کلود نباید به دلیل سوءاستفاده علامت‌گذاری شود.