איך מתחילים להשתמש בחיפוש בהתאמה אישית

איך מתחילים להשתמש בחיפוש בהתאמה אישית

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

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

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

במדריך הזה מוסבר איך ליצור אפליקציות חיפוש לסוגים שונים של נתונים:

• נתונים מאתר שנסרק cloud.google.com/generative-ai-app-builder/
• נתונים מובנים בצורה של מערך נתונים בפורמט NDJSON שנבלעו מקטגוריה של Cloud Storage
• נתונים לא מובְנים בפורמט PDF שמיובאים מקטגוריה של Cloud Storage

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

---

לחצו על תראו לי איך כדי לקרוא הסבר מפורט על המשימה ישירות במסוף Google Cloud :

תראו לי איך

---

לפני שמתחילים

נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Agent Search (Discovery Engine), BigQuery, Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Enable the APIs
Make sure that you have the following role or roles on the project: Discovery Engine Admin
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Search (Discovery Engine), BigQuery, Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Make sure that you have the following role or roles on the project: Discovery Engine Admin

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.

הפעלת חיפוש באמצעות סוכן

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

   אפליקציות AI

2. אופציונלי: לוחצים על אני רוצה לאפשר ל-Google לבצע דגימה סלקטיבית של קלט ותגובות של המודל.

3. לוחצים על המשך והפעלת ה-API.

יצירת מאגר נתונים

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

לוחצים על הכרטיסייה של סוג הנתונים שרוצים להוסיף למאגר הנתונים: אתר, נתונים מובְנים או נתונים לא מובְנים.

נתונים מהאתר

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

   אפליקציות מבוססות-AI – יצירת מאגר נתונים

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

3. בחלונית Specify the websites for your data store (ציון האתרים של מאגר הנתונים), מוודאים שהאפשרות Advanced website indexing (הוספה מתקדמת של אתרים לאינדקס) מושבתת.

4. בשדה Sites to include, מזינים:

   cloud.google.com/generative-ai-app-builder/*
   

5. לוחצים על Continue.

6. בחלונית Configure your data store, בוחרים באפשרות global (Global) בתור המיקום של מאגר הנתונים.

7. מזינים שם למאגר הנתונים. רושמים או זוכרים את המזהה שנוצר. תצטרכו את זה בהמשך.

8. לוחצים על יצירה.

נתונים מובְנים

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

   אפליקציות מבוססות-AI – יצירת מאגר נתונים

2. בחלונית בחירת מקור נתונים, בוחרים באפשרות Cloud Storage.

3. בחלונית Import data from Cloud Storage (ייבוא נתונים מ-Cloud Storage), בוחרים באפשרות Structured data (JSONL) (נתונים מובְנים (JSONL)).

4. מוודאים שהאפשרות קובץ נבחרה.

5. בשדה gs://, מזינים את הערך הבא:

   cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson
   

   קטגוריה של Cloud Storage זו מכילה קובץ בפורמט NDJSON של סרטים שזמינים דרך Kaggle.

6. לוחצים על Continue.

7. מקצים את מאפייני המפתח באופן הבא:

   שם השדה	נכס מרכזי
   homepage	uri
   overview	description

   לוחצים על המשך.

8. בחלונית Configure your data store, בוחרים באפשרות global (Global) בתור המיקום של מאגר הנתונים.

9. מזינים שם למאגר הנתונים. רושמים או זוכרים את המזהה שנוצר. תצטרכו את זה בהמשך.

10. לוחצים על יצירה.

נתונים לא מובנים

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

   אפליקציות מבוססות-AI – יצירת מאגר נתונים

2. בחלונית בחירת מקור נתונים, בוחרים באפשרות Cloud Storage.

3. בחלונית ייבוא נתונים מ-Cloud Storage, בוחרים באפשרות מסמכים לא מובְנים (PDF, ‏ HTML, ‏ TXT ועוד).

4. מוודאים שהאפשרות תיקייה נבחרה.

5. בשדה gs://, מזינים את הערך הבא:

   cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs
   

   הקטגוריה הזו ב-Cloud Storage מכילה קובצי PDF של דוחות רווחים מהאתר למשקיעים של Alphabet.

6. לוחצים על Continue.

7. בחלונית Configure your data store, בוחרים באפשרות global (Global) בתור המיקום של מאגר הנתונים.

8. מזינים שם למאגר הנתונים. רושמים או זוכרים את המזהה שנוצר. תצטרכו את זה בהמשך.

9. לוחצים על יצירה.

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

בשלב הבא, יוצרים אפליקציית חיפוש ומקשרים את מאגר הנתונים שיצרתם קודם.

נתונים מהאתר

1. עוברים לדף יצירת אפליקציה.

   AI Applications - Create App

2. בקטע חיפוש באתר באמצעות מצב AI, לוחצים על יצירה.

3. מוודאים שהאפשרות תכונות של מהדורת Enterprise מופעלת.

4. בשדה שם האפליקציה שלך מזינים שם לאפליקציה. מזהה האפליקציה מופיע מתחת לשם האפליקציה.

5. בשדה השם החיצוני של החברה או הארגון, מזינים את שם החברה או הארגון. במדריך הזה אפשר להשתמש ב-Google Cloud, כי האפליקציה תחפש באתר Google Cloud .

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

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

8. כדי לראות את רשימת האתרים שנוספו לאינדקס ולשנות אותם אם צריך, עוברים לדף נתונים של האפליקציה.

נתונים מובְנים

1. עוברים לדף יצירת אפליקציה.

   AI Applications - Create App

2. בקטע חיפוש באתר באמצעות מצב AI, לוחצים על יצירה.

3. מוודאים שהאפשרות תכונות של מהדורת Enterprise מופעלת.

4. בשדה שם האפליקציה שלך מזינים שם לאפליקציה. מזהה האפליקציה מופיע מתחת לשם האפליקציה.

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

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

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

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

9. לוחצים על הכרטיסייה מסמכים כדי לראות את מספר המסמכים שיובאו.

נתונים לא מובנים

1. עוברים לדף יצירת אפליקציה.

   AI Applications - Create App

2. בקטע חיפוש באתר באמצעות מצב AI, לוחצים על יצירה.

3. מוודאים שהאפשרות תכונות Enterprise מופעלת.

4. בשדה שם האפליקציה שלך מזינים שם לאפליקציה. מזהה האפליקציה מופיע מתחת לשם האפליקציה.

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

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

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

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

9. לוחצים על הכרטיסייה מסמכים כדי לראות את מספר המסמכים שיובאו.

תצוגה מקדימה של האפליקציה

נתונים מהאתר

1. בדף Apps (אפליקציות), לוחצים על השם של האפליקציה החדשה.

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

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

4. בסרגל החיפוש, מחפשים את Agent Search כדי לראות תוצאות לגבי המוצר.

נתונים מובְנים

1. בדף Apps (אפליקציות), לוחצים על השם של האפליקציה החדשה.

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

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

4. בסרגל החיפוש, מזינים trains ולוחצים על Enter כדי לקבל תוצאות של סרטים שקשורים לרכבות.

נתונים לא מובנים

1. בדף Apps (אפליקציות), לוחצים על השם של האפליקציה החדשה.

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

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

4. בסרגל החיפוש, מזינים Google ואז מקישים על Enter כדי לראות את התוצאות.

הגדרת ווידג'ט החיפוש

1. בתפריט הניווט, לוחצים על Configurations (הגדרות).

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

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

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

4. עוברים לכרטיסייה השלמה אוטומטית כדי להגדיר הגדרות ספציפיות להשלמה אוטומטית.

   מידע נוסף זמין במאמר בנושא הגדרת השלמה אוטומטית.

5. עוברים לכרטיסייה הגדרות התשובות כדי להגדיר תכונות מתקדמות.

   מידע נוסף זמין במאמר מידע על תכונות מתקדמות.

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

1. בדף אפליקציות, לוחצים על שם האפליקציה שרוצים לפרוס.

2. בתפריט הניווט, לוחצים על שילוב.

3. מוודאים שהכרטיסייה ווידג'ט נבחרה.

4. בוחרים באפשרות מבוסס JWT או OAuth בתור סוג ההרשאה של הווידג'ט.

5. בשדה Domain (דומיין), מזינים את שם הדומיין של דף האינטרנט שבו רוצים להציב את הווידג'ט. לדוגמה, אם אתם רוצים להעתיק את הווידג'ט לדף האינטרנט example.com/ai.html, צריך להזין את example.com כדומיין.

6. לוחצים על הוספה ואז על שמירה.

7. מעתיקים את קטע הקוד שמופיע בקטע Copy the following code to your web application (העתקת הקוד הבא לאפליקציית האינטרנט).

8. בבסיס הקוד, יוצרים אסימון הרשאה.

9. כדי להעביר את אסימון ההרשאה לווידג'ט, משתמשים בקטע הקוד Set authorization token שמופיע בקטע העתקת הקוד הבא לאפליקציית האינטרנט ומחליפים את הטקסט <JWT or OAuth token provided by your backend> באסימון ההרשאה.

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

הסרת המשאבים

כדי לא לצבור חיובים לחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, פועלים לפי השלבים הבאים:

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

המאמרים הבאים

• מבוא לחיפוש מבוסס סוכנים
• מידע על נתונים, מאגרי נתונים ומנועים