يمكن استخدام ميزة "الاستناد إلى بحث Google" في Gemini API وAI Studio لتحسين دقة الردود من النموذج وحداثتها. بالإضافة إلى تقديم ردود أكثر واقعية، عند تفعيل ميزة "الاستناد إلى نتائج بحث Google"، تعرض Gemini API مصادر الاستناد (الروابط الداعمة المضمّنة) واقتراحات محرّك بحث Google مع محتوى الردّ. تشير اقتراحات البحث إلى المستخدمين على نتائج البحث التي تتوافق مع الردّ المستنِد إلى الحقائق.
لا تتيح ميزة "البحث عن معلومات أساسية" من Google استخدام سوى الطلبات النصية. ولا تتوافق مع الطلبات المتعدّدة الوسائط (النص والصورة والنص والصوت وما إلى ذلك). تتوفّر ميزة "الربط بالأرض" باستخدام "بحث Google" بكل اللغات المتاحة لطُرز Gemini.
سيساعدك هذا الدليل في بدء استخدام ميزة "الربط بنتائج البحث من Google" باستخدام إحدى حِزم تطوير البرامج (SDK) لواجهة برمجة التطبيقات Gemini API أو واجهة برمجة التطبيقات REST API.
إعداد نموذج لاستخدام "بحث Google"
ما أهمية ميزة "البحث عن معلومات أساسية" في "بحث Google"؟
في الذكاء الاصطناعي التوليدي، يشير التثبيت إلى عملية ربط النموذج بأحد مصادر المعلومات التي يمكن التحقّق منها. قد تقدّم هذه المصادر معلومات عن مكان العمل في العالم الواقعي أو سياقًا محدّدًا آخر. يساعد الربط بالواقع في تحسين دقة نتائج الذكاء الاصطناعي وموثوقيتها وفائدتها.
من المهمّ بشكل خاص التأكّد من صحة المعلومات قبل استخدامها في الطلبات التي تتطلّب الحصول على معلومات محدّثة من الويب. باستخدام المعلومات الأساسية، يمكن للنموذج الوصول إلى معلومات بعد تاريخ الإيقاف النهائي للمعلومات، والحصول على مصادر للمعلومات، والإجابة عن الأسئلة التي لا يمكنه الإجابة عنها بدقة بخلاف ذلك.
باستخدام Google AI Studio أو Gemini API، يمكنك ربط نتائج النماذج بنتائج "بحث Google". يوفر استخدام محرّك بحث Google الفوائد التالية:
- السماح بردود نماذج مرتبطة بمحتوى معيّن
- تقليل الهلوسة في النموذج، وهي حالات ينشئ فيها النموذج محتوى غير واقعي
- تقدّم العناصر الأساسية نماذج للردود على المصادر التي يمكن للمستخدم النقر عليها وفتحها.
- تحسين مصداقية المحتوى الذي تم إنشاؤه وقابليته للتطبيق
عند استخدام ميزة "التثبيت" مع "بحث Google"، يتم ربط العبارة بنتائج بحث موثوقة من الإنترنت. بما أنّ ردود النموذج غير المستندة إلى الحقائق تستند إلى أنماط تم تعلّمها، قد لا تتلقّى ردودًا واقعية على الطلبات المتعلّقة بالأحداث الجارية (على سبيل المثال، طلب توقّعات الطقس أو النتيجة النهائية لمباراة كرة قدم حديثة). بما أنّ الإنترنت يتيح الوصول إلى معلومات جديدة، يمكن أن يؤدي الطلب المستنِد إلى مرجع إلى إنشاء ردود أكثر حداثة، مع الإشارة إلى المصادر.
إليك مثال يقارن بين استجابة غير مستندة إلى أسس وردّ أساسي تم إنشاؤه باستخدام واجهة برمجة التطبيقات. (تم إنشاء الردود في تشرين الأول (أكتوبر) 2024.)
Gemini غير المتصل بالأرض | الربط بـ "بحث Google" |
---|---|
سؤال: من فاز ببطولة "سوبر بول" هذا العام؟ الردّ: فاز فريق Kansas City Chiefs ببطولة Super Bowl LVII هذا العام (2023). |
الطلب: من فاز ببطولة Super Bowl هذا العام؟ الرد: فاز فريق Kansas City Chiefs ببطولة Super Bowl LVIII هذا العام، وهزم فريق San Francisco 49ers في الوقت الإضافي بنتيجة 25 مقابل 22. |
في الردّ غير المستنِد إلى أي أساس من الصحة، يشير النموذج إلى فوز فريق Kansas City Chiefs بدورة Super Bowl لعام 2023. في الردّ المستنِد إلى الحقائق، يشير النموذج بشكل صحيح إلى فوزه الأخير في عام 2024.
توضّح الصورة التالية شكل الردّ المستنِد إلى الحقائق في AI Studio.
اقتراحات بحث Google
لاستخدام ميزة "التأكّد من صحة المعلومات" مع "بحث Google"، عليك عرض اقتراحات "بحث Google"، وهي طلبات بحث مقترَحة مضمّنة في البيانات الوصفية للإجابة التي تم التحقّق من صحتها. للاطّلاع على مزيد من المعلومات عن متطلبات العرض، اطّلِع على مقالة استخدام اقتراحات "بحث Google".
الاسترجاع الديناميكي
من المرجّح أن تستفيد بعض طلبات البحث من ميزة "الاطّلاع على المعلومات الأساسية" في "بحث Google" أكثر من غيرها. تمنحك ميزة الاسترداد الديناميكي تحكمًا إضافيًا في وقت استخدام "بحث الويب من Google" مع "بحث Google".
إذا لم يتم تحديد وضع الاسترجاع الديناميكي، يتم دائمًا بدء ميزة "التحقّق من صحة المعلومات باستخدام "بحث Google". إذا تم ضبط الوضع على "ديناميكي"، يقرّر النموذج وقت استخدام التأريض استنادًا إلى حدّ أدنى يمكنك ضبطه. قيمة الحدّ هي قيمة نقطة عائمة في النطاق [0,1] ويتم ضبطها تلقائيًا على 0.3. إذا كانت قيمة الحدّ الأدنى هي 0، يكون الردّ مستندًا دائمًا إلى "بحث Google". وإذا كانت القيمة هي 1، لا يكون الردّ مستندًا إلى "بحث Google" أبدًا.
آلية عمل الاسترجاع الديناميكي
يمكنك استخدام ميزة "الاسترداد الديناميكي" في طلبك لاختيار وقت تفعيل ميزة "التحقّق من صحة المعلومات باستخدام "بحث Google". يكون ذلك مفيدًا عندما لا يتطلّب الطلب إجابة تستند إلى "بحث Google"، ويمكن أن يقدّم النموذج إجابة استنادًا إلى معرفته الخاصة بدون أساس. يساعدك ذلك في إدارة وقت الاستجابة والجودة والتكلفة بشكل أكثر فعالية.
قبل استدعاء إعدادات الاسترجاع الديناميكي في طلبك، عليك فهم المصطلحات التالية:
نتيجة التوقّع: عندما تطلب إجابة مستندة إلى الحقائق، يحدّد Gemini نتيجة توقّع للطلب. تكون نتيجة التوقّع قيمة نقطة عائمة في النطاق [0,1]. تعتمد قيمته على ما إذا كان الطلب يمكنه الاستفادة من ربط الإجابة بأجدد المعلومات من "بحث Google". وبالتالي، إذا كان الطلب يتطلّب إجابة تستند إلى أحدث الحقائق على الويب، يكون له نتيجة توقّع أعلى. يكون للطلب الذي تكفي إجابة من إنشاء النموذج نتيجة تنبؤات أقل.
في ما يلي أمثلة على بعض الطلبات ونتائج التوقّعات المرتبطة بها.
طلب واحد نتيجة التوقّع تعليق "كتابة قصيدة عن زهور الفاوانيا" 0.13 قد يعتمد النموذج على معلوماته ولا تحتاج الإجابة إلى أساس. "اقتراح لعبة لطفل عمره عامان" 0.36 يمكن للنموذج الاعتماد على معرفته ولا تحتاج الإجابة إلى مزيد من الشرح. "هل يمكنك تقديم وصفة guacamole مستوحاة من آسيا؟" 0.55 يمكن أن يقدّم محرّك بحث Google إجابة مستندة إلى الحقائق، ولكنّ ذلك ليس مطلوبًا بشكل صارم، إذ قد تكون معرفة النموذج كافية. "ما هو "أداة إنشاء موظّفي الدعم"؟ كيف يتم تحصيل رسوم التأهيل في Agent Builder؟" 0.72 تتطلّب من محرّك بحث Google إنشاء إجابة مستندة إلى الحقائق. "من فاز بسباق F1 Grand Prix الأخير؟" 0.97 يتطلب من "بحث Google" تقديم إجابة واضحة. الحدّ الأدنى: في طلب البيانات من واجهة برمجة التطبيقات، يمكنك تحديد إعدادات استرجاع ديناميكي مع حدّ أدنى. الحدّ الأدنى هو قيمة عدد عائم في النطاق [0,1] ويتم ضبطه تلقائيًا على 0.7. إذا كانت قيمة الحدّ الأدنى هي صفر، يتم دائمًا الاعتماد على "بحث Google" في الردّ. بالنسبة إلى جميع القيم الأخرى للحدّ، ينطبق ما يلي:
- إذا كانت نتيجة التوقّع أكبر من أو تساوي الحد الأدنى، تكون الإجابة مستندة إلى "بحث Google". يشير الحدّ الأدنى إلى أنّ المزيد من الطلبات تتضمّن ردودًا تم إنشاؤها باستخدام "استخدام الأساس مع بحث Google".
- إذا كانت نتيجة التوقّع أقل من الحدّ الأدنى، قد يستمر النموذج في إنشاء الإجابة، ولكنّها لن تكون مستندة إلى "بحث Google".
للتعرّف على كيفية ضبط حدّ الاسترجاع الديناميكي باستخدام حزمة SDK أو واجهة برمجة التطبيقات REST API، اطّلِع على مثال الرمز البرمجي المناسب.
إذا كنت تستخدم AI Studio، يمكنك ضبط الحدّ الأدنى لاسترداد البيانات الديناميكية من خلال النقر على تعديل الربط.
للعثور على حد جيد يناسب احتياجات عملك، يمكنك إنشاء مجموعة تمثيلية من طلبات البحث التي تتوقع مقابلتها. بعد ذلك، يمكنك ترتيب الطلبات حسب نتيجة التوقّع في الردّ واختيار حدّ أدنى مناسب لحالة الاستخدام.
ردّ مستند إلى الحقائق
إذا تمّ ربط طلبك بـ "بحث Google" بنجاح، ستتضمّن الاستجابة
groundingMetadata
. قد يبدو الردّ المستنِد إلى الحقائق على النحو التالي
(تم حذف أجزاء من الردّ لتبسيطه):
{
"candidates": [
{
"content": {
"parts": [
{
"text": "Carlos Alcaraz won the Gentlemen's Singles title at the 2024 Wimbledon Championships. He defeated Novak Djokovic in the final, winning his second consecutive Wimbledon title and fourth Grand Slam title overall. \n"
}
],
"role": "model"
},
...
"groundingMetadata": {
"searchEntryPoint": {
"renderedContent": "\u003cstyle\u003e\n.container {\n align-items: center;\n border-radius: 8px;\n display: flex;\n font-family: Google Sans, Roboto, sans-serif;\n font-size: 14px;\n line-height: 20px;\n padding: 8px 12px;\n}\n.chip {\n display: inline-block;\n border: solid 1px;\n border-radius: 16px;\n min-width: 14px;\n padding: 5px 16px;\n text-align: center;\n user-select: none;\n margin: 0 8px;\n -webkit-tap-highlight-color: transparent;\n}\n.carousel {\n overflow: auto;\n scrollbar-width: none;\n white-space: nowrap;\n margin-right: -12px;\n}\n.headline {\n display: flex;\n margin-right: 4px;\n}\n.gradient-container {\n position: relative;\n}\n.gradient {\n position: absolute;\n transform: translate(3px, -9px);\n height: 36px;\n width: 9px;\n}\n@media (prefers-color-scheme: light) {\n .container {\n background-color: #fafafa;\n box-shadow: 0 0 0 1px #0000000f;\n }\n .headline-label {\n color: #1f1f1f;\n }\n .chip {\n background-color: #ffffff;\n border-color: #d2d2d2;\n color: #5e5e5e;\n text-decoration: none;\n }\n .chip:hover {\n background-color: #f2f2f2;\n }\n .chip:focus {\n background-color: #f2f2f2;\n }\n .chip:active {\n background-color: #d8d8d8;\n border-color: #b6b6b6;\n }\n .logo-dark {\n display: none;\n }\n .gradient {\n background: linear-gradient(90deg, #fafafa 15%, #fafafa00 100%);\n }\n}\n@media (prefers-color-scheme: dark) {\n .container {\n background-color: #1f1f1f;\n box-shadow: 0 0 0 1px #ffffff26;\n }\n .headline-label {\n color: #fff;\n }\n .chip {\n background-color: #2c2c2c;\n border-color: #3c4043;\n color: #fff;\n text-decoration: none;\n }\n .chip:hover {\n background-color: #353536;\n }\n .chip:focus {\n background-color: #353536;\n }\n .chip:active {\n background-color: #464849;\n border-color: #53575b;\n }\n .logo-light {\n display: none;\n }\n .gradient {\n background: linear-gradient(90deg, #1f1f1f 15%, #1f1f1f00 100%);\n }\n}\n\u003c/style\u003e\n\u003cdiv class=\"container\"\u003e\n \u003cdiv class=\"headline\"\u003e\n \u003csvg class=\"logo-light\" width=\"18\" height=\"18\" viewBox=\"9 9 35 35\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n \u003cpath fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M42.8622 27.0064C42.8622 25.7839 42.7525 24.6084 42.5487 23.4799H26.3109V30.1568H35.5897C35.1821 32.3041 33.9596 34.1222 32.1258 35.3448V39.6864H37.7213C40.9814 36.677 42.8622 32.2571 42.8622 27.0064V27.0064Z\" fill=\"#4285F4\"/\u003e\n \u003cpath fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M26.3109 43.8555C30.9659 43.8555 34.8687 42.3195 37.7213 39.6863L32.1258 35.3447C30.5898 36.3792 28.6306 37.0061 26.3109 37.0061C21.8282 37.0061 18.0195 33.9811 16.6559 29.906H10.9194V34.3573C13.7563 39.9841 19.5712 43.8555 26.3109 43.8555V43.8555Z\" fill=\"#34A853\"/\u003e\n \u003cpath fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M16.6559 29.8904C16.3111 28.8559 16.1074 27.7588 16.1074 26.6146C16.1074 25.4704 16.3111 24.3733 16.6559 23.3388V18.8875H10.9194C9.74388 21.2072 9.06992 23.8247 9.06992 26.6146C9.06992 29.4045 9.74388 32.022 10.9194 34.3417L15.3864 30.8621L16.6559 29.8904V29.8904Z\" fill=\"#FBBC05\"/\u003e\n \u003cpath fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M26.3109 16.2386C28.85 16.2386 31.107 17.1164 32.9095 18.8091L37.8466 13.8719C34.853 11.082 30.9659 9.3736 26.3109 9.3736C19.5712 9.3736 13.7563 13.245 10.9194 18.8875L16.6559 23.3388C18.0195 19.2636 21.8282 16.2386 26.3109 16.2386V16.2386Z\" fill=\"#EA4335\"/\u003e\n \u003c/svg\u003e\n \u003csvg class=\"logo-dark\" width=\"18\" height=\"18\" viewBox=\"0 0 48 48\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n \u003ccircle cx=\"24\" cy=\"23\" fill=\"#FFF\" r=\"22\"/\u003e\n \u003cpath d=\"M33.76 34.26c2.75-2.56 4.49-6.37 4.49-11.26 0-.89-.08-1.84-.29-3H24.01v5.99h8.03c-.4 2.02-1.5 3.56-3.07 4.56v.75l3.91 2.97h.88z\" fill=\"#4285F4\"/\u003e\n \u003cpath d=\"M15.58 25.77A8.845 8.845 0 0 0 24 31.86c1.92 0 3.62-.46 4.97-1.31l4.79 3.71C31.14 36.7 27.65 38 24 38c-5.93 0-11.01-3.4-13.45-8.36l.17-1.01 4.06-2.85h.8z\" fill=\"#34A853\"/\u003e\n \u003cpath d=\"M15.59 20.21a8.864 8.864 0 0 0 0 5.58l-5.03 3.86c-.98-2-1.53-4.25-1.53-6.64 0-2.39.55-4.64 1.53-6.64l1-.22 3.81 2.98.22 1.08z\" fill=\"#FBBC05\"/\u003e\n \u003cpath d=\"M24 14.14c2.11 0 4.02.75 5.52 1.98l4.36-4.36C31.22 9.43 27.81 8 24 8c-5.93 0-11.01 3.4-13.45 8.36l5.03 3.85A8.86 8.86 0 0 1 24 14.14z\" fill=\"#EA4335\"/\u003e\n \u003c/svg\u003e\n \u003cdiv class=\"gradient-container\"\u003e\u003cdiv class=\"gradient\"\u003e\u003c/div\u003e\u003c/div\u003e\n \u003c/div\u003e\n \u003cdiv class=\"carousel\"\u003e\n \u003ca class=\"chip\" href=\"https://vertexaisearch.cloud.google.com/grounding-api-redirect/AWhgh4x8Epe-gzpwRBvp7o3RZh2m1ygq1EHktn0OWCtvTXjad4bb1zSuqfJd6OEuZZ9_SXZ_P2SvCpJM7NaFfQfiZs6064MeqXego0vSbV9LlAZoxTdbxWK1hFeqTG6kA13YJf7Fbu1SqBYM0cFM4zo0G_sD9NKYWcOCQMvDLDEJFhjrC9DM_QobBIAMq-gWN95G5tvt6_z6EuPN8QY=\"\u003ewho won wimbledon 2024\u003c/a\u003e\n \u003c/div\u003e\n\u003c/div\u003e\n"
},
"groundingChunks": [
{
"web": {
"uri": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/AWhgh4whET1ta3sDETZvcicd8FeNe4z0VuduVsxrT677KQRp2rYghXI0VpfYbIMVI3THcTuMwggRCbFXS_wVvW0UmGzMe9h2fyrkvsnQPJyikJasNIbjJLPX0StM4Bd694-ZVle56MmRA4YiUvwSqad1w6O2opmWnw==",
"title": "wikipedia.org"
}
},
{
"web": {
"uri": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/AWhgh4wR1M-9-yMPUr_KdHlnoAmQ8ZX90DtQ_vDYTjtP2oR5RH4tRP04uqKPLmesvo64BBkPeYLC2EpVDxv9ngO3S1fs2xh-e78fY4m0GAtgNlahUkm_tBm_sih5kFPc7ill9u2uwesNGUkwrQlmP2mfWNU5lMMr23HGktr6t0sV0QYlzQq7odVoBxYWlQ_sqWFH",
"title": "wikipedia.org"
}
},
{
"web": {
"uri": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/AWhgh4wsDmROzbP-tmt8GdwCW_pqISTZ4IRbBuoaMyaHfcQg8WW-yKRQQvMDTPAuLxJh-8_U8_iw_6JKFbQ8M9oVYtaFdWFK4gOtL4RrC9Jyqc5BNpuxp6uLEKgL5-9TggtNvO97PyCfziDFXPsxylwI1HcfQdrz3Jy7ZdOL4XM-S5rC0lF2S3VWW0IEAEtS7WX861meBYVjIuuF_mIr3spYPqWLhbAY2Spj-4_ba8DjRvmevIFUhRuESTKvBfmpxNSM",
"title": "cbssports.com"
}
},
{
"web": {
"uri": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/AWhgh4yzjLkorHiUKjhOPkWaZ9b4cO-cLG-02vlEl6xTBjMUjyhK04qSIclAa7heR41JQ6AAVXmNdS3WDrLOV4Wli-iezyzW8QPQ4vgnmO_egdsuxhcGk3-Fp8-yfqNLvgXFwY5mPo6QRhvplOFv0_x9mAcka18QuAXtj0SPvJfZhUEgYLCtCrucDS5XFc5HmRBcG1tqFdKSE1ihnp8KLdaWMhrUQI21hHS9",
"title": "jagranjosh.com"
}
},
{
"web": {
"uri": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/AWhgh4y9L4oeNGWCatFz63b9PpP3ys-Wi_zwnkUT5ji9lY7gPUJQcsmmE87q88GSdZqzcx5nZG9usot5FYk2yK-FAGvCRE6JsUQJB_W11_kJU2HVV1BTPiZ4SAgm8XDFIxpCZXnXmEx5HUfRqQm_zav7CvS2qjA2x3__qLME6Jy7R5oza1C5_aqjQu422le9CaigThS5bvJoMo-ZGcXdBUCj2CqoXNVjMA==",
"title": "apnews.com"
}
}
],
"groundingSupports": [
{
"segment": {
"endIndex": 85,
"text": "Carlos Alcaraz won the Gentlemen's Singles title at the 2024 Wimbledon Championships."
},
"groundingChunkIndices": [
0,
1,
2,
3
],
"confidenceScores": [
0.97380733,
0.97380733,
0.97380733,
0.97380733
]
},
{
"segment": {
"startIndex": 86,
"endIndex": 210,
"text": "He defeated Novak Djokovic in the final, winning his second consecutive Wimbledon title and fourth Grand Slam title overall."
},
"groundingChunkIndices": [
1,
0,
4
],
"confidenceScores": [
0.96145374,
0.96145374,
0.96145374
]
}
],
"webSearchQueries": [
"who won wimbledon 2024"
]
}
}
],
...
}
إذا لم يتضمّن الردّ groundingMetadata
، يعني ذلك أنّه
لم يتمّ ربطه بنجاح. هناك عدة أسباب لحدوث ذلك،
بما في ذلك انخفاض مدى صلة المصدر أو المعلومات غير المكتملة ضمن
ردّة الفعل المستندة إلى النموذج.
عند إنشاء نتيجة مستندة إلى الحقائق، تحتوي البيانات الوصفية على عناوين URL تعيد توجيهك
إلى ناشري المحتوى الذي تم استخدامه لإنشاء النتيجة المستندة إلى الحقائق.
تحتوي معرّفات URI هذه على النطاق الفرعي vertexaisearch
، كما هو موضّح في المثال المقتطع التالي:
https://vertexaisearch.cloud.google.com/grounding-api-redirect/...
. تحتوي بيانات التعريف
أيضًا على نطاقات الناشرين. تظلّ عناوين URL المقدَّمة متاحة
لمدة 30 يومًا بعد إنشاء النتيجة المستندة إلى البيانات.
الحقل renderedContent
في searchEntryPoint
هو الرمز الذي يتم توفيره لتنفيذ اقتراحات "بحث Google". راجِع
استخدام اقتراحات "بحث Google"
للتعرّف على مزيد من المعلومات.