בדף הזה מוסבר איך להפעיל את Conversational Analytics API (אפשר לגשת אליו דרך geminidataanalytics.googleapis.com או נקודות קצה אזוריות) בפרויקטGoogle Cloud . Conversational Analytics API הוא היכולת הראשונה במסגרת Data Analytics API עם Gemini במסוף Google Cloud .
לפני שמתחילים
כדי להשתמש ב-Conversational Analytics API, צריך שיהיה לכם Google Cloud פרויקט עם גישה לנתונים שאתם רוצים לעבוד איתם. כדי להגדיר את הפרויקט, מבצעים את השלבים הבאים:
מזהים את הנתונים שרוצים להשתמש בהם עם Conversational Analytics API. אפשר להשתמש במקורות נתונים כמו טבלאות ב-BigQuery, ניתוחים ב-Looker, דוחות Data Studio ונתונים מ-AlloyDB ל-PostgreSQL, GoogleSQL for Spanner, Cloud SQL ל-MySQL ו-Cloud SQL ל-PostgreSQL.
בדף לבחירת הפרויקט במסוף Google Cloud , יוצרים Google Cloud פרויקט שיכול לגשת לנתונים שרוצים להשתמש בהם עם Conversational Analytics API.
הדרישות של Looker ו-Data Studio Pro
אם אתם משתמשים ב-API של ניתוח נתונים בשיחה עם Looker, המכונה של Looker צריכה לעמוד בדרישות ספציפיות:
כדי להשתמש ב-Conversational Analytics API עם Data Studio Pro, המינוי ל-Pro צריך להיות מחוץ לגבולות גזרה של VPC-SC.
הדרישות של AlloyDB
אם אתם משתמשים ב-Conversational Analytics API עם AlloyDB, מופע AlloyDB שלכם צריך לעמוד בדרישות ספציפיות. משלימים את כל השלבים שבקטע לפני שמתחילים.
הדרישות של Cloud SQL ל-MySQL
אם אתם משתמשים ב-Conversational Analytics API עם Cloud SQL ל-MySQL, המופע של Cloud SQL צריך לעמוד בדרישות ספציפיות. משלימים את כל השלבים שבקטע לפני שמתחילים.
הדרישות של Cloud SQL ל-PostgreSQL
אם אתם משתמשים ב-Conversational Analytics API עם Cloud SQL ל-PostgreSQL, מכונת Cloud SQL שלכם צריכה לעמוד בדרישות ספציפיות. מבצעים את כל השלבים בקטע לפני שמתחילים.
דרישות לשימוש ב-Spanner
אם אתם משתמשים ב-Conversational Analytics API עם Spanner, מופע Spanner שלכם צריך לעמוד בדרישות ספציפיות. מבצעים את כל השלבים בקטע לפני שמתחילים.
הפעלת ממשקי ה-API הנדרשים
כדי להשתמש ב-Conversational Analytics API, צריך להפעיל קבוצה של ממשקי API נדרשים ב Google Cloud פרויקט. אם אתם מתכננים להשתמש ב-Conversational Analytics API מסביבת Colab Enterprise, תצטרכו גם להפעיל ממשקי API נוספים.
ממשקי API נדרשים
console
אם הם עדיין לא מופעלים, מפעילים את ממשקי ה-API הבאים בפרויקטGoogle Cloud שבו תשתמשו עם Conversational Analytics API.
הפעלת Gemini Data Analytics API
gcloud
מריצים את הפקודות הבאות של Google Cloud CLI gcloud services enable כדי להפעיל את Gemini Data Analytics API, את Gemini forGoogle Cloud API ואת BigQuery API, בהתאמה:
gcloud services enable geminidataanalytics.googleapis.com --project=project_id gcloud services enable cloudaicompanion.googleapis.com --project=project_id gcloud services enable bigquery.googleapis.com --project=project_id
בפקודות לדוגמה הקודמות של ה-CLI של gcloud, מחליפים את project_id במזהה הפרויקט שלכם Google Cloud .
ממשקי API ל-Colab Enterprise
אם אתם מתכננים להשתמש ב-Conversational Analytics API בסביבת Colab Enterprise, אתם צריכים לוודא שגם ממשקי ה-API הבאים מופעלים:
מתן התפקידים הנדרשים
כדי להשתמש ב-Conversational Analytics API, לגורמים (principals) כמו משתמשים או חשבונות שירות, נדרשים תפקידים בניהול זהויות והרשאות גישה (IAM) שמעניקים גישה גם ל-API וגם למקורות הנתונים הבסיסיים.
כדי להעניק את התפקידים האלה, משתמשים ב Google Cloud מסוף:
תפקידים ב-Gemini Data Analytics
כדי לאפשר לחשבונות משתמשים ליצור סוכנים של Conversational Analytics API ולהשתמש בשיטת הצ'אט עם שמירת מצב השיחה, צריך להעניק את תפקידי ה-IAM הבאים:
- הכלי ליצירת סוכני נתונים של Gemini Data Analytics (
roles/geminidataanalytics.dataAgentCreator): נדרש כדי להתחיל ליצור סוכנים רק ב-BigQuery, ב-Looker וב-Data Studio Pro. - Gemini for Google Cloud User (
roles/cloudaicompanion.user): נדרש כדי להשתמש בשיטת הצ'אט עם שמירת מצב לשיחות.
בנוסף, ההרשאות לפעולות כמו ניהול סוכנים נשלטות על ידי תפקידים ב-Gemini Data Analytics, כפי שמתואר במאמר בקרת גישה ל-Conversational Analytics API באמצעות IAM.
תפקידים ב-BigQuery
כדי לאפשר לישויות ראשיות לשלוח שאילתות למקורות נתונים של BigQuery באמצעות Conversational Analytics API, צריך להעניק את תפקידי ה-IAM הבאים:
- BigQuery User (
roles/bigquery.user): נדרש כדי לגשת לנתונים ב-BigQuery. - BigQuery Studio User (
roles/bigquery.studioUser): נדרש אם משתמשים ב-BigQuery Studio ובקנבס נתונים.
תפקידים ב-Looker
כדי לאפשר לגורמים ראשיים להריץ שאילתות על מקורות נתונים של Looker באמצעות Conversational Analytics API, צריך להעניק את תפקידי ה-IAM הבאים:
- משתמש במופע Looker (
roles/looker.instanceUser): נדרש כדי לגשת לנתונים ממופע Looker (Google Cloud Core).
כדי להשתמש ב-Conversational Analytics וב-Conversational Analytics API, צריך להקצות למשתמש ב-Looker תפקיד ב-Looker שכולל את ההרשאה gemini_in_looker למודלים שהוא מבצע איתם אינטראקציה.
תפקידים במסד הנתונים
כדי לאפשר לישויות ראשיות לשלוח שאילתות למקורות נתונים של AlloyDB, Cloud SQL ל-MySQL, Cloud SQL ל-PostgreSQL או Spanner באמצעות Conversational Analytics API, צריך להעניק את תפקידי ה-IAM הבאים:
- משתמש במסד נתונים של AlloyDB (
roles/alloydb.databaseUser): נדרש כדי לגשת לנתונים ממופע של AlloyDB. - משתמש ב-Cloud SQL ל-MySQL וב-Cloud SQL Studio ל-PostgreSQL (
roles/cloudsql.studioUser): נדרש כדי להשתמש במסוף Google Cloud לצפייה במופעים של Cloud SQL ל-MySQL ו-Cloud SQL ל-PostgreSQL ולניהול שלהם. - משתמש במופע של Cloud SQL ל-MySQL ו-Cloud SQL ל-PostgreSQL (
roles/cloudsql.instanceUser): נדרש כדי להתחבר למופעים של Cloud SQL ל-MySQL ו-Cloud SQL ל-PostgreSQL. - Spanner Database Reader (
roles/spanner.databaseReader): נדרש כדי לקרוא נתונים ממסד נתונים של GoogleSQL for Spanner.
המאמרים הבאים
- מידע נוסף על בקרת גישה ל-Conversational Analytics API
- איך מגדירים את VPC Service Controls עבור Conversational Analytics API
המאמרים הבאים
- איך מאמתים את מקור הנתונים ואת ה-API
- איך יוצרים סוכן נתונים באמצעות Python SDK
- איך יוצרים סוכן נתונים באמצעות HTTP ו-Python