REST Resource: projects.locations.dataAgents

Ressource: DataAgent

Nachricht, die ein DataAgent-Objekt beschreibt.

JSON-Darstellung 
{
  "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.
  "kmsKey": string
}
Felder
name

string

Optional. ID. Der eindeutige Ressourcenname eines DataAgents. Format: projects/{project}/locations/{location}/dataAgents/{dataAgentId}. {dataAgent} ist die Ressourcen-ID. Sie darf maximal 63 Zeichen lang sein und muss dem Format entsprechen, das unter https://google.aip.dev/122#resource-id-segments beschrieben wird.

Beispiel: projects/1234567890/locations/global/dataAgents/my-agent.

Es wird empfohlen, dieses Feld bei der Agent-Erstellung nicht festzulegen, da es automatisch abgeleitet und mit {parent}/dataAgents/{dataAgentId} überschrieben wird.
displayName

string

Optional. Nutzerfreundlicher Anzeigename.

  • Muss 1–256 Zeichen umfassen.
description

string

Optional. Beschreibung des KI-Agenten.

  • Muss 1–1.024 Zeichen umfassen.
labels

map (key: string, value: string)

Optional. Labels, mit denen Nutzer ähnliche KI-Agenten filtern können. Beispiele: „sales“, „business“, „etl“ usw. Beachten Sie, dass Labels nur zum Filtern und nicht für Richtlinien verwendet werden. Weitere Informationen zur Verwendung von Labels finden Sie in der Dokumentation zu Labels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der KI-Datenagent erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der KI-Datenagent zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
deleteTime

string (Timestamp format)

Nur Ausgabe. [Nur Ausgabe] Der Zeitpunkt, zu dem der KI-Datenagent vorläufig gelöscht wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
purgeTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel in UTC, der angibt, wann dieser KI-Datenagent als abgelaufen gilt. Dies wird immer bei der Ausgabe angegeben, ungeachtet dessen, was bei der Eingabe gesendet wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
Union-Feld type. Der Typ des KI-Agenten. Kann einer der folgenden Werte sein: * Datenanalyse-Agent. * Der Data-Engineering-Agent type kann nur einer der folgenden Werte sein:
dataAnalyticsAgent

object (DataAnalyticsAgent)

Datenanalyse-Agent.
kmsKey

string

Optional. Vom Kunden verwalteter Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) zum Verschlüsseln der DataAgent-Ressourcen. Cloud KMS-Kryptoschlüssel müssen sich am selben Ort wie der DataAgent befinden. Das erwartete Format ist projects/*/locations/*/keyRings/*/cryptoKeys/*.

DataAnalyticsAgent

Nachricht, die ein DataAnalyticsAgent-Objekt beschreibt.

JSON-Darstellung 
{
  "stagingContext": {
    object (Context)
  },
  "publishedContext": {
    object (Context)
  },
  "lastPublishedContext": {
    object (Context)
  }
}
Felder
stagingContext

object (Context)

Optional. Der Staging-Kontext für den KI-Agenten. Dieser Kontext wird verwendet, um Änderungen vor der Veröffentlichung zu testen und zu validieren.
publishedContext

object (Context)

Optional. Der veröffentlichte Kontext für den KI-Agenten. Dieser Kontext wird von der Chat API in der Produktion verwendet.
lastPublishedContext

object (Context)

Nur Ausgabe. Der zuletzt veröffentlichte Kontext für den KI-Agenten. Dies ist ein reines Ausgabefeld und wird vom System ausgefüllt, wenn der veröffentlichte Kontext aktualisiert wird. Damit wird der KI-Agent in einen vorherigen Zustand zurückversetzt.

Context

Eine Sammlung von Kontext, der auf diese Unterhaltung angewendet werden soll.

JSON-Darstellung 
{
  "systemInstruction": string,
  "datasourceReferences": {
    object (DatasourceReferences)
  },
  "options": {
    object (ConversationOptions)
  },
  "exampleQueries": [
    {
      object (ExampleQuery)
    }
  ],
  "lookerGoldenQueries": [
    {
      object (LookerGoldenQuery)
    }
  ],
  "glossaryTerms": [
    {
      object (GlossaryTerm)
    }
  ],
  "schemaRelationships": [
    {
      object (SchemaRelationship)
    }
  ]
}
Felder
systemInstruction

string

Optional. Der grundlegende Einstiegspunkt für Dateninhaber, die Domainwissen für den KI-Agenten erstellen.

Grund: Geschäftsjargon (z. B. der Umsatz seit Jahresbeginn wird folgendermaßen berechnet…, das Rentenalter in den USA beträgt 65 Jahre usw.) und Systemanweisungen (z. B. antworte wie ein Pirat) können dem Modell helfen, den geschäftlichen Kontext einer Nutzerfrage zu verstehen.
datasourceReferences

object (DatasourceReferences)

Erforderlich. Datenquellen, die zur Beantwortung der Frage zur Verfügung stehen.
options

object (ConversationOptions)

Optional. Zusätzliche Optionen für die Unterhaltung.
exampleQueries[]

object (ExampleQuery)

Optional. Eine Liste mit Beispielabfragen, die Beispiele für relevante und häufig verwendete SQL-Abfragen und optional die entsprechenden Abfragen in natürlicher Sprache enthält. Wird derzeit nur für BigQuery-Datenquellen verwendet.
lookerGoldenQueries[]

object (LookerGoldenQuery)

Optional. Eine Liste mit Golden Queries, die Beispiele für relevante und häufig verwendete Looker-Abfragen und optional die entsprechenden Abfragen in natürlicher Sprache enthält.
glossaryTerms[]

object (GlossaryTerm)

Optional. Begriffsdefinitionen (derzeit nur von Nutzern erstellt)
schemaRelationships[]

object (SchemaRelationship)

Optional. Beziehungen zwischen Tabellenschema, einschließlich referenzierender und referenzierter Spalten.

DatasourceReferences

Eine Sammlung von Verweisen auf Datenquellen.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld references. Die zu verwendenden Datenquellen. Für references ist nur einer der folgenden Werte zulässig:
bq

object (BigQueryTableReferences)

Verweise auf BigQuery-Tabellen.
studio

object (StudioDatasourceReferences)

Verweise auf Looker Studio-Datenquellen.
looker

object (LookerExploreReferences)

Verweise auf Looker-Explores.
alloydb

object (AlloyDbReference)

Verweis auf eine AlloyDB-Datenbank. Wird nur für die Methode QueryData unterstützt.
spannerReference

object (SpannerReference)

Verweis auf eine Spanner-Datenbank. Wird nur für die Methode QueryData unterstützt.
cloudSqlReference

object (CloudSqlReference)

Verweis auf eine Cloud SQL-Datenbank. Wird nur für die Methode QueryData unterstützt.

BigQueryTableReferences

Nachricht, die Verweise auf BigQuery-Tabellen und Property-Graphen darstellt. Mindestens eines der Felder tableReferences, propertyGraphReferences oder searchScope muss ausgefüllt sein.

JSON-Darstellung 
{
  "tableReferences": [
    {
      object (BigQueryTableReference)
    }
  ],
  "searchScope": {
    object (SearchScope)
  }
}
Felder
tableReferences[]

object (BigQueryTableReference)

Optional. Verweise auf BigQuery-Tabellen.
searchScope

object (SearchScope)

Optional. BigQuery-Ressourcen durchsuchen, um die relevantesten Tabellen für die Anfrage zu finden.

BigQueryTableReference

Nachricht, die einen Verweis auf eine einzelne BigQuery-Tabelle darstellt.

JSON-Darstellung 
{
  "projectId": string,
  "datasetId": string,
  "tableId": string,
  "schema": {
    object (Schema)
  }
}
Felder
projectId

string

Erforderlich. Projekt, zu dem die Tabelle gehört.
datasetId

string

Erforderlich. Das Dataset, zu dem die Tabelle gehört.
tableId

string

Erforderlich. Die Tabellen-ID.
schema

object (Schema)

Optional. Das Schema der Datenquelle.

Schema

Das Schema einer Datasource- oder QueryResult-Instanz.

JSON-Darstellung 
{
  "fields": [
    {
      object (Field)
    }
  ],
  "description": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "filters": [
    {
      object (DataFilter)
    }
  ]
}
Felder
fields[]

object (Field)

Optional. Die Felder im Schema.
description

string

Optional. Eine Textbeschreibung des Inhalts und Zwecks der Tabelle. Beispiel: „Enthält Informationen zu Kundenbestellungen in unserem E-Commerce-Shop.“ Wird derzeit nur für BigQuery-Datenquellen verwendet.
synonyms[]

string

Optional. Eine Liste mit alternativen Namen oder Synonymen, die verwendet werden können, um sich auf die Tabelle zu beziehen. Beispiel: [„sales“, „orders“, „purchases“] Wird derzeit nur für BigQuery-Datenquellen verwendet.
tags[]

string

Optional. Eine Liste mit Tags oder Keywords, die der Tabelle zugeordnet sind und zur Kategorisierung verwendet werden. Beispiel: [„transaction“, „revenue“, „customer_data“] Wird derzeit nur für BigQuery-Datenquellen verwendet.
displayName

string

Optional. Anzeigename der Tabelle (entspricht dem Label in cloud/data_analytics/anarres/data/looker/proto/model_explore.proto), nicht erforderlich. Dieses Feld ist derzeit nur in Looker vorhanden.
filters[]

object (DataFilter)

Optional. Die Filter für die zugrunde liegenden Daten der Datenquelle. Wird derzeit nur für Looker-Datenquellen verwendet.

Feld

Ein Feld in einem Schema.

JSON-Darstellung 
{
  "name": string,
  "type": string,
  "description": string,
  "mode": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "subfields": [
    {
      object (Field)
    }
  ],
  "category": string,
  "valueFormat": string
}
Felder
name

string

Optional. Der Name des Felds.
type

string

Optional. Der Typ des Felds.
description

string

Optional. Eine kurze Beschreibung des Felds.
mode

string

Optional. Der Modus des Felds (z.B. NULLABLE, REPEATED).
synonyms[]

string

Optional. Eine Liste alternativer Namen oder Synonyme, die verwendet werden können, um sich auf dieses Feld zu beziehen. Beispiel: [„id“, „customerid“, „cust_id“]. Wird derzeit nur für BigQuery-Datenquellen verwendet.
tags[]

string

Optional. Eine Liste von Tags oder Keywords, die mit dem Feld verknüpft sind und zur Kategorisierung verwendet werden. Beispiel: [„identifier“, „customer“, „pii“]. Wird derzeit nur für BigQuery-Datenquellen verwendet.
displayName

string

Optional. Der Anzeigename des Felds (entspricht dem Label in
subfields[]

object (Field)

Optional. Rekursives Attribut für verschachtelte Schemastrukturen.
category

string

Optional. Feldkategorie, nicht erforderlich. Derzeit nur für Looker nützlich. Wir verwenden einen String, um nicht von einem externen Paket abhängig zu sein und dieses Paket in sich geschlossen zu halten.
valueFormat

string

Optional. Nur für Looker. Wertformat des Felds. Referenz: https://cloud.google.com/looker/docs/reference/param-field-value-format

DataFilter

Ein Filter für die zugrunde liegenden Daten einer Datenquelle. Dokumentation zur Filtersyntax: https://cloud.google.com/looker/docs/filter-expressions

JSON-Darstellung 
{
  "field": string,
  "value": string,
  "type": enum (DataFilterType)
}
Felder
field

string

Optional. Das Feld, nach dem gefiltert werden soll. Beispiel: [„event_date“, „customer_id“, „product_category“]
value

string

Optional. Der Standardwert, der für diesen Filter verwendet wird, wenn der Filter in einer Abfrage nicht überschrieben wird. Beispiel: [„nach 2024-01-01“, „123“, „-fashion“]
type

enum (DataFilterType)

Optional. Der Typ des Filters in einer Datenquelle, z. B. ALWAYS_FILTER.

DataFilterType

Der Typ des Filters in einer Datenquelle, z. B. ALWAYS_FILTER.

Enums
DATA_FILTER_TYPE_UNSPECIFIED Der Filtertyp wurde nicht angegeben.
ALWAYS_FILTER Ein Filter, den der Nutzer konfiguriert. Bei allen Abfragen für das Explore wird dieser Filter standardmäßig angewendet. Wird derzeit nur für Looker-Datenquellen verwendet.

SearchScope

Nachricht, die Filter darstellt, die auf die Suche in BigQuery-Tabellen angewendet werden sollen.

JSON-Darstellung 
{
  "includeProjectIds": [
    string
  ],
  "includeDatasetReferences": [
    {
      object (BigQueryDatasetReference)
    }
  ]
}
Felder
includeProjectIds[]

string

Optional. Die BigQuery-Projekt-IDs, die durchsucht werden sollen.
includeDatasetReferences[]

object (BigQueryDatasetReference)

Optional. Die BigQuery-Dataset-Referenzen, die durchsucht werden sollen.

BigQueryDatasetReference

Nachricht, die einen Verweis auf ein einzelnes BigQuery-Dataset darstellt.

JSON-Darstellung 
{
  "projectId": string,
  "datasetId": string
}
Felder
projectId

string

Erforderlich. Die ID des Projekts, zu dem das Dataset gehört.
datasetId

string

Erforderlich. Die Dataset-ID.

StudioDatasourceReferences

Nachricht, die Verweise auf Looker Studio-Datenquellen darstellt.

JSON-Darstellung 
{
  "studioReferences": [
    {
      object (StudioDatasourceReference)
    }
  ]
}
Felder
studioReferences[]

object (StudioDatasourceReference)

Optional. Die Verweise auf die Studio-Datenquellen.

StudioDatasourceReference

Nachricht, die einen Verweis auf eine einzelne Looker Studio-Datenquelle darstellt.

JSON-Darstellung 
{
  "datasourceId": string
}
Felder
datasourceId

string

Erforderlich. Die ID der Datenquelle.

LookerExploreReferences

Nachricht, die Verweise auf Looker-Explores darstellt.

JSON-Darstellung 
{
  "exploreReferences": [
    {
      object (LookerExploreReference)
    }
  ],
  "credentials": {
    object (Credentials)
  }
}
Felder
exploreReferences[]

object (LookerExploreReference)

Erforderlich. Verweise auf Looker-Explores.
credentials

object (Credentials)

Optional. Die Anmeldedaten, die beim Aufrufen der Looker API verwendet werden sollen.

Derzeit werden Anmeldedaten auf Basis von OAuth-Tokens und API-Schlüssel unterstützt, wie unter Authentifizierung mit einem SDK beschrieben.

LookerExploreReference

Nachricht, die einen Verweis auf einen einzelnen Looker-Explore darstellt.

JSON-Darstellung 
{
  "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.
}
Felder
lookmlModel

string

Erforderlich. Looker-Modell, wie in Wichtige LookML-Strukturen beschrieben. Name des LookML-Modells.
explore

string

Erforderlich. Looker-Explore, wie in Wichtige LookML-Strukturen beschrieben. Name des LookML-Explores.
schema

object (Schema)

Optional. Das Schema der Datenquelle.
Union-Feld instance. Die Instanz des Looker-Explores. Für instance ist nur einer der folgenden Werte zulässig:
lookerInstanceUri

string

Erforderlich. Die Basis-URL der Looker-Instanz.
privateLookerInstanceInfo

object (PrivateLookerInstanceInfo)

Informationen zur privaten Looker-Instanz.

PrivateLookerInstanceInfo

Nachricht, die eine Information zur privaten Looker-Instanz darstellt, die erforderlich ist, wenn sich die Looker-Instanz hinter einem privaten Netzwerk befindet.

JSON-Darstellung 
{
  "lookerInstanceId": string,
  "serviceDirectoryName": string
}
Felder
lookerInstanceId

string

Die Looker-Instanz-ID.
serviceDirectoryName

string

Der Service Directory-Name der Looker-Instanz.

Anmeldedaten

Stellt verschiedene Formen der Spezifikation von Anmeldedaten dar.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "oauth": {
    object (OAuthCredentials)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art der Anmeldedaten. } Für kind ist nur einer der folgenden Werte zulässig:
oauth

object (OAuthCredentials)

OAuth-Anmeldedaten.

OAuthCredentials

Stellt OAuth-Anmeldedaten dar.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld kind. Die Art der OAuth-Anmeldedaten. Für kind ist nur einer der folgenden Werte zulässig:
secret

object (SecretBased)

Secret-basierte OAuth-Anmeldedaten.
token

object (TokenBased)

Tokenbasierte OAuth-Anmeldedaten.

SecretBased

Der Name des Secrets, das das Zugriffstoken enthält. Stellt Secret-basierte OAuth-Anmeldedaten dar.

JSON-Darstellung 
{
  "clientId": string,
  "clientSecret": string
}
Felder
clientId

string

Erforderlich. Eine OAuth-Client-ID.
clientSecret

string

Erforderlich. Ein OAuth-Clientschlüssel.

TokenBased

Weitere Informationen zu Looker-Zugriffstokens finden Sie unter https://developers.looker.com/api/advanced-usage/looker-api-oauth.

JSON-Darstellung 
{
  "accessToken": string
}
Felder
accessToken

string

Erforderlich. Der Name des Secrets, das das Zugriffstoken enthält.

AlloyDbReference

Nachricht, die einen Verweis auf eine AlloyDB-Datenbank und einen KI-Agentenkontext darstellt. Wird nur für die Methode QueryData unterstützt.

JSON-Darstellung 
{
  "databaseReference": {
    object (AlloyDbDatabaseReference)
  },
  "agentContextReference": {
    object (AgentContextReference)
  }
}
Felder
databaseReference

object (AlloyDbDatabaseReference)

Erforderlich. Singular-Proto, mit dem angegeben werden kann, welche Datenbank und Tabellen einbezogen werden sollen.
agentContextReference

object (AgentContextReference)

Optional. Parameter zum Abrufen von Daten aus dem Agent-Kontext.

AlloyDbDatabaseReference

Nachricht, die einen Verweis auf eine einzelne AlloyDB-Datenbank darstellt.

JSON-Darstellung 
{
  "projectId": string,
  "region": string,
  "clusterId": string,
  "instanceId": string,
  "databaseId": string,
  "tableIds": [
    string
  ],
  "databaseTableReferences": [
    {
      object (DatabaseTableReference)
    }
  ]
}
Felder
projectId

string

Erforderlich. Das Projekt, zu dem die Instanz gehört.
region

string

Erforderlich. Die Region der Instanz.
clusterId

string

Erforderlich. Die Cluster-ID.
instanceId

string

Erforderlich. Die Instanz-ID.
databaseId

string

Erforderlich. Die Datenbank-ID.
tableIds[]

string

Optional. Die Tabellen-IDs. Wenn nicht festgelegt, werden alle Tabellen angegeben.
databaseTableReferences[]

object (DatabaseTableReference)

Optional. Verweise auf Tabellen in der Datenbank. Jeder Verweis gibt eine Tabelle an und kann optional das Schema der Tabelle enthalten, um Kontext für die Abfrage bereitzustellen.

DatabaseTableReference

Nachricht, die eine Tabelle einschließlich ihres Schemas darstellt.

JSON-Darstellung 
{
  "tableId": string,
  "schema": {
    object (Schema)
  }
}
Felder
tableId

string

Erforderlich. Der Name der Tabelle, wie in der Datenbank definiert.

Hinweis: Die genauen Regeln für die Benennung von Tabellen, einschließlich gültiger Zeichen, Längenbeschränkungen und Berücksichtigung der Groß-/Kleinschreibung, werden vom jeweiligen Datenbanksystem festgelegt.

Anforderungen: – Genaue Übereinstimmung: Der angegebene Name muss mit dem in der Datenbank gespeicherten Namen übereinstimmen. – Groß-/Kleinschreibung: Beachten Sie die Regeln zur Groß-/Kleinschreibung des jeweiligen Datenbanksystems und die Art und Weise, wie die Tabelle erstellt wurde. „Bestellungen“ und „bestellungen“ können beispielsweise unterschiedliche Tabellennamen sein. – Sonderzeichen/Schlüsselwörter: Wenn der Tabellenname Leerzeichen oder Sonderzeichen enthält oder ein reserviertes Datenbankschlüsselwort ist, geben Sie den Namen so an, wie er gespeichert ist. Fügen Sie keine datenbankspezifischen Anführungszeichen für Bezeichner hinzu (z.B. „, `, []).

Beispiele: – Einfacher Name: „orders“, „UserActivity“ – Groß-/Kleinschreibung beachten: „MyTable“ – Name mit Leerzeichen: „Order Details“ – Name mit anderen Sonderzeichen: „user/data“, „order-items“ – Name, der ein Keyword ist: „Group“, „Order“

Berechtigungen: Die Anmeldedaten des Aufrufers müssen die erforderlichen Datenbankberechtigungen für den Zugriff auf das Schema und die Daten der Tabelle haben.
schema

object (Schema)

Optional. Das Schema der Tabelle.

AgentContextReference

Nachricht, die einen Verweis auf den Kontext des KI-Agenten darstellt.

JSON-Darstellung 
{
  "contextSetId": string
}
Felder
contextSetId

string

Erforderlich. Die ID des abzurufenden Kontextsets.

SpannerReference

Nachricht, die einen Verweis auf eine Spanner-Datenbank und einen KI-Agentenkontext darstellt. Wird nur für die Methode QueryData unterstützt.

JSON-Darstellung 
{
  "databaseReference": {
    object (SpannerDatabaseReference)
  },
  "agentContextReference": {
    object (AgentContextReference)
  }
}
Felder
databaseReference

object (SpannerDatabaseReference)

Erforderlich. Singular-Proto, mit dem angegeben werden kann, welche Datenbank und Tabellen einbezogen werden sollen.
agentContextReference

object (AgentContextReference)

Optional. Parameter zum Abrufen von Daten aus dem Agent-Kontext.

SpannerDatabaseReference

Nachricht, die einen Verweis auf eine einzelne Spanner-Datenbank darstellt.

JSON-Darstellung 
{
  "engine": enum (Engine),
  "projectId": string,
  "instanceId": string,
  "databaseId": string,
  "tableIds": [
    string
  ],
  "databaseTableReferences": [
    {
      object (DatabaseTableReference)
    }
  ]
}
Felder
engine

enum (Engine)

Erforderlich. Die Engine der Spanner-Instanz.
projectId

string

Erforderlich. Das Projekt, zu dem die Instanz gehört.
instanceId

string

Erforderlich. Die Instanz-ID.
databaseId

string

Erforderlich. Die Datenbank-ID.
tableIds[]

string

Optional. Die Tabellen-IDs. Wenn nicht festgelegt, werden alle Tabellen angegeben.
databaseTableReferences[]

object (DatabaseTableReference)

Optional. Verweise auf Tabellen in der Datenbank. Jeder Verweis gibt eine Tabelle an und kann optional das Schema der Tabelle enthalten, um Kontext für die Abfrage bereitzustellen.

Engine

Das Datenbankmodul.

Enums
ENGINE_UNSPECIFIED Engine ist nicht angegeben.
GOOGLE_SQL Google SQL
POSTGRESQL PostgreSQL

CloudSqlReference

Nachricht, die einen Verweis auf eine CloudSQL-Datenbank und einen KI-Agentenkontext darstellt. Wird nur für die Methode QueryData unterstützt.

JSON-Darstellung 
{
  "databaseReference": {
    object (CloudSqlDatabaseReference)
  },
  "agentContextReference": {
    object (AgentContextReference)
  }
}
Felder
databaseReference

object (CloudSqlDatabaseReference)

Erforderlich. Singular-Proto, mit dem angegeben werden kann, welche Datenbank und Tabellen einbezogen werden sollen.
agentContextReference

object (AgentContextReference)

Optional. Parameter zum Abrufen von Daten aus dem Agent-Kontext.

CloudSqlDatabaseReference

Nachricht, die einen Verweis auf eine einzelne Cloud SQL-Datenbank darstellt.

JSON-Darstellung 
{
  "engine": enum (Engine),
  "projectId": string,
  "region": string,
  "instanceId": string,
  "databaseId": string,
  "tableIds": [
    string
  ],
  "databaseTableReferences": [
    {
      object (DatabaseTableReference)
    }
  ]
}
Felder
engine

enum (Engine)

Erforderlich. Die Engine der Cloud SQL-Instanz.
projectId

string

Erforderlich. Das Projekt, zu dem die Instanz gehört.
region

string

Erforderlich. Die Region der Instanz.
instanceId

string

Erforderlich. Die Instanz-ID.
databaseId

string

Erforderlich. Die Datenbank-ID.
tableIds[]

string

Optional. Die Tabellen-IDs. Wenn nicht festgelegt, werden alle Tabellen angegeben.
databaseTableReferences[]

object (DatabaseTableReference)

Optional. Verweise auf Tabellen in der Datenbank. Jeder Verweis gibt eine Tabelle an und kann optional das Schema der Tabelle enthalten, um Kontext für die Abfrage bereitzustellen.

Engine

Das Datenbankmodul.

Enums
ENGINE_UNSPECIFIED Engine ist nicht angegeben.
POSTGRESQL PostgreSQL
MYSQL MySQL

ConversationOptions

Optionen für die Unterhaltung.

JSON-Darstellung 
{
  "chart": {
    object (ChartOptions)
  },
  "analysis": {
    object (AnalysisOptions)
  },
  "datasource": {
    object (DatasourceOptions)
  }
}
Felder
chart

object (ChartOptions)

Optional. Optionen für die Diagrammerstellung.
analysis

object (AnalysisOptions)

Optional. Optionen für die Analyse.
datasource

object (DatasourceOptions)

Optional. Optionen für Datenquellen.

ChartOptions

Optionen für die Diagrammerstellung.

JSON-Darstellung 
{
  "image": {
    object (ImageOptions)
  }
}
Felder
image

object (ImageOptions)

Optional. Wenn angegeben, rendert der KI-Agent generierte Diagramme im angegebenen Format. Die Standardeinstellung ist „Kein Bild“.

ImageOptions

Optionen zum Rendern von Bildern generierter Diagramme.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld kind. Die Art des zu rendernden Bildes. Für kind ist nur einer der folgenden Werte zulässig:
noImage

object (NoImage)

Kein Bild.
svg

object (SvgOptions)

SVG-Format.

NoImage

Dieser Typ hat keine Felder.

Kein Bild.

SvgOptions

Dieser Typ hat keine Felder.

SVG-Optionen.

AnalysisOptions

Optionen für die Analyse.

JSON-Darstellung 
{
  "python": {
    object (Python)
  }
}
Felder
python

object (Python)

Optional. Optionen für die Python-Analyse.

Python

Optionen für die Python-Analyse.

JSON-Darstellung 
{
  "enabled": boolean
}
Felder
enabled

boolean

Optional. Gibt an, ob die Python-Analyse aktiviert werden soll. Die Standardeinstellung ist „false“.

DatasourceOptions

Optionen für die Konfiguration von Datenquellen.

JSON-Darstellung 
{
  "bigQueryMaxBilledBytes": string
}
Felder
bigQueryMaxBilledBytes

string (Int64Value format)

Optional. Diese Option gilt nur für Datenquellen, für die BigQuery-Abfragen erforderlich sind. Begrenzt die Anzahl der für jeden BigQuery-Abfragejob abgerechneten Byte. Wenn abgerechnete Byte in dieser Abfrage das Limit überschreiten, schlägt die Abfrage fehl (ohne, dass eine Gebühr anfällt). Wenn nicht angegeben, wird kein Limit angewendet.

ExampleQuery

Ein Beispiel für eine relevante und häufig verwendete SQL-Abfrage und die entsprechenden optionalen Abfragen in natürlicher Sprache. Wird derzeit nur für BigQuery-Datenquellen verwendet.

JSON-Darstellung 
{
  "naturalLanguageQuestion": string,

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

string

Optional. Eine Frage in natürlicher Sprache, die ein Nutzer stellen könnte. Beispiel: „Wie viele Bestellungen wurden im letzten Monat aufgegeben?“
Union-Feld query. Die SQL- oder Looker-Abfrage, die generiert werden soll, um die Anfrage in natürlicher Sprache zu beantworten. Für query ist nur einer der folgenden Werte zulässig:
sqlQuery

string

Optional. Die SQL-Abfrage, die generiert werden soll, um die Frage in natürlicher Sprache zu beantworten. Beispiel: „SELECT COUNT(*) FROM orders WHERE order_date BETWEEN '2024-01-01' AND '2024-01-31'“

LookerGoldenQuery

Eine Golden Query für Looker, die Fragen in natürlicher Sprache und eine entsprechende Looker-Abfrage enthält. Analog zu ExampleQuery.

JSON-Darstellung 
{
  "naturalLanguageQuestions": [
    string
  ],
  "lookerQuery": {
    object (LookerQuery)
  }
}
Felder
naturalLanguageQuestions[]

string

Optional. Fragen in natürlicher Sprache, die ein Nutzer stellen könnte. Beispiel: „Wie viele Bestellungen wurden im letzten Monat aufgegeben?“
lookerQuery

object (LookerQuery)

Optional. Die Looker-Abfrage, die den Fragen in natürlicher Sprache entspricht.

LookerQuery

Looker-Abfrageobjekt Looker API-Dokumentation

JSON-Darstellung 
{
  "model": string,
  "explore": string,
  "fields": [
    string
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "sorts": [
    string
  ],
  "limit": string
}
Felder
model

string

Pflichtangabe. Das LookML-Modell, das zum Generieren der Anfrage verwendet wurde.
explore

string

Erforderlich. Das LookML-Explore, das zum Generieren der Anfrage verwendet wurde.
fields[]

string

Optional. Die Felder, die aus dem Explore abgerufen werden sollen.
filters[]

object (Filter)

Optional. Die Filter, die auf den Explore angewendet werden sollen.
sorts[]

string

Optional. Die Sortierungen, die auf den Explore angewendet werden sollen.
limit

string

Optional. Limit in der Anfrage.

Filter

Ein Looker-Anfragefilter.

JSON-Darstellung 
{
  "field": string,
  "value": string
}
Felder
field

string

Pflichtangabe. Das Feld, nach dem gefiltert werden soll.
value

string

Optional. Der Wert für das Feld, nach dem gefiltert werden soll. Optional, damit wir den Standardwert als leeren String beibehalten können. Das ist wichtig, um eine gültige und funktionierende Looker-Explore-URL zu erhalten.

GlossaryTerm

Definition eines Begriffs in einer bestimmten Domain.

JSON-Darstellung 
{
  "displayName": string,
  "description": string,
  "labels": [
    string
  ]
}
Felder
displayName

string

Erforderlich. Nutzerfreundlicher Anzeigename des zu definierenden Glossarbegriffs. Beispiele: „CTR“, „Conversion-Rate“, „Ausstehend“
description

string

Erforderlich. Die Beschreibung oder Bedeutung des Begriffs. Beispiele: „Klickrate“, „Der Prozentsatz der Nutzer, die eine gewünschte Aktion ausführen“, „Eine Bestellung, die auf die Bearbeitung wartet“.
labels[]

string

Optional. Eine Liste der allgemeinen Labels, die diesem Begriff zugeordnet sind. Beispiel: [„Klickrate“, „Klick“, „Wartet“]

SchemaRelationship

Die Beziehung zwischen zwei Tabellen, einschließlich der referenzierenden und der referenzierten Spalten. Dies ist ein abgeleiteter Kontext, der aus Dataplex Dataset Insights abgerufen wird.

JSON-Darstellung 
{
  "leftSchemaPaths": {
    object (SchemaPaths)
  },
  "rightSchemaPaths": {
    object (SchemaPaths)
  },
  "sources": [
    enum (Source)
  ],
  "confidenceScore": number
}
Felder
leftSchemaPaths

object (SchemaPaths)

Eine sortierte Liste von Feldern für den Join aus der ersten Tabelle. Die Größe dieser Liste muss mit rightSchemaPaths übereinstimmen. Jedes Feld mit dem Index i in dieser Liste muss einem Feld mit demselben Index in der Liste rightSchemaPaths entsprechen.
rightSchemaPaths

object (SchemaPaths)

Eine sortierte Liste von Feldern für den Join aus der zweiten Tabelle. Die Größe dieser Liste muss mit leftSchemaPaths übereinstimmen. Jedes Feld mit dem Index i in dieser Liste muss einem Feld mit demselben Index in der Liste leftSchemaPaths entsprechen.
sources[]

enum (Source)

Optional. Quellen, die die Schemabeziehungskante generiert haben.
confidenceScore

number

Optional. Ein Konfidenzwert für die vorgeschlagene Beziehung. Manuell hinzugefügte Kanten haben den höchsten Konfidenzwert.

SchemaPaths

Stellt eine geordnete Menge von Pfaden innerhalb des Tabellenschemas dar.

JSON-Darstellung 
{
  "tableFqn": string,
  "paths": [
    string
  ]
}
Felder
tableFqn

string

Der dienstqualifizierte vollständige Ressourcenname der Tabelle, z. B. bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
paths[]

string

Die sortierte Liste der Pfade im Tabellenschema.

Quelle

Quelle, aus der die Schemabeziehungskante stammt.

Enums
SOURCE_UNSPECIFIED Die Quelle der Schemabeziehung ist nicht angegeben.
BIGQUERY_JOB_HISTORY Die Quelle der Schemabeziehung ist der BigQuery-Jobverlauf.
LLM_SUGGESTED Die Quelle der Schemabeziehung ist LLM-basiert.
BIGQUERY_TABLE_CONSTRAINTS Die Quelle der Schemabeziehung sind BigQuery-Tabelleneinschränkungen.

Methoden

create

 Erstellt einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.

createSync

 Erstellt synchron einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.

delete

 Löscht einen einzelnen KI-Datenagenten.

deleteSync

 Löscht einen einzelnen KI-Datenagenten synchron.

get

 Ruft Details zu einem einzelnen KI-Datenagenten ab.

getIamPolicy

 Ruft die IAM-Richtlinie für den KI-Datenagenten ab.

list

 Listet KI-Datenagenten in einem angegebenen Projekt und an einem angegebenen Ort auf.

listAccessible

 Listet KI-Datenagenten auf, auf die der Aufrufer in einem angegebenen Projekt und an einem angegebenen Ort zugreifen kann.

patch

 Aktualisiert die Parameter eines einzelnen KI-Datenagenten.

setIamPolicy

 Legt die IAM-Richtlinie für einen KI-Datenagenten fest.

updateSync

 Aktualisiert die Parameter eines einzelnen DataAgent synchron.