REST Resource: projects.locations.dataAgents

משאב: DataAgent

הודעה שמתארת אובייקט DataAgent.

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "purgeTime": string,

  // Union field type can be only one of the following:
  "dataAnalyticsAgent": {
    object (DataAnalyticsAgent)
  }
  // End of list of possible types for union field type.
}
שדות
name

string

זה שינוי אופציונלי. מזהה. שם המשאב הייחודי של DataAgent. פורמט: projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent} הוא מזהה המשאב, צריך להיות באורך של 63 תווים או פחות, ולהתאים לפורמט שמתואר בכתובת https://google.aip.dev/122#resource-id-segments

דוגמה: projects/1234567890/locations/global/dataAgents/my-agent

מומלץ לדלג על הגדרת השדה הזה במהלך יצירת הסוכן, כי הוא יוסק באופן אוטומטי ויוחלף בערך {parent}/dataAgents/{dataAgentId}.
displayName

string

זה שינוי אופציונלי. שם מוצג ידידותי למשתמש.

  • האורך צריך להיות בין 1 ל-256 תווים.
description

string

זה שינוי אופציונלי. תיאור הסוכן.

  • האורך צריך להיות בין 1 ל-1,024 תווים.
labels

map (key: string, value: string)

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

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

פלט בלבד. השעה שבה נוצר סוכן הנתונים.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

פלט בלבד. [פלט בלבד] השעה שבה סוכן הנתונים נמחק באופן זמני.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
purgeTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
שדה איחוד type. סוג הסוכן. יכול להיות אחד מהערכים הבאים: * סוכן ניתוח נתונים. * סוכן הנדסת נתונים type יכול להיות רק אחד מהבאים:
dataAnalyticsAgent

object (DataAnalyticsAgent)

סוכן לניתוח נתונים.

DataAnalyticsAgent

הודעה שמתארת אובייקט DataAnalyticsAgent.

ייצוג ב-JSON 
{
  "stagingContext": {
    object (Context)
  },
  "publishedContext": {
    object (Context)
  },
  "lastPublishedContext": {
    object (Context)
  }
}
שדות
stagingContext

object (Context)

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

object (Context)

זה שינוי אופציונלי. ההקשר שפורסם של הסוכן. ההקשר הזה משמש את Chat API בסביבת הייצור.
lastPublishedContext

object (Context)

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

הקשר

אוסף של הקשרים להחלתם על השיחה הזו

ייצוג ב-JSON 
{
  "systemInstruction": string,
  "datasourceReferences": {
    object (DatasourceReferences)
  },
  "options": {
    object (ConversationOptions)
  },
  "exampleQueries": [
    {
      object (ExampleQuery)
    }
  ],
  "lookerGoldenQueries": [
    {
      object (LookerGoldenQuery)
    }
  ],
  "glossaryTerms": [
    {
      object (GlossaryTerm)
    }
  ],
  "schemaRelationships": [
    {
      object (SchemaRelationship)
    }
  ]
}
שדות
systemInstruction

string

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

הסיבה: שימוש בז'רגון עסקי (למשל, הוראות כמו 'ההכנסה מתחילת השנה מחושבת כך…', 'גיל הפרישה בארה"ב הוא 65' וכו' והוראות מערכת (למשל, 'תענה כמו פיראט') יכולות לעזור למודל להבין את ההקשר העסקי של שאלת המשתמש.
datasourceReferences

object (DatasourceReferences)

חובה. מקורות הנתונים שזמינים למענה על השאלה.
options

object (ConversationOptions)

זה שינוי אופציונלי. אפשרויות נוספות לשיחה.
exampleQueries[]

object (ExampleQuery)

זה שינוי אופציונלי. רשימה של שאילתות לדוגמה, עם דוגמאות לשאילתות SQL רלוונטיות והכי רווחיות, ושאילתות בשפה טבעית שמתאימות להן (אופציונלי). בשלב הזה, נעשה שימוש בפרמטר הזה רק במקורות נתונים של BigQuery.
lookerGoldenQueries[]

object (LookerGoldenQuery)

זה שינוי אופציונלי. רשימה של שאילתות לדוגמה, עם דוגמאות לשאילתות רלוונטיות והכי רווחיות ב-Looker, ואפשרות להציג את השאילתות המתאימות בשפה טבעית.
glossaryTerms[]

object (GlossaryTerm)

זה שינוי אופציונלי. הגדרות של מונחים (בשלב הזה, רק כאלה שהמשתמשים יצרו)
schemaRelationships[]

object (SchemaRelationship)

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

DatasourceReferences

אוסף של הפניות למקורות נתונים.

ייצוג ב-JSON 
{

  // Union field references can be only one of the following:
  "bq": {
    object (BigQueryTableReferences)
  },
  "studio": {
    object (StudioDatasourceReferences)
  },
  "looker": {
    object (LookerExploreReferences)
  },
  "alloydb": {
    object (AlloyDbReference)
  },
  "spannerReference": {
    object (SpannerReference)
  },
  "cloudSqlReference": {
    object (CloudSqlReference)
  }
  // End of list of possible types for union field references.
}
שדות
שדה איחוד references. מקורות הנתונים שבהם רוצים להשתמש. הערך references יכול להיות רק אחד מהבאים:
bq

object (BigQueryTableReferences)

הפניות לטבלאות BigQuery.
studio

object (StudioDatasourceReferences)

הפניות למקורות נתונים של Looker Studio.
looker

object (LookerExploreReferences)

הפניות ל-Looker Explores.
alloydb

object (AlloyDbReference)

התייחסות למסד נתונים של AlloyDB. האפשרות הזו נתמכת רק בשיטה QueryData.
spannerReference

object (SpannerReference)

הפניה למסד נתונים של Spanner. האפשרות הזו נתמכת רק בשיטה QueryData.
cloudSqlReference

object (CloudSqlReference)

הפניה למסד נתונים של CloudSql. האפשרות הזו נתמכת רק בשיטה QueryData.

BigQueryTableReferences

הודעה שמייצגת הפניות לטבלאות BigQuery ולגרפים של נכסים. צריך למלא לפחות אחד מהשדות tableReferences או propertyGraphReferences.

ייצוג ב-JSON 
{
  "tableReferences": [
    {
      object (BigQueryTableReference)
    }
  ]
}
שדות
tableReferences[]

object (BigQueryTableReference)

זה שינוי אופציונלי. הפניות לטבלאות BigQuery.

BigQueryTableReference

הודעה שמייצגת הפניה לטבלה יחידה ב-BigQuery.

ייצוג ב-JSON 
{
  "projectId": string,
  "datasetId": string,
  "tableId": string,
  "schema": {
    object (Schema)
  }
}
שדות
projectId

string

חובה. הפרויקט שהטבלה שייכת אליו.
datasetId

string

חובה. מערך הנתונים שהטבלה שייכת אליו.
tableId

string

חובה. מזהה הטבלה.
schema

object (Schema)

זה שינוי אופציונלי. הסכימה של מקור הנתונים.

סכימה

הסכימה של מופע של Datasource או QueryResult.

ייצוג ב-JSON 
{
  "fields": [
    {
      object (Field)
    }
  ],
  "description": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "filters": [
    {
      object (DataFilter)
    }
  ]
}
שדות
fields[]

object (Field)

זה שינוי אופציונלי. השדות בסכימה.
description

string

זה שינוי אופציונלי. תיאור טקסטואלי של תוכן הטבלה והמטרה שלה. לדוגמה: "האימייל הזה מכיל מידע על הזמנות של לקוחות בחנות המסחר האלקטרוני שלנו". בשלב הזה, נעשה שימוש בפרמטר הזה רק במקורות נתונים של BigQuery.
synonyms[]

string

זה שינוי אופציונלי. רשימה של שמות חלופיים או מילים נרדפות שאפשר להשתמש בהם כדי להתייחס לטבלה. לדוגמה: ['sales', 'orders', 'purchases']. בשלב הזה, נעשה שימוש בפרמטר הזה רק במקורות נתונים של BigQuery.
tags[]

string

זה שינוי אופציונלי. רשימה של תגים או מילות מפתח שמשויכים לטבלה, ומשמשים לסיווג. לדוגמה: ‎["transaction", "revenue", "customer_data"]‎. בשלב הזה, נעשה שימוש בפרמטר הזה רק במקורות נתונים של BigQuery.
displayName

string

זה שינוי אופציונלי. השם המוצג של הטבלה (זהה לתווית ב-cloud/data_analytics/anarres/data/looker/proto/model_explore.proto), לא נדרש, כרגע רק ל-Looker יש את השדה הזה.
filters[]

object (DataFilter)

זה שינוי אופציונלי. המסננים של נתוני הבסיס של מקור הנתונים. בשלב הזה, המאפיין הזה משמש רק למקורות נתונים של Looker.

שדה

שדה בסכימה.

ייצוג ב-JSON 
{
  "name": string,
  "type": string,
  "description": string,
  "mode": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "subfields": [
    {
      object (Field)
    }
  ],
  "category": string,
  "valueFormat": string
}
שדות
name

string

זה שינוי אופציונלי. שם השדה.
type

string

זה שינוי אופציונלי. סוג השדה.
description

string

זה שינוי אופציונלי. תיאור קצר של השדה.
mode

string

זה שינוי אופציונלי. השיטה של השדה (למשל, יכול להיות ריק, מרובה ערכים).
synonyms[]

string

זה שינוי אופציונלי. רשימה של שמות חלופיים או מילים נרדפות שאפשר להשתמש בהם כדי להתייחס לשדה הזה. לדוגמה: ‎["id", "customerid", "cust_id"]‎. בשלב הזה, נעשה שימוש בפרמטר הזה רק במקורות נתונים של BigQuery.
tags[]

string

זה שינוי אופציונלי. רשימה של תגים או מילות מפתח שמשויכים לשדה, ומשמשים לסיווג. לדוגמה: ‎["identifier", "customer", "pii"]‎. בשלב הזה, נעשה שימוש בפרמטר הזה רק במקורות נתונים של BigQuery.
displayName

string

זה שינוי אופציונלי. השם המוצג של השדה (זהה לתווית ב-
subfields[]

object (Field)

זה שינוי אופציונלי. מאפיין רקורסיבי למבני סכימה מוטמעים.
category

string

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

string

זה שינוי אופציונלי. ‫Looker בלבד. פורמט הערך של השדה. ‫Ref: https://cloud.google.com/looker/docs/reference/param-field-value-format

DataFilter

מסנן של הנתונים הבסיסיים של מקור נתונים. מסמכי תיעוד בנושא תחביר של מסננים: https://cloud.google.com/looker/docs/filter-expressions

ייצוג ב-JSON 
{
  "field": string,
  "value": string,
  "type": enum (DataFilterType)
}
שדות
field

string

זה שינוי אופציונלי. השדה שלפיו יתבצע הסינון. לדוגמה: ‎["event_date", "customer_id", "product_category"]‎
value

string

זה שינוי אופציונלי. ערך ברירת המחדל שמשמש לסינון הזה אם לא מבטלים את הסינון בשאילתה. לדוגמה: ‎["after 2024-01-01", "123", "-fashion"]‎
type

enum (DataFilterType)

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

DataFilterType

סוג המסנן שמופיע במקור נתונים, כמו ALWAYS_FILTER.

טיפוסים בני מנייה (enum)
DATA_FILTER_TYPE_UNSPECIFIED לא צוין סוג המסנן.
ALWAYS_FILTER מסנן שהמשתמש מגדיר, וכל שאילתות החיפוש ב'ניתוח נתונים' יחילו את המסנן הזה תמיד כברירת מחדל. בשלב הזה, המאפיין הזה משמש רק למקורות נתונים של Looker.

StudioDatasourceReferences

הודעה שמייצגת הפניות למקורות נתונים של Looker Studio.

ייצוג ב-JSON 
{
  "studioReferences": [
    {
      object (StudioDatasourceReference)
    }
  ]
}
שדות
studioReferences[]

object (StudioDatasourceReference)

הפניות למקורות הנתונים של הסטודיו.

StudioDatasourceReference

הודעה שמייצגת הפניה למקור נתונים יחיד ב-Looker Studio.

ייצוג ב-JSON 
{
  "datasourceId": string
}
שדות
datasourceId

string

חובה. המזהה של מקור הנתונים.

LookerExploreReferences

הודעה שמייצגת הפניות לניתוחים ב-Looker.

ייצוג ב-JSON 
{
  "exploreReferences": [
    {
      object (LookerExploreReference)
    }
  ],
  "credentials": {
    object (Credentials)
  }
}
שדות
exploreReferences[]

object (LookerExploreReference)

חובה. אזכורים של אפשרויות נוספות ב-Looker.
credentials

object (Credentials)

זה שינוי אופציונלי. פרטי הכניסה שבהם יש להשתמש כשקוראים ל-Looker API.

הוא תומך כרגע בפרטי כניסה שמבוססים על אסימון OAuth ועל מפתח API, כפי שמתואר במאמר אימות באמצעות SDK.

LookerExploreReference

הודעה שמייצגת הפניה לניתוח נתונים ב-Looker.

ייצוג ב-JSON 
{
  "lookmlModel": string,
  "explore": string,
  "schema": {
    object (Schema)
  },

  // Union field instance can be only one of the following:
  "lookerInstanceUri": string,
  "privateLookerInstanceInfo": {
    object (PrivateLookerInstanceInfo)
  }
  // End of list of possible types for union field instance.
}
שדות
lookmlModel

string

חובה. מודל Looker, כפי שמתואר במאמר מבנים עיקריים של LookML. השם של מודל LookML.
explore

string

חובה. ‫Looker Explore, כמו שמתואר במבנים עיקריים של LookML. השם של ניתוח LookML.
schema

object (Schema)

זה שינוי אופציונלי. הסכימה של מקור הנתונים.
שדה איחוד instance. המופע של הניתוח ב-Looker. הערך instance יכול להיות רק אחד מהבאים:
lookerInstanceUri

string

חובה. כתובת ה-URL הבסיסית של המופע ב-Looker.
privateLookerInstanceInfo

object (PrivateLookerInstanceInfo)

פרטים על מופע פרטי של Looker.

PrivateLookerInstanceInfo

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

ייצוג ב-JSON 
{
  "lookerInstanceId": string,
  "serviceDirectoryName": string
}
שדות
lookerInstanceId

string

מזהה המופע ב-Looker.
serviceDirectoryName

string

השם של מופע Looker בספריית השירותים.

פרטי כניסה

מייצג צורות שונות של הגדרת פרטי כניסה.

ייצוג ב-JSON 
{

  // Union field kind can be only one of the following:
  "oauth": {
    object (OAuthCredentials)
  }
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג פרטי הכניסה. } הערך kind יכול להיות רק אחד מהבאים:
oauth

object (OAuthCredentials)

פרטי כניסה של OAuth.

OAuthCredentials

ייצוג של פרטי כניסה של OAuth.

ייצוג ב-JSON 
{

  // Union field kind can be only one of the following:
  "secret": {
    object (SecretBased)
  },
  "token": {
    object (TokenBased)
  }
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג פרטי הכניסה של OAuth. הערך kind יכול להיות רק אחד מהבאים:
secret

object (SecretBased)

פרטי כניסה מבוססי-סוד ב-OAuth.
token

object (TokenBased)

פרטי כניסה של OAuth שמבוססים על טוקנים.

SecretBased

השם של הסוד שמכיל את אסימון הגישה. מייצג פרטי כניסה מבוססי-סוד של OAuth.

ייצוג ב-JSON 
{
  "clientId": string,
  "clientSecret": string
}
שדות
clientId

string

חובה. מזהה לקוח ב-OAuth.
clientSecret

string

חובה. סוד של לקוח OAuth.

TokenBased

מידע נוסף על טוקנים לגישה ל-Looker זמין כאן: https://developers.looker.com/api/advanced-usage/looker-api-oauth

ייצוג ב-JSON 
{
  "accessToken": string
}
שדות
accessToken

string

חובה. השם של הסוד שמכיל את אסימון הגישה.

AlloyDbReference

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

ייצוג ב-JSON 
{
  "databaseReference": {
    object (AlloyDbDatabaseReference)
  },
  "agentContextReference": {
    object (AgentContextReference)
  }
}
שדות
databaseReference

object (AlloyDbDatabaseReference)

חובה. פרוטו יחיד שתומך בציון מסד הנתונים והטבלאות שרוצים לכלול.
agentContextReference

object (AgentContextReference)

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

AlloyDbDatabaseReference

הודעה שמייצגת הפניה למסד נתונים יחיד של AlloyDB.

ייצוג ב-JSON 
{
  "projectId": string,
  "region": string,
  "clusterId": string,
  "instanceId": string,
  "databaseId": string,
  "tableIds": [
    string
  ]
}
שדות
projectId

string

חובה. הפרויקט שאליו שייך המופע.
region

string

חובה. האזור של המכונה.
clusterId

string

חובה. מזהה האשכול.
instanceId

string

חובה. מזהה המופע.
databaseId

string

חובה. מזהה מסד הנתונים.
tableIds[]

string

זה שינוי אופציונלי. מזהי הטבלאות. אם לא מציינים טבלאות, הכוונה היא לכל הטבלאות.

AgentContextReference

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

ייצוג ב-JSON 
{
  "contextSetId": string
}
שדות
contextSetId

string

חובה. מזהה של קבוצת ההקשר שרוצים לאחזר.

SpannerReference

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

ייצוג ב-JSON 
{
  "databaseReference": {
    object (SpannerDatabaseReference)
  },
  "agentContextReference": {
    object (AgentContextReference)
  }
}
שדות
databaseReference

object (SpannerDatabaseReference)

חובה. פרוטו יחיד שתומך בציון מסד הנתונים והטבלאות שרוצים לכלול.
agentContextReference

object (AgentContextReference)

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

SpannerDatabaseReference

הודעה שמייצגת הפניה למסד נתונים יחיד ב-Spanner.

ייצוג ב-JSON 
{
  "engine": enum (Engine),
  "projectId": string,
  "region": string,
  "instanceId": string,
  "databaseId": string,
  "tableIds": [
    string
  ]
}
שדות
engine

enum (Engine)

חובה. המנוע של מכונת Spanner.
projectId

string

חובה. הפרויקט שאליו שייך המופע.
region

string

חובה. האזור של המכונה.
instanceId

string

חובה. מזהה המופע.
databaseId

string

חובה. מזהה מסד הנתונים.
tableIds[]

string

זה שינוי אופציונלי. מזהי הטבלאות. אם לא מציינים טבלאות, הכוונה היא לכל הטבלאות.

מנוע

המנוע של מסד הנתונים.

טיפוסים בני מנייה (enum)
ENGINE_UNSPECIFIED לא צוין מנוע.
GOOGLE_SQL Google SQL
POSTGRESQL PostgreSQL

CloudSqlReference

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

ייצוג ב-JSON 
{
  "databaseReference": {
    object (CloudSqlDatabaseReference)
  },
  "agentContextReference": {
    object (AgentContextReference)
  }
}
שדות
databaseReference

object (CloudSqlDatabaseReference)

חובה. פרוטו יחיד שתומך בציון מסד הנתונים והטבלאות שרוצים לכלול.
agentContextReference

object (AgentContextReference)

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

CloudSqlDatabaseReference

הודעה שמייצגת הפניה למסד נתונים יחיד של CloudSQL.

ייצוג ב-JSON 
{
  "engine": enum (Engine),
  "projectId": string,
  "region": string,
  "instanceId": string,
  "databaseId": string,
  "tableIds": [
    string
  ]
}
שדות
engine

enum (Engine)

חובה. המנוע של מכונת Cloud SQL.
projectId

string

חובה. הפרויקט שאליו שייך המופע.
region

string

חובה. האזור של המכונה.
instanceId

string

חובה. מזהה המופע.
databaseId

string

חובה. מזהה מסד הנתונים.
tableIds[]

string

זה שינוי אופציונלי. מזהי הטבלאות. אם לא מציינים טבלאות, הכוונה היא לכל הטבלאות.

מנוע

המנוע של מסד הנתונים.

טיפוסים בני מנייה (enum)
ENGINE_UNSPECIFIED לא צוין מנוע.
POSTGRESQL PostgreSQL
MYSQL MySQL

ConversationOptions

אפשרויות לשיחה.

ייצוג ב-JSON 
{
  "chart": {
    object (ChartOptions)
  },
  "analysis": {
    object (AnalysisOptions)
  },
  "datasource": {
    object (DatasourceOptions)
  }
}
שדות
chart

object (ChartOptions)

זה שינוי אופציונלי. אפשרויות ליצירת תרשים.
analysis

object (AnalysisOptions)

זה שינוי אופציונלי. אפשרויות לניתוח.
datasource

object (DatasourceOptions)

זה שינוי אופציונלי. אפשרויות למקורות נתונים.

ChartOptions

אפשרויות ליצירת תרשים.

ייצוג ב-JSON 
{
  "image": {
    object (ImageOptions)
  }
}
שדות
image

object (ImageOptions)

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

ImageOptions

אפשרויות לעיבוד תמונות של תרשימים שנוצרו.

ייצוג ב-JSON 
{

  // Union field kind can be only one of the following:
  "noImage": {
    object (NoImage)
  },
  "svg": {
    object (SvgOptions)
  }
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג התמונה שתוצג. הערך kind יכול להיות רק אחד מהבאים:
noImage

object (NoImage)

אין תמונה.
svg

object (SvgOptions)

פורמט SVG.

NoImage

בסוג הזה אין שדות.

אין תמונה.

SvgOptions

בסוג הזה אין שדות.

אפשרויות SVG.

AnalysisOptions

אפשרויות לניתוח.

ייצוג ב-JSON 
{
  "python": {
    object (Python)
  }
}
שדות
python

object (Python)

זה שינוי אופציונלי. אפשרויות לניתוח Python.

Python

אפשרויות לניתוח Python.

ייצוג ב-JSON 
{
  "enabled": boolean
}
שדות
enabled

boolean

זה שינוי אופציונלי. האם להפעיל ניתוח Python. ברירת המחדל היא False.

DatasourceOptions

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

ייצוג ב-JSON 
{
  "bigQueryMaxBilledBytes": string
}
שדות
bigQueryMaxBilledBytes

string (Int64Value format)

זה שינוי אופציונלי. האפשרות הזו רלוונטית למקורות נתונים שנדרשות לגביהם רק שאילתות BigQuery. כדי להגביל את החיוב, מספר הבייטים של כל משימת שאילתה ב-BQ יוגבל. אם השאילתה תחרוג ממגבלת הבייטים לחיוב, הרצת השאילתה תיכשל (החשבון לא יחויב). אם לא מציינים מגבלה, לא תהיה מגבלה.

ExampleQuery

דוגמה לשאילתת SQL רלוונטית והכי רווחית, ולשאילתות בשפה טבעית שמתאימות לה (אם יש כאלה). בשלב הזה, נעשה שימוש בפרמטר הזה רק במקורות נתונים של BigQuery.

ייצוג ב-JSON 
{
  "naturalLanguageQuestion": string,

  // Union field query can be only one of the following:
  "sqlQuery": string
  // End of list of possible types for union field query.
}
שדות
naturalLanguageQuestion

string

זה שינוי אופציונלי. שאלה בשפה טבעית שמשתמש עשוי לשאול. לדוגמה: "כמה הזמנות בוצעו בחודש שעבר?"
שדה איחוד query. שאילתת ה-SQL או Looker שצריך ליצור כדי לענות על השאילתה בשפה טבעית. הערך query יכול להיות רק אחד מהבאים:
sqlQuery

string

זה שינוי אופציונלי. שאילתת ה-SQL שצריך ליצור כדי לענות על השאלה בשפה טבעית. לדוגמה: "SELECT COUNT(*) FROM orders WHERE order_date BETWEEN '2024-01-01' AND '2024-01-31'"

LookerGoldenQuery

שאילתה לדוגמה ל-Looker, כולל שאלות בשפה טבעית ושאילתת Looker תואמת. מקביל ל-ExampleQuery.

ייצוג ב-JSON 
{
  "naturalLanguageQuestions": [
    string
  ],
  "lookerQuery": {
    object (LookerQuery)
  }
}
שדות
naturalLanguageQuestions[]

string

זה שינוי אופציונלי. שאלות בשפה טבעית שמשתמש עשוי לשאול. לדוגמה: "כמה הזמנות בוצעו בחודש שעבר?"
lookerQuery

object (LookerQuery)

זה שינוי אופציונלי. שאילתת Looker שמתאימה לשאלות בשפה הטבעית.

LookerQuery

אובייקט שאילתת Looker מאמרי העזרה של ה-API של Looker.

ייצוג ב-JSON 
{
  "model": string,
  "explore": string,
  "fields": [
    string
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "sorts": [
    string
  ],
  "limit": string
}
שדות
model

string

חובה. מודל LookML ששימש ליצירת השאילתה.
explore

string

חובה. השאילתה שנוצרה באמצעות כלי הניתוח LookML.
fields[]

string

זה שינוי אופציונלי. השדות לאחזור מהניתוח.
filters[]

object (Filter)

זה שינוי אופציונלי. המסננים להחלה על הניתוח.
sorts[]

string

זה שינוי אופציונלי. המיון שרוצים להחיל על הניתוח.
limit

string

זה שינוי אופציונלי. מגבלה בשאילתה.

מסנן

מסנן שאילתות ב-Looker.

ייצוג ב-JSON 
{
  "field": string,
  "value": string
}
שדות
field

string

חובה. השדה שלפיו יתבצע הסינון.
value

string

חובה. הערך של השדה שלפיו רוצים לסנן.

GlossaryTerm

הגדרה של מונח בדומיין ספציפי.

ייצוג ב-JSON 
{
  "displayName": string,
  "description": string,
  "labels": [
    string
  ]
}
שדות
displayName

string

חובה. שם המונח במילון המונחים שמוגדר, שקל להבין. לדוגמה: 'שיעור קליקים', 'שיעור המרה', 'בהמתנה'
description

string

חובה. התיאור או המשמעות של המונח. לדוגמה: 'שיעור קליקים', 'אחוז המשתמשים שמשלימים פעולה רצויה', 'הזמנה שממתינה לעיבוד'.
labels[]

string

זה שינוי אופציונלי. רשימה של תוויות למטרות כלליות שמשויכות למונח הזה. לדוגמה: ‎["שיעור קליקים", "קליקים", "waiting"]‎

SchemaRelationship

הקשר בין שתי טבלאות, כולל עמודות מפנות ועמודות שההפניה אליהן מתבצעת. זהו הקשר הנגזר שאוחזר מ-Dataplex Dataset Insights.

ייצוג ב-JSON 
{
  "leftSchemaPaths": {
    object (SchemaPaths)
  },
  "rightSchemaPaths": {
    object (SchemaPaths)
  },
  "sources": [
    enum (Source)
  ],
  "confidenceScore": number
}
שדות
leftSchemaPaths

object (SchemaPaths)

רשימה ממוינת של שדות לצירוף מהטבלה הראשונה. הגודל של הרשימה הזו צריך להיות זהה לערך rightSchemaPaths. כל שדה באינדקס i ברשימה הזו צריך להתאים לשדה באותו אינדקס ברשימה rightSchemaPaths.
rightSchemaPaths

object (SchemaPaths)

רשימה מסודרת של שדות לצירוף מהטבלה השנייה. הגודל של הרשימה הזו צריך להיות זהה לערך leftSchemaPaths. כל שדה באינדקס i ברשימה הזו צריך להתאים לשדה באותו אינדקס ברשימה leftSchemaPaths.
sources[]

enum (Source)

מקורות שיצרו את קצה הקשר של הסכימה.
confidenceScore

number

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

SchemaPaths

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

ייצוג ב-JSON 
{
  "tableFqn": string,
  "paths": [
    string
  ]
}
שדות
tableFqn

string

שם המשאב המלא של הטבלה שמוגדר במלואו על ידי השירות. דוגמה: bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
paths[]

string

רשימת הנתיבים הממוינת בסכימת הטבלה.

מקור

המקור שיצר את קצה הקשר של הסכימה.

טיפוסים בני מנייה (enum)
SOURCE_UNSPECIFIED לא צוין המקור של קשר הסכימה.
BIGQUERY_JOB_HISTORY המקור של קשר הסכימה הוא היסטוריית העבודות ב-BigQuery.
LLM_SUGGESTED המקור של קשר הסכימה הוא הצעה של LLM.
BIGQUERY_TABLE_CONSTRAINTS המקור של קשר הסכימה הוא אילוצים של טבלאות BigQuery.

Methods

create

 יוצרת סוכן נתונים חדש בפרויקט ובמיקום נתונים נתונים.

createSync

 יוצרת סוכן נתונים חדש בפרויקט ובמיקום נתונים נתונים באופן סינכרוני.

delete

 מחיקת סוכן נתונים יחיד.

deleteSync

 מחיקה של DataAgent יחיד באופן סינכרוני.

get

 קבלת פרטים של סוכן נתונים יחיד.

getIamPolicy

 קבלת מדיניות IAM עבור DataAgent

list

 מציג רשימה של סוכני נתונים בפרויקט ובמיקום נתונים.

listAccessible

 השיטה מחזירה רשימה של DataAgents שאפשר לגשת אליהם בפרויקט ובמיקום נתונים.

patch

 עדכון הפרמטרים של DataAgent יחיד.

setIamPolicy

 הגדרת מדיניות IAM עבור DataAgent.

updateSync

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