راهنمای عیب یابی

از این راهنما برای کمک به تشخیص و حل مشکلات رایجی که هنگام فراخوانی API Gemini پیش می‌آیند، استفاده کنید. ممکن است با مشکلاتی از سرویس backend API Gemini یا SDK های کلاینت مواجه شوید. SDK های کلاینت ما در مخازن زیر به صورت متن باز ارائه می‌شوند:

• پایتون-ژنای
• js-genai
• گو-گنای

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

کدهای خطای سرویس Backend API Gemini

جدول زیر کدهای خطای رایج backend که ممکن است با آنها مواجه شوید را به همراه توضیحاتی در مورد علل و مراحل عیب‌یابی آنها فهرست می‌کند:

خطاهای پارامترهای مدل را در فراخوانی‌های API خود بررسی کنید

بررسی کنید که پارامترهای مدل شما در محدوده مقادیر زیر باشند:

علاوه بر بررسی مقادیر پارامترها، مطمئن شوید که از نسخه API صحیح (مثلاً /v1 یا /v1beta ) و مدلی که از ویژگی‌های مورد نیاز شما پشتیبانی می‌کند، استفاده می‌کنید. برای مثال، اگر یک ویژگی در نسخه بتا باشد، فقط در نسخه API /v1beta در دسترس خواهد بود.

بررسی کنید که آیا مدل مناسبی دارید یا خیر

تأیید کنید که از مدل پشتیبانی‌شده‌ای که در صفحه مدل‌های ما ذکر شده است استفاده می‌کنید.

تأخیر بالاتر یا استفاده از توکن با مدل‌های ۲.۵

اگر در مدل‌های ۲.۵ فلش و پرو شاهد تأخیر یا استفاده از توکن بالاتری هستید، می‌تواند به این دلیل باشد که این مدل‌ها به طور پیش‌فرض دارای قابلیت تفکر برای افزایش کیفیت هستند . اگر سرعت برایتان در اولویت است یا نیاز به کاهش هزینه‌ها دارید، می‌توانید قابلیت تفکر را تنظیم یا غیرفعال کنید.

برای راهنمایی و نمونه کد به صفحه تفکر مراجعه کنید.

مسائل ایمنی

اگر مشاهده کردید که به دلیل تنظیمات امنیتی در فراخوانی API شما، اعلان مسدود شده است، اعلان را با توجه به فیلترهایی که در فراخوانی API تنظیم کرده‌اید، بررسی کنید.

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

مسئله تلاوت

اگر مشاهده کردید که مدل به دلیل RECITATION تولید خروجی را متوقف می‌کند، این بدان معناست که خروجی مدل ممکن است شبیه داده‌های خاصی باشد. برای رفع این مشکل، سعی کنید prompt/context را تا حد امکان منحصر به فرد کنید و از دمای بالاتری استفاده کنید.

مشکل توکن‌های تکراری

اگر نشانه‌های خروجی مکرر را مشاهده کردید، پیشنهادات زیر را برای کاهش یا حذف آنها امتحان کنید.

          # Markdown Table Format
          
          * Separator line: Markdown tables must include a separator line below
            the header row. The separator line must use only 3 hyphens per
            column, for example: |---|---|---|. Using more hypens like
            ----, -----, ------ can result in errors. Always
            use |:---|, |---:|, or |---| in these separator strings.

            For example:

            | Date | Description | Attendees |
            |---|---|---|
            | 2024-10-26 | Annual Conference | 500 |
            | 2025-01-15 | Q1 Planning Session | 25 |

          * Alignment: Do not align columns. Always use |---|.
            For three columns, use |---|---|---| as the separator line.
            For four columns use |---|---|---|---| and so on.

          * Conciseness: Keep cell content brief and to the point.

          * Never pad column headers or other cells with lots of spaces to
            match with width of other content. Only a single space on each side
            is needed. For example, always do "| column name |" instead of
            "| column name                |". Extra spaces are wasteful.
            A markdown renderer will automatically take care displaying
            the content in a visually appealing form.
        

        When thinking silently: ALWAYS start the thought with a brief
        (one sentence) recap of the current progress on the task. In
        particular, consider whether the task is already done.
      

بهبود خروجی مدل

برای خروجی‌های مدل با کیفیت بالاتر، نوشتن دستورالعمل‌های ساختاریافته‌تر را بررسی کنید. صفحه راهنمای مهندسی دستورالعمل، برخی از مفاهیم اساسی، استراتژی‌ها و بهترین شیوه‌ها را برای شروع کار معرفی می‌کند.

محدودیت‌های توکن را درک کنید

برای درک بهتر نحوه شمارش توکن‌ها و محدودیت‌های آنها، راهنمای توکن ما را مطالعه کنید.

مشکلات شناخته شده

• این API فقط از تعدادی زبان منتخب پشتیبانی می‌کند. ارسال درخواست‌ها به زبان‌های پشتیبانی نشده می‌تواند پاسخ‌های غیرمنتظره یا حتی مسدود شده ایجاد کند. برای به‌روزرسانی‌ها به زبان‌های موجود مراجعه کنید.

ثبت اشکال

اگر سوالی دارید، به بحث در انجمن توسعه‌دهندگان هوش مصنوعی گوگل بپیوندید.