בדף הזה מוסבר איך להפעיל את 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 Console עבור הפרויקט Google Cloud שבו תשתמשו עם Conversational Analytics API.
הפעלת Gemini Data Analytics API
gcloud
מריצים את הפקודות הבאות של gcloud services enable ב-Google Cloud CLI כדי להפעיל את Gemini Data Analytics API, את Gemini for Google 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 Data Agent Creator (
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 ל-PostgreSQL Studio (
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