איך מתחילים להשתמש בחיפוש מדיה
אתם יכולים ליצור במהירות אפליקציה מתקדמת לחיפוש מדיה, שמאפשרת לקהלים שלכם לגלות תוכן עם תוצאות באיכות של Google.
למידע כללי על Agent Search למדיה, קראו את המאמר מבוא לחיפוש ולהמלצות של מדיה.במדריך הזה נשתמש במערך הנתונים של Movielens כדי להדגים איך להעלות את קטלוג התוכן של המדיה לחיפוש מבוסס סוכנים. קבוצת הנתונים של Movielens מכילה קטלוג של סרטים (מסמכים).
אחרי שתעלו את נתוני הסרטים, תיצרו אפליקציית חיפוש ותבדקו אותה בדף התצוגה המקדימה.
אם השלמתם את המדריך תחילת העבודה עם המלצות למדיה ועדיין יש לכם את מאגר הנתונים (השם המוצע quickstart-media-data-store), אתם יכולים להשתמש במאגר הנתונים הזה במקום ליצור מאגר נתונים אחר. במקרה כזה, אתם צריכים להתחיל את המדריך מהשלב יצירת אפליקציה לחיפוש מדיה.
הזמן המשוער להשלמת המדריך: כשעה.
מטרות
- איך מייבאים מסמכי מדיה כדי ליצור מאגר נתוני מדיה.
- ליצור, להגדיר ולבדוק אפליקציית חיפוש.
לפני שמתחילים את המדריך, חשוב לוודא שביצעתם את השלבים שמפורטים בקטע לפני שמתחילים.
לחצו על תראו לי איך כדי לקרוא הסבר מפורט על המשימה ישירות במסוף 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Agent Search (Discovery Engine), Cloud Storage, BigQuery APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.-
Make sure that you have the following role or roles on the project: Discovery Engine Admin and BigQuery Admin.
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
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.
- 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
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
-
In the New principals field, enter your user identifier. This is typically the email address for a Google Account.
- Click Select a role, then search for the role.
- To grant additional roles, click Add another role and add each additional role.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Agent Search (Discovery Engine), Cloud Storage, BigQuery APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.-
Make sure that you have the following role or roles on the project: Discovery Engine Admin and BigQuery Admin.
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
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.
- 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
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
- Click Grant access.
-
In the New principals field, enter your user identifier. This is typically the email address for a Google Account.
- Click Select a role, then search for the role.
- To grant additional roles, click Add another role and add each additional role.
- Click Save.
-
הכנת מערך הנתונים
הערה: אם השלמתם את המדריך תחילת העבודה עם המלצות למדיה ועדיין יש לכם את מאגר הנתונים (השם המוצעquickstart-media-data-store), דלגו אל יצירת אפליקציה לחיפוש מדיה.
אתם משתמשים ב-Cloud Shell כדי לייבא את קבוצת הנתונים של Movielens ולשנות את המבנה שלה בשביל חיפוש מבוסס סוכנים ל-media.
פתיחת Cloud Shell
- פותחים את מסוףGoogle Cloud .
- בוחרים את הפרויקט ב- Google Cloud .
- שימו לב למזהה הפרויקט שמופיע בכרטיס Project info בדף מרכז הבקרה. תצטרכו את מזהה הפרויקט בשביל התהליכים הבאים.
לוחצים על הכפתור Activate Cloud Shell בחלק העליון של המסוף. בחלק התחתון של מסוףGoogle Cloud ייפתח סשן של Cloud Shell במסגרת חדשה, ותופיע הודעה של שורת הפקודה. במאמר הפעלת Cloud Shell מוסבר איך להפעיל את Cloud Shell בדרכים אחרות.
ייבוא של מערך הנתונים
מערך הנתונים של Movielens זמין בקטגוריה ציבורית של Cloud Storage כדי שיהיה קל יותר לייבא אותו.
מריצים את הפקודה הבאה באמצעות מזהה הפרויקט כדי להגדיר את פרויקט ברירת המחדל לשורת הפקודה.
gcloud config set project PROJECT_IDיוצרים מערך נתונים ב-BigQuery:
bq mk movielensטעינת
movies.csvלטבלה חדשה ב-BigQuery ב-movies:bq load --skip_leading_rows=1 movielens.movies \ gs://cloud-samples-data/gen-app-builder/media-recommendations/movies.csv \ movieId:integer,title,genresטעינת
ratings.csvלטבלה חדשה ב-BigQuery ב-ratings:bq load --skip_leading_rows=1 movielens.ratings \ gs://cloud-samples-data/gen-app-builder/media-recommendations/ratings.csv \ userId:integer,movieId:integer,rating:float,time:timestamp
יצירת תצוגות ב-BigQuery
בשלב הזה, אתם משנים את המבנה של מערך הנתונים של Movielens כך שיתאים לפורמט הנדרש למאגרי נתונים של מדיה.
במדריך הזה, תיצרו view-item אירועי משתמשים מזויפים ב-90 הימים האחרונים מדירוגים חיוביים (>= 4).
יוצרים תצוגה (View) שממירה את טבלת הסרטים לסכימה
Document:bq mk --project_id=PROJECT_ID \ --use_legacy_sql=false \ --view ' WITH t AS ( SELECT CAST(movieId AS string) AS id, SUBSTR(title, 0, 128) AS title, SPLIT(genres, "|") AS categories FROM `PROJECT_ID.movielens.movies`) SELECT id, "default_schema" as schemaId, null as parentDocumentId, TO_JSON_STRING(STRUCT(title as title, categories as categories, CONCAT("http://mytestdomain.movie/content/", id) as uri, "2023-01-01T00:00:00Z" as available_time, "2033-01-01T00:00:00Z" as expire_time, "movie" as media_type)) as jsonData FROM t;' \ movielens.movies_viewעכשיו לתצוגה החדשה יש את הסכימה ש-Discovery Engine API מצפה לה.
נכנסים לדף BigQuery במסוף Google Cloud .
בחלונית Explorer, מרחיבים את שם הפרויקט, לוחצים על Datasets, בוחרים את קבוצת הנתונים
movielensולוחצים עלmovies_viewכדי לפתוח את דף הסכימה של התצוגה הזו.לחלופין, בחלונית הימנית לוחצים על database Data Explorer, מרחיבים את שם הפרויקט, מרחיבים את מערך הנתונים
movielensולוחצים עלmovies_viewכדי לפתוח את דף הסכימה של התצוגה הזו.עוברים לכרטיסייה סייר הטבלאות.
בחלונית Generated query, לוחצים על הכפתור Copy to query. עורך השאילתות ייפתח.
לוחצים על Run כדי לראות את נתוני הסרטים בתצוגה שיצרתם.
כדי ליצור אירועי משתמשים פיקטיביים מדירוגי סרטים, מריצים את הפקודה הבאה ב-Cloud Shell:
bq mk --project_id=PROJECT_ID \ --use_legacy_sql=false \ --view ' WITH t AS ( SELECT MIN(UNIX_SECONDS(time)) AS old_start, MAX(UNIX_SECONDS(time)) AS old_end, UNIX_SECONDS(TIMESTAMP_SUB( CURRENT_TIMESTAMP(), INTERVAL 90 DAY)) AS new_start, UNIX_SECONDS(CURRENT_TIMESTAMP()) AS new_end FROM `PROJECT_ID.movielens.ratings`) SELECT CAST(userId AS STRING) AS userPseudoId, "view-item" AS eventType, FORMAT_TIMESTAMP("%Y-%m-%dT%X%Ez", TIMESTAMP_SECONDS(CAST( (t.new_start + (UNIX_SECONDS(time) - t.old_start) * (t.new_end - t.new_start) / (t.old_end - t.old_start)) AS int64))) AS eventTime, [STRUCT(movieId AS id, null AS name)] AS documents, FROM `PROJECT_ID.movielens.ratings`, t WHERE rating >= 4;' \ movielens.user_events
הפעלת חיפוש מבוסס סוכנים
נכנסים לדף AI Applications במסוף Google Cloud .
אופציונלי: לוחצים על Google יכולה לדגום באופן סלקטיבי את הקלט והתשובות של המודל.
לוחצים על Continue and activate the API.
יצירת אפליקציה לחיפוש מדיה
בקטע הזה מוסבר איך יוצרים ופורסים אפליקציית חיפוש מדיה.
נכנסים לדף AI Applications במסוף Google Cloud .
לוחצים על
Create app .בדף Create App, בקטע Media catalog search, לוחצים על Create.
בשדה Your app name, מזינים שם לאפליקציה, למשל
quickstart-media-search. מזהה האפליקציה מופיע מתחת לשם המנוע.לוחצים על Continue.
אם השלמתם את המדריך תחילת העבודה עם המלצות למדיה ועדיין יש לכם את מאגר הנתונים (השם המוצע
quickstart-media-data-store), בחרו אותו, לחצו על Create ודלגו אל תצוגה מקדימה של החיפוש.אם אין לכם מאגר נתונים שמכיל את מערך הנתונים של movielens, צרו מאגר נתונים חדש ובחרו אותו:
בדף מאגרי נתונים, לוחצים על יצירת מאגר נתונים.
מזינים שם לתצוגה של מאגר הנתונים, למשל
quickstart-media-data-store, ולוחצים על Create.בוחרים את מאגר הנתונים שיצרתם ולוחצים על Create כדי ליצור את האפליקציה. תועברו לדף Select a data source.
ייבוא נתונים
בשלב הבא, מייבאים את נתוני הסרטים ואירועי המשתמשים שעברו עיצוב קודם לכן.
ייבוא מסמכים
אם אתם לא מועברים באופן אוטומטי לדף בחירת מקור נתונים:
- פותחים את הכרטיסייה מסמכים.
- לוחצים על ייבוא נתונים.
בדף Select a data source, בוחרים באפשרות BigQuery.
מזינים את השם של התצוגה המפורטת ב-BigQuery שיצרתם ב-
moviesולוחצים על ייבוא.PROJECT_ID.movielens.movies_viewממתינים עד שכל המסמכים ייובאו. התהליך אמור להימשך כ-15 דקות. בסיום התהליך אמורים להיות 86,537 מסמכים.
אפשר לבדוק את הסטטוס של פעולת הייבוא בכרטיסייה פעילות. כשהייבוא מסתיים, סטטוס פעולת הייבוא משתנה ל-Completed.
ייבוא אירועי משתמשים
פותחים את הכרטיסייה אירועים.
לוחצים על ייבוא אירועים.
בוחרים באפשרות BigQuery.
מזינים את השם של התצוגה המפורטת ב-BigQuery שיצרתם ב-
user_eventsולוחצים על ייבוא.PROJECT_ID.movielens.user_eventsאפשר להמשיך לשלב הבא לפני שהאירועים מיובאים, אבל תוצאות החיפוש עדיין לא יכילו את קבוצת הנתונים המלאה.
אפשר לבדוק את סטטוס הפעולה בכרטיסייה פעילות. התהליך נמשך כשעה כי אתם מייבאים מיליוני שורות.
תצוגה מקדימה והגדרת החיפוש
בתפריט הניווט, לוחצים על
Configurations .בתיבה חיפוש כאן, מקלידים שם של סרט, למשל "שר הטבעות".
שימו לב שתוצאות החיפוש רלוונטיות לשם הסרט שהזנתם.
בדף הזה אתם יכולים להתאים אישית את האופן שבו ווידג'ט חיפוש Google מציג את המידע בתוצאות החיפוש. מידע נוסף זמין במאמר הגדרת תוצאות לווידג'ט חיפוש Google.
באפליקציות לחיפוש מדיה, אתם יכולים:
אחרי שמבצעים את השינויים, לוחצים על שמירה ופרסום כדי לעדכן את הווידג'ט.
פריסת ווידג'ט חיפוש Google
בתפריט הניווט, לוחצים על Integration (שילוב).
מוודאים שהכרטיסייה ווידג'ט מסומנת.
בוחרים באפשרות מבוסס על JWT או OAuth בתור סוג ההרשאה של הווידג'ט.
בשדה Domain, מזינים את שם הדומיין של דף האינטרנט שבו רוצים להציב את הווידג'ט. לדוגמה, אם אתם מתכוונים להעתיק את הווידג'ט לדף האינטרנט
example.com/ai.html, הזינו אתexample.comבתור הדומיין.לוחצים על הוספה ואז על שמירה.
מעתיקים את קטע הקוד שמופיע בקטע העתקת הקוד הבא לאפליקציית האינטרנט.
בבסיס הקוד, יוצרים אסימון הרשאה.
כדי להעביר את אסימון ההרשאה לווידג'ט, משתמשים בקטע הקוד "Set authorization token" שמופיע בקטע Copy the following code to your אפליקציית אינטרנט ומחליפים את הטקסט
<JWT or OAuth token provided by you backend>באסימון ההרשאה.כדי לקבל עזרה בשילוב אפליקציית החיפוש באפליקציית האינטרנט, עיינו בדוגמאות הקוד בקטע קבלת תוצאות חיפוש.
הסרת המשאבים
כדי לא לצבור חיובים בחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, מבצעים את הפעולות הבאות.
אתם יכולים להשתמש שוב במאגר הנתונים שיצרתם להמלצות על מדיה במדריך תחילת העבודה עם המלצות על מדיה. כדאי לנסות את המדריך הזה לפני שמבצעים את תהליך הניקוי.
- כדי להימנע מחיובים מיותרים ב- Google Cloud , אם אתם לא צריכים את הפרויקט, מחקו אותו באמצעותGoogle Cloud console .
- אם יצרתם פרויקט חדש כדי ללמוד על "חיפוש מבוסס סוכנים" ואתם לא צריכים אותו יותר, מחקו את הפרויקט.
- אם השתמשתם בפרויקט קיים ב- Google Cloud , מחקו את המשאבים שיצרתם כדי להימנע מחיובים בחשבון. מידע נוסף זמין במאמרים מחיקת אפליקציה, מחיקת נתונים ממאגר נתונים ומחיקת מאגר נתונים.
- פועלים לפי השלבים שמפורטים בקטע השבתת Agent Search.
אם יצרתם מערך נתונים ב-BigQuery, מחקו אותו ב-Cloud Shell:
bq rm --recursive --dataset movielens