توسّع الأدوات إمكانات نماذج Gemini، ما يتيح لها اتّخاذ إجراءات في العالم والوصول إلى المعلومات في الوقت الفعلي وتنفيذ مهام حسابية معقّدة. يمكن للنماذج استخدام الأدوات في كلٍّ من التفاعلات العادية لطلب البيانات والاستجابة لها و جلسات البث في الوقت الفعلي باستخدام Live API.
الأدوات هي إمكانات محدّدة (مثل "بحث Google" أو "تنفيذ الرموز البرمجية") يمكن للنموذج استخدامها للإجابة عن الاستعلامات. توفر Gemini API مجموعة من الأدوات المضمّنة المُدارة بالكامل ، أو يمكنك تحديد أدوات مخصّصة باستخدام ميزة "استدعاء الدوال".
لإنشاء أنظمة متعدّدة الخطوات وموجّهة نحو تحقيق هدف، يُرجى الاطّلاع على نظرة عامة على الوكلاء.
الأدوات المضمّنة المتاحة
| الأداة | الوصف | حالات الاستخدام |
|---|---|---|
| بحث Google | تحديد مصادر موثوقة للردود من الأحداث والحقائق الحالية على الويب للحدّ من الهلوسة | الإجابة عن أسئلة حول الأحداث الأخيرة، والتأكّد من الحقائق باستخدام مصادر متنوّعة |
| خرائط Google | إنشاء مساعدين على دراية بالموقع الجغرافي يمكنهم العثور على الأماكن والحصول على الاتجاهات وتقديم سياق محلي غني | تخطيط برامج السفر التي تتضمّن محطات متعدّدة، والعثور على المؤسسات المحلية استنادًا إلى معايير المستخدم |
| تنفيذ الرموز البرمجية | السماح للنموذج بكتابة رموز Python البرمجية وتشغيلها لحلّ المسائل الرياضية أو معالجة البيانات بدقة | حلّ المعادلات الرياضية المعقّدة، ومعالجة البيانات النصية وتحليلها بدقة |
| سياق عنوان URL | توجيه النموذج لقراءة المحتوى وتحليله من صفحات ويب أو مستندات معيّنة | الإجابة عن الأسئلة استنادًا إلى عناوين URL أو مستندات معيّنة، واسترداد المعلومات من صفحات ويب مختلفة |
| استخدام الكمبيوتر (إصدار تجريبي) | السماح لـ Gemini بعرض شاشة وإنشاء إجراءات للتفاعل مع واجهات مستخدم متصفّح الويب (التنفيذ من جهة العميل) | تنفيذ عمليات سير العمل المتكرّرة المستندة إلى الويب تلقائيًا، واختبار واجهات مستخدم تطبيقات الويب |
| البحث عن الملفات | فهرسة مستنداتك والبحث فيها لتفعيل ميزة "التوليد المعزّز بالاسترجاع" (RAG) | البحث في الأدلة الفنية، والإجابة عن الأسئلة حول البيانات الخاصة |
يُرجى الاطّلاع على صفحة الأسعار لمعرفة تفاصيل التكاليف المرتبطة بأدوات معيّنة.
كيفية تنفيذ الأدوات
تسمح الأدوات للنموذج بطلب إجراءات أثناء المحادثة. يختلف سير العمل استنادًا إلى ما إذا كانت الأداة مضمّنة (تُديرها Google) أو مخصّصة (تُديرها أنت).
سير عمل الأداة المضمّنة
بالنسبة إلى الأدوات المضمّنة (مثل "بحث Google" و"خرائط Google" و"سياق عنوان URL" و"البحث عن الملفات" و"تنفيذ الرموز البرمجية")، تتم العملية بأكملها في طلب واحد من واجهة برمجة التطبيقات:
- أنت ترسل طلبًا: "ما هو الجذر التربيعي لأحدث سعر لسهم GOOG؟"
- يقرّر Gemini أنّه بحاجة إلى أدوات وينفّذها على خوادم Google (مثلاً، يبحث عن سعر السهم، ثم يشغّل رمز Python البرمجي لحساب الجذر التربيعي).
- يرسل Gemini الردّ النهائي استنادًا إلى نتائج الأداة.
سير عمل الأداة المخصّصة (استدعاء الدوال)
بالنسبة إلى الأدوات المخصّصة وميزة "استخدام الكمبيوتر"، يتولّى تطبيقك تنفيذها:
- أنت ترسل طلبًا مع إعلانات الدوال (الأدوات).
- قد يرسل Gemini ملف JSON منظَّمًا لاستدعاء دالة معيّنة
(مثلاً،
{"name": "get_order_status", "args": {"order_id": "123"}})، مع تضمينidفريد دائمًا. - أنت تنفّذ الدالة في تطبيقك أو بيئتك.
- أنت ترسل نتائج الدالة إلى Gemini، مع استخدام
idنفسه الذي تم استخدامه في استدعاء الدالة. - يستخدم Gemini النتائج لإنشاء ردّ نهائي أو استدعاء أداة أخرى.
مزيد من المعلومات في دليل استدعاء الدوال.
سير عمل الجمع بين الأدوات المضمّنة والمخصّصة
بالنسبة إلى الطلبات التي تجمع بين الأدوات المضمّنة والأدوات المخصّصة (استدعاء الدوال)، يستخدم النموذج ميزة تداول سياق الأداة لتنسيق التنفيذ في بيئات مختلفة:
- أنت ترسل طلبًا وتُعلن عن الأدوات المضمّنة والدوال المخصّصة التي تريد تفعيلها، مع ضبط علامة لتفعيل ميزة دعم الجمع بين الأدوات.
- ينفّذ Gemini الأدوات المضمّنة ويُرجع النتيجة إلى المستخدم إذا تم إنشاء أي استدعاءات للدوال من جهة العميل (يعتمد ترتيب التنفيذ على الطلب وما يقرّره النموذج). يرسل النموذج ردًا يتضمّن ما يلي:
- تأكيد استدعاء الأداة
- نتائج استجابة الأداة (قد تظهر هذه النتائج بعد ملف JSON إذا أنشأ النموذج استدعاءَين متوازيين للدوال)
- ملف JSON منظَّم لاستدعاء الدالة
- توقيعات الأفكار المشفّرة للحفاظ على السياق
- أنت تنفّذ الدالة في تطبيقك أو بيئتك.
- أنت تُرجع جميع أجزاء ردّ Gemini، بالإضافة إلى نتائج استدعاء الدالة.
- ينشئ Gemini الردّ النهائي باستخدام كل السياق المجمّع.
يُرجى قراءة دليل الجمع بين الأدوات للتعرّف على كيفية تفعيل ميزة دعم الجمع بين الأدوات المضمّنة والمخصّصة، والاطّلاع على أمثلة عن تداول السياق.
المُخرجات المنظَّمة مقابل استدعاء الدوال
يوفّر Gemini طريقتَين لإنشاء مُخرجات منظَّمة. استخدِم ميزة "استدعاء الدوال" عندما يحتاج النموذج إلى تنفيذ خطوة وسيطة من خلال الاتصال بأدواتك أو أنظمة البيانات الخاصة بك. استخدِم ميزة "المُخرجات المنظَّمة" عندما تحتاج بدقة إلى أن يلتزم الردّ النهائي للنموذج بمخطط معيّن، مثلاً لعرض واجهة مستخدم مخصّصة.
المُخرجات المنظَّمة مع الأدوات
يمكنك الجمع بين ميزة "المُخرجات المنظَّمة" والأدوات المضمّنة لضمان أن تلتزم ردود النموذج المستندة إلى البيانات أو العمليات الحسابية الخارجية بمخطط صارم.
يُرجى الاطّلاع على المُخرجات المنظَّمة مع الأدوات للاطّلاع على أمثلة للرموز البرمجية.