دليل تحديد المشاكل وحلّها

استخدِم هذا الدليل لمساعدتك في تشخيص المشاكل الشائعة التي تحدث عند استدعاء Gemini API وحلّها. قد تواجه مشاكل من خدمة الخلفية لواجهة Gemini API أو حِزم تطوير البرامج (SDK) الخاصة بالعميل. حِزم تطوير البرامج (SDK) الخاصة بالعملاء هي مفتوحة المصدر في المستودعات التالية:

• python-genai
• js-genai
• go-genai

إذا واجهت مشاكل في مفتاح واجهة برمجة التطبيقات، تأكَّد من إعداد المفتاح بشكلٍ صحيح وفقًا لدليل إعداد مفتاح واجهة برمجة التطبيقات.

رموز الخطأ في خدمة الخلفية لواجهة Gemini API

يسرد الجدول التالي رموز الأخطاء الشائعة في الخلفية التي قد تواجهها، بالإضافة إلى توضيحات حول أسبابها وخطوات تحديد المشاكل وحلّها:

التحقّق من طلبات البيانات من واجهة برمجة التطبيقات بحثًا عن أخطاء في مَعلمات النموذج

تأكَّد من أنّ مَعلمات النموذج تندرج ضمن القيم التالية:

بالإضافة إلى التحقّق من قيم المَعلمات، تأكَّد من أنّك تستخدم إصدار واجهة برمجة التطبيقات الصحيح (على سبيل المثال، /v1 أو /v1beta) والطراز الذي يتوافق مع الميزات التي تحتاج إليها. على سبيل المثال، إذا كانت إحدى الميزات في إصدار تجريبي، ستتوفّر فقط في إصدار واجهة برمجة التطبيقات /v1beta.

التأكّد من أنّ لديك الطراز المناسب

تأكَّد من استخدام طراز متوافق مُدرَج في صفحة الطُرز.

زيادة وقت الاستجابة أو استخدام الرموز المميزة مع نماذج 2.5

إذا لاحظت زيادة في وقت الاستجابة أو استخدام الرموز المميزة مع طرازَي Flash 2.5 وPro، قد يكون ذلك بسبب تفعيل ميزة "التفكير" تلقائيًا بهدف تحسين الجودة. إذا كنت تريد إعطاء الأولوية للسرعة أو تقليل التكاليف، يمكنك تعديل ميزة "التفكير" أو إيقافها.

يُرجى الرجوع إلى صفحة التفكير للحصول على إرشادات ورمز نموذجي.

مشاكل الأمان

إذا ظهرت لك رسالة تفيد بأنّه تم حظر طلب بسبب إعدادات الأمان في طلب البيانات من واجهة برمجة التطبيقات، راجِع الطلب مع مراعاة الفلاتر التي ضبطتها في طلب البيانات من واجهة برمجة التطبيقات.

إذا ظهرت لك BlockedReason.OTHER، قد يكون الطلب أو الرد مخالفًا لبنود الخدمة أو غير متوافق معها.

مشكلة في التلاوة

إذا ظهرت لك رسالة تفيد بأنّ النموذج توقّف عن إنشاء النتائج بسبب RECITATION، هذا يعني أنّ نتائج النموذج قد تشبه بيانات معيّنة. لحلّ هذه المشكلة، حاوِل جعل الطلب أو السياق فريدًا قدر الإمكان واستخدِم درجة حرارة أعلى.

مشكلة الرموز المميزة المتكررة

إذا ظهرت لك رموز مميّزة مكرّرة في الناتج، جرِّب الاقتراحات التالية للمساعدة في تقليلها أو إزالتها.

          # 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.
      

تحسين مخرجات النموذج

للحصول على نتائج أفضل من النماذج، ننصحك بتجربة كتابة طلبات أكثر تنظيمًا. تقدّم صفحة دليل هندسة الطلبات بعض المفاهيم الأساسية والاستراتيجيات وأفضل الممارسات لمساعدتك في البدء.

التعرّف على حدود الرموز المميزة

اطّلِع على دليل الرموز المميزة للتعرّف بشكل أفضل على كيفية احتساب الرموز المميزة وحدودها.

المشاكل المعروفة

• لا تتوافق واجهة برمجة التطبيقات إلا مع عدد من اللغات المحدّدة. قد يؤدي إرسال الطلبات بلغات غير متوافقة إلى ظهور ردود غير متوقّعة أو حتى محظورة. اطّلِع على اللغات المتاحة للتحديثات.

الإبلاغ عن خطأ

يمكنك الانضمام إلى المناقشة في منتدى مطوّري الذكاء الاصطناعي من Google إذا كانت لديك أسئلة.