اكتب استدعاءات Gemini API باستخدام gemini-api-dev وفق الممارسات الفضلى

لمن يناسب

استخدم مكتبة المهارات هذه عندما تريد أن يكتب وكيل شيفرة استدعاء لـ Gemini API وSDK وتفاعلات النموذج. المصدر يصفها كمكتبة مهارات لـ Gemini API وSDK وتفاعلات النموذج، ويسمّي على حدة gemini-api-dev: تطوير تطبيقات ضد Interactions API، يغطي توليد النص والحوار متعدد الجولات والخرج المتدفق واستدعاء الدوال والخرج المنظم وتوليد الصور وDeep Research agents وحواجز النماذج المهجورة وSDK لـ Python وTypeScript. الوثائق:

https://ai.google.dev/gemini-api/docs/interactions?ua=chat

المستودع الرسمي:

https://github.com/google-gemini/gemini-skills

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

المصدر يكتب أيضًا: هذا ليس منتجًا من Google مدعومًا رسميًا ولا يمكنه المشاركة في Google Open Source Software Vulnerability Reward Program. أرقام التقييم تبين فقط أنه بعد تثبيت المهارة يتغير معدل توليد الوكيل لشيفرة API صحيحة. لا تعتبر ذلك معيار نجاح لاستدعاء واحد على جهازك. لا تستنتج أن المهارة تُستخدم فقط على النموذجين المذكورين في التقييم. قد تحتوي المكتبة مهارات أخرى، لكن المصدر يكتب gemini-api-dev فقط كمثال تثبيت قابل للنسخ. في المرة الأولى لا تسمّ مهارات لم تظهر.

أنهِ أول محاولة في 3 دقائق

افتح أولاً المستودع الرسمي وتحقق:

https://github.com/google-gemini/gemini-skills

المسار الموصى به هو npx skills add الرسمي. في المرة الأولى تصفّح فقط؛ لا تثبّت أولاً كومة مهارات. التصفّح تفاعلي؛ قبل التنفيذ أكّد أنك تعرض القائمة فقط:

npx skills add google-gemini/gemini-skills --list

بعد رؤية القائمة المثال الملموس من المصدر هو gemini-api-dev. التثبيت يكتب ملفات مهارة على هذا الجهاز؛ قبل التنفيذ أكّد أنك تريد هذه الواحدة فقط:

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

لا تغيّرها إلى اسم مهارة لم يظهر ولا تخترع مثبّتًا ثانيًا. المصدر لا يكتب مجلد هبوط؛ لا تخترع مسارًا.

في المرة الأولى داخل الوكيل تحقق فقط؛ لا تستدعِ API حية بعد، ولا تولّد صورًا ولا تبدأ Deep Research. اطلب من الوكيل أن يذكر أي قدرات Interactions API يغطيها gemini-api-dev، وأن هذا ليس منتج Google مدعومًا رسميًا. نقطة الرصد: يستطيع ترديد توليد النص والحوار متعدد الجولات والخرج المتدفق واستدعاء الدوال والخرج المنظم وSDK لـ Python وTypeScript، ولم يخرج إلى الشبكة بعد.

كتابة شيفرة استدعاء حقيقية تخرج إلى الشبكة وقد تستهلك حصة. تابع فقط عندما تكون جاهزًا لاستخدام بيانات اعتماد Gemini الخاصة بك؛ المصدر لا يعطي اسم حقل مفتاح، فلا تكتب مفتاحًا نائبًا. في المرة الأولى لا تلمس توليد الصور أو Deep Research.

حالات استخدام

الحالة 1: تصفّح أولاً ثم ثبّت مهارة واحدة. نفّذ npx skills add google-gemini/gemini-skills --list، أكّد أنك ترى مهارات في القائمة ثم ثبّت gemini-api-dev. يناسب من يريد فقط ربط مهارة Interactions API بوكيل وليس جاهزًا بعد لإرسال طلبات. إشارة النجاح: يستطيع list أن يفتح وينتهي أمر تثبيت المهارة المسماة طبيعيًا. المصدر لا يكتب حقول list الكاملة؛ لا تخترع أسماء --skill أخرى.

الحالة 2: تحقق أولاً من نطاق التوصيل ثم قرر هل تكتب شيفرة. بعد تثبيت gemini-api-dev اجعل الوكيل يردد أنه يغطي توليد النص والحوار متعدد الجولات والخرج المتدفق واستدعاء الدوال والخرج المنظم وتوليد الصور وDeep Research agents وحواجز النماذج المهجورة وSDK لـ Python وTypeScript. يناسب من يخشى أن يخرج الوكيل فورًا إلى الشبكة أو يولّد صورًا. إشارة النجاح: يستطيع بيان النطاق بوضوح ويعترف أن هذا ليس منتجًا مدعومًا رسميًا. عندما تحتاج استدعاءً حقيقيًا أكّد أولاً أن هذه الجولة ستصل إلى Gemini API وأعد أنت بيانات الاعتماد؛ المصدر لا يعطي معاملات طلب نموذجية، لا تخترعها. لا تعامل أرقام Gemini 3 Flash وGemini 3.1 Pro في التقييم كمرجع يجب أن تعيده.

حدود الاستخدام

المسار الرئيسي هو npx skills add google-gemini/gemini-skills، التصفّح بـ --list، مهارة المثال --skill gemini-api-dev. لا تخترع أسماء مهارات أو مثبّتات أخرى. المصدر يقول إنه يمكن التثبيت في مساعدات البرمجة بالذكاء الاصطناعي ومديري حزم شائعين، لكنه لا يسمّي منتجات؛ لا تضف قائمة أسماء ولا تكتبها كنطاق حصري.

هذا ليس منتج Google مدعومًا رسميًا. ملاحظات برنامج مكافأة الثغرات:

https://bughunters.google.com/open-source-security

القدرة تتوقف عند بنود Interactions API أعلاه وSDK الاثنين. توليد الصور وDeep Research لهما آثار جانبية خارجية؛ لا تفعلهما في المرة الأولى. المصدر لا يكتب حقول مفتاح أو حصة أو خطوات إزالة. لا تُكمل أسماء نماذج أو أسماء عملاء أو معاملات طلب غير مكتوبة. نجاح المرة الأولى هو أمر التصفّح أو انتهاء التثبيت وترديد الوكيل للنطاق فقط؛ قبل الخروج إلى الشبكة يجب تأكيد بيانات الاعتماد وأن هذه الجولة ستصل إلى API. المصدر لا يكتب أوامر إزالة أو تحديث؛ لا تخترع مثبّتًا ثانيًا. إن بدأ الوكيل توليد صور أو إطلاق Deep Research فتوقف أولاً وعد إلى الشرح للقراءة فقط. نسب التقييم لا تحل محل إشارة نجاحك لمرة واحدة.