מעבר מ-Custom Search Site Restricted API בפורמט JSON

אם אתם משתמשים ב-Custom Search Site Restricted JSON API של Programmable Search Engine, אתם יכולים ליצור ולפרוס חיפוש מוגבל לאתרים באיכות של Google תוך דקות, באמצעות Agent Search. כדי לפרוס את האפליקציה, אפשר להשתמש בווידג'ט החיפוש על ידי העתקת קוד מהמסוף Google Cloud ישירות לדף אינטרנט – אין צורך בכתיבת קוד. לחלופין, אפשר להטמיע פריסת API כדי לשלוט במראה של פונקציונליות החיפוש באתר. מידע נוסף על השימוש ב-API זמין בכרטיסייה REST במאמר קבלת תוצאות חיפוש לאפליקציה עם נתונים מאתר ובשיטה servingConfigs.search בהפניית REST.

בנוסף לתקצירים הקצרים הרגילים שמתקבלים מחיפוש באמצעות סוכן עם תוצאות החיפוש, אפשר להוסיף תכונות מתקדמות לחיפוש. התכונות האלה כוללות סיכומים של תוצאות החיפוש, חיפוש עם שאילתות המשך שמאפשר חיפוש מודע-הקשר עם שאלות המשך, ותשובות שמבוססות על מידע חלקי שכוללות טקסט שחולץ ומוחזר עם כל תוצאת חיפוש. כדי לקבל את התכונות המתקדמות האלה לחיפוש באינטרנט, צריך לאמת את הדומיין, ויהיו עלויות נוספות של יצירת אינדקס.

אפשר גם לסנן או לסדר את תוצאות החיפוש ולהשתמש באמצעי בקרה לקידום כדי להציג קישור כתוצאה מקודמת.

מידע נוסף מפורט בדף התמחור של חיפוש מבוסס סוכנים.

הגדרת חיפוש מבוסס סוכנים

כדי להגדיר את התכונה 'חיפוש על ידי סוכן', פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , בדף בורר הפרויקטים, בוחרים את הפרויקט שבו השתמשתם ל-Custom Search Site Restricted API בפורמט JSON.

  2. הפעלת חיפוש הסוכן.

יצירת אפליקציית חיפוש

כדי ליצור אפליקציה לחיפוש, פועלים לפי השלבים הבאים:

  1. נכנסים לדף AI Applications במסוף Google Cloud .

    אפליקציות AI

  2. לוחצים על יצירת אפליקציה.

  3. בדף Create App (יצירת אפליקציה), בקטע Site search with AI mode (חיפוש באתר במצב AI), לוחצים על Create (יצירה).

  4. מוודאים שהאפשרות תכונות של מהדורת Enterprise מופעלת. השדה הזה נדרש לחיפוש באתר. מידע נוסף זמין במאמר בנושא תכונות של מהדורת Enterprise.

  5. משביתים את האפשרות תשובות גנרטיביות. השבתה של התכונה הזו מאפשרת לכם להשתמש בפונקציונליות שדומה ל-Custom Search Site Restricted API בפורמט JSON של Programmable Search Engine. אם אתם לא צריכים את סיכום החיפוש או את החיפוש עם שאלות המשך, אתם יכולים להשבית את ההגדרה הזו. מידע נוסף זמין במאמר בנושא תשובות גנרטיביות.

  6. בשדה Your app name, מזינים שם לאפליקציה.

  7. בשדה השם החיצוני של החברה או הארגון, מזינים את השם הנפוץ של החברה או הארגון.

  8. בוחרים באפשרות גלובלי (Global) בתור המיקום של האפליקציה ולוחצים על המשך.

  9. בדף מאגרי נתונים, לוחצים על יצירת מאגר נתונים.

  10. בחלונית בחירת מקור נתונים, לוחצים על תוכן אתר.

  11. משביתים את האפשרות הוספה מתקדמת של אתרים לאינדקס. אם משביתים את ההגדרה הזו, מקבלים פונקציונליות דומה לזו של Custom Search Site Restricted API בפורמט JSON ב-Programmable Search Engine. כדאי להשבית את ההגדרה הזו אם אתם לא צריכים סיכום של תוצאות החיפוש או חיפוש עם שאלות המשך, או אם אתם לא הבעלים של הדומיינים שציינתם. מידע נוסף זמין במאמר בנושא הוספת אתרים לאינדקס בשיטה מתקדמת.

  12. בחלונית ציון תבניות של כתובות URL לאינדוקס, בשדה אתרים שרוצים לכלול, מזינים את תבניות כתובות ה-URL של האתרים שרוצים לחפש, ואז לוחצים על המשך.

  13. בחלונית Configure your data store (הגדרת מאגר הנתונים), מזינים שם לתצוגה של מאגר הנתונים ולוחצים על Create (יצירה).

  14. בדף מאגרי נתונים, בוחרים את מאגר הנתונים החדש ולוחצים על יצירה.

פריסת אפליקציית החיפוש

מחליטים איך לאמת את אפליקציית החיפוש של חיפוש מבוסס סוכנים: באמצעות OAuth 2.0 או מפתח API. במאמר מידע על אימות מוסבר על היתרונות והחסרונות של כל שיטה.

פריסת אפליקציית החיפוש (OAuth 2.0)

כדי לפרוס את אפליקציית החיפוש באמצעות אימות OAuth 2.0, פועלים לפי השלבים הבאים:

  1. הוראות להגדרת OAuth 2.0 מופיעות בקטע ב-Google Cloud במאמר אימות לחיפוש באמצעות סוכן. חשוב להוסיף לחשבון השירות את התפקיד משתמש Discovery Engine או צופה Discovery Engine.

  2. פורסים את אפליקציית החיפוש באחת מהדרכים הבאות:

פריסת אפליקציית החיפוש (מפתח API)

כדי לפרוס את אפליקציית החיפוש באמצעות מפתח API לאימות, צריך לבצע את השלבים הבאים:

  1. יוצרים את מפתח ה-API:

    1. נכנסים לדף Credentials במסוף Google Cloud .

      פרטי כניסה

    2. אם אתם לא נמצאים כבר בפרויקט, בוחרים את הפרויקט ברשימת הפרויקטים בחלק העליון של דף המסוף Google Cloud .

    3. לוחצים על Create credentials ואז על API key. לא להוסיף הגבלות על מפנים. חלק מהגדרות הפרטיות של המשתמשים לא מעבירות את כתובת ה-URL של הדף המפנה.

      • חשוב לשים לב למפתח ה-API שנוצר, כי תצטרכו להשתמש בו כשקוראים ל-method‏ searchLite.

    4. כדי לשפר את האבטחה, מוסיפים הגבלת HTTP למפתח ה-API כדי להגביל את הגישה לשירות חיפוש מבוסס סוכנים בכתובת https://discoveryengine.googleapis.com/*.

  2. פורסים את אפליקציית החיפוש באמצעות ה-API. מידע נוסף זמין במאמר קבלת תוצאות חיפוש לאפליקציה עם נתונים מאתר (מפתח API) ובמאמר בנושא שיטת servingConfigs.searchLite ב-REST reference. כדי להזמין את התוצאות של שאילתות חיפוש באינטרנט, אפשר לעיין במאמר בנושא הזמנת תוצאות חיפוש באינטרנט.

מידע על אימות

ב-Custom Search Site Restricted JSON API של Programmable Search Engine, האימות מתבצע באמצעות מפתח API. לעומת זאת, בחיפוש באמצעות סוכן נדרש OAuth 2.0, למעט כמה מקרים חריגים. אם אתם רוצים להמשיך להשתמש במפתח API לאימות, אתם צריכים להשתמש ב-method‏ searchLite באמצעות קריאות ל-API.

אם בוחרים באימות באמצעות OAuth 2.0, צריך להשתמש בשיטה search ובשיטה answer כדי לשלוח שאילתות לאתר. בנוסף, אפשר לפרוס את אפליקציית החיפוש באמצעות ווידג'ט החיפוש ללא קוד.

בטבלה הבאה מפורטים ההבדלים בין שימוש בשיטה searchLite עם אימות באמצעות מפתח API לבין שימוש בשיטות search ו-answer עם אימות באמצעות OAuth 2.0.

תכונה/שיטות searchLite method search method
אימות מפתח API OAuth 2.0
ווידג'ט חיפוש Google זמין ✘ ✔
סיכומי חיפוש ✔ ✔
חיפוש אתרים ציבוריים ✔ ✔

השלבים הבאים