استخدام "الأدوات" مع Gemini API

توسّع الأدوات إمكانات نماذج Gemini، ما يتيح لها اتّخاذ إجراءات في العالم الحقيقي والوصول إلى المعلومات في الوقت الفعلي وتنفيذ مهام حسابية معقّدة. يمكن للنماذج استخدام الأدوات في التفاعلات العادية بين الطلب والاستجابة وفي جلسات البث المباشر في الوقت الفعلي باستخدام Live API.

الأدوات هي إمكانات محدّدة (مثل "بحث Google" أو "تنفيذ التعليمات البرمجية") يمكن للنموذج استخدامها للإجابة عن طلبات البحث. توفّر Gemini API مجموعة من الأدوات المضمّنة المُدارة بالكامل، أو يمكنك تحديد أدوات مخصّصة باستخدام استدعاء الدوال.

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

الأدوات المضمّنة المتاحة

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

يمكنك الاطّلاع على صفحة الأسعار للحصول على تفاصيل حول التكاليف المرتبطة بأدوات معيّنة.

طريقة تنفيذ الأدوات

تسمح الأدوات للنموذج بطلب تنفيذ إجراءات أثناء المحادثة. يختلف مسار العمل حسب ما إذا كانت الأداة مضمّنة (تديرها Google) أو مخصّصة (تديرها أنت).

مسار الأداة المضمَّنة

بالنسبة إلى الأدوات المضمّنة (مثل "بحث Google" و"خرائط Google" و"سياق عنوان URL" و"البحث عن الملفات" و"تنفيذ الرموز البرمجية")، تتم العملية بأكملها من خلال طلب واحد من واجهة برمجة التطبيقات:

  1. أنت ترسل طلبًا: "ما هو الجذر التربيعي لأحدث سعر لسهم GOOG؟"
  2. يقرّر Gemini أنّه بحاجة إلى أدوات وينفّذها على خوادم Google (مثلاً، يبحث عن سعر السهم، ثم ينفّذ رمز Python البرمجي لحساب الجذر التربيعي).
  3. يرسل Gemini الردّ النهائي استنادًا إلى نتائج الأداة.

سير عمل الأداة المخصّصة (استدعاء الدالة)

بالنسبة إلى الأدوات المخصّصة واستخدام الكمبيوتر، يتعامل تطبيقك مع التنفيذ:

  1. أنت ترسل طلبًا مع إشعارات الدوال (الأدوات).
  2. قد يرسل Gemini رمز JSON منظَّمًا لاستدعاء دالة معيّنة (مثل {"name": "get_order_status", "args": {"order_id": "123"}})، ويكون مصحوبًا دائمًا بمعرّف فريد id.
  3. أنت تنفّذ الدالة في تطبيقك أو بيئتك.
  4. ترسل نتائج الدالة إلى Gemini مع id نفسه الذي تم استخدامه في طلب الدالة.
  5. يستخدم Gemini النتائج لإنشاء رد نهائي أو استدعاء أداة أخرى.

يمكنك الاطّلاع على مزيد من المعلومات في دليل استخدام ميزة "استدعاء الدوال".

الجمع بين أدوات مدمجة ومخصّصة

بالنسبة إلى الطلبات التي تجمع بين الأدوات المضمّنة والأدوات المخصّصة (عمليات استدعاء الدوال)، يستخدم النموذج تداول سياق الأداة لتنسيق التنفيذ في بيئات مختلفة:

  1. أنت ترسل طلبًا وتحدّد الأدوات المضمّنة والوظائف المخصّصة التي تريد تفعيلها، مع ضبط علامة لتفعيل إمكانية الدمج.
  2. ينفّذ Gemini أدوات مضمّنة ويستجيب لطلب المستخدم إذا تم إنشاء أي طلبات استدعاء لوظائف من جهة العميل (يعتمد ترتيب التنفيذ على الطلب وما يقرّره النموذج). يرسل هذا الإجراء ردًا يتضمّن ما يلي:
    • تأكيد استدعاء الأداة
    • نتائج استجابة الأداة (قد تظهر بعد JSON إذا أنشأ النموذج استدعاءَين متوازيين للدالة)
    • ملف JSON منظَّم لاستدعاء الدالة
    • توقيعات الأفكار المشفّرة للحفاظ على السياق
  3. أنت تنفّذ الدالة في تطبيقك أو بيئتك.
  4. أنت ترسل جميع أجزاء ردّ Gemini، بالإضافة إلى نتائج استدعاء الدالة.
  5. ينشئ Gemini الردّ النهائي باستخدام كل السياق المدمج.

اطّلِع على دليل دمج الأدوات لمعرفة كيفية تفعيل إمكانية دمج الأدوات المضمّنة والمخصّصة، وللاطّلاع على أمثلة على تداول السياق.

المخرجات المنظَّمة مقابل استدعاء الدالة

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

مُخرجات منظَّمة باستخدام الأدوات

يمكنك دمج النتائج المنظَّمة مع الأدوات المضمَّنة لضمان التزام ردود النموذج المستندة إلى بيانات خارجية أو عمليات حسابية بمخطط صارم.

يمكنك الاطّلاع على النتائج المنظَّمة باستخدام الأدوات للاطّلاع على أمثلة على الرموز.