Message

Eine Nachricht von einer Interaktion zwischen dem Nutzer und dem System.

JSON-Darstellung 
{
  "timestamp": string,
  "messageId": string,

  // Union field kind can be only one of the following:
  "userMessage": {
    object (UserMessage)
  },
  "systemMessage": {
    object (SystemMessage)
  }
  // End of list of possible types for union field kind.
}
Felder
timestamp

string (Timestamp format)

Nur Ausgabe. Bei Nutzernachrichten ist dies der Zeitpunkt, zu dem das System die Nachricht empfangen hat. Bei Systemnachrichten ist dies der Zeitpunkt, zu dem das System die Nachricht generiert hat.

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".
messageId

string

Optional. Eindeutige ID der Nachricht in der Unterhaltung für die Persistenz.
Union-Feld kind. Die Art der Nachricht. Für kind ist nur einer der folgenden Werte zulässig:
userMessage

object (UserMessage)

Eine Nachricht vom Nutzer, der mit dem System interagiert.
systemMessage

object (SystemMessage)

Eine Nachricht vom System als Antwort auf die Nutzeranfrage.

UserMessage

Eine Nachricht vom Nutzer, der mit dem System interagiert.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "text": string
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art des Inhalts in der Nutzernachricht. Für kind ist nur einer der folgenden Werte zulässig:
text

string

Für Text sollte dieses Feld anstelle von „Blob“ verwendet werden.

SystemMessage

Eine Nachricht vom System als Antwort auf die Nutzeranfrage. Diese Nachricht kann auch eine Nachricht des Nutzers als Verlaufskontext für Multi-Turn-Unterhaltungen mit dem System sein.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "text": {
    object (TextMessage)
  },
  "schema": {
    object (SchemaMessage)
  },
  "data": {
    object (DataMessage)
  },
  "analysis": {
    object (AnalysisMessage)
  },
  "chart": {
    object (ChartMessage)
  },
  "error": {
    object (ErrorMessage)
  }
  // End of list of possible types for union field kind.
  "groupId": integer
}
Felder
Union-Feld kind. Die Art des Inhalts in der Systemnachricht. Für kind ist nur einer der folgenden Werte zulässig:
text

object (TextMessage)

Eine direkte Antwort in natürlicher Sprache auf die Nutzernachricht.
schema

object (SchemaMessage)

Eine Nachricht, die während der Schemaauflösung ausgegeben wird.
data

object (DataMessage)

Eine Nachricht, die beim Abrufen von Daten ausgegeben wird.
analysis

object (AnalysisMessage)

Eine Nachricht, die während der Analyse ausgegeben wird.
chart

object (ChartMessage)

Eine Nachricht, die während der Diagrammerstellung ausgegeben wird.
error

object (ErrorMessage)

Eine Fehlermeldung.
groupId

integer

Gibt die Gruppe an, zu der das Ereignis gehört. Ähnliche Ereignisse werden als logisch miteinander verknüpft betrachtet und sollten zusammen in der Benutzeroberfläche angezeigt werden.

TextMessage

Eine mehrteilige Textnachricht.

JSON-Darstellung 
{
  "parts": [
    string
  ]
}
Felder
parts[]

string

Optional. Die Teile der Nachricht.

SchemaMessage

Eine Nachricht, die während der Schemaauflösung ausgegeben wird.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "query": {
    object (SchemaQuery)
  },
  "result": {
    object (SchemaResult)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Gibt an, ob diese Nachricht die Anfrage oder das Ergebnis der Schemaauflösung enthält. Für kind ist nur einer der folgenden Werte zulässig:
query

object (SchemaQuery)

Eine Anfrage zur Schemaauflösung.
result

object (SchemaResult)

Das Ergebnis einer Anfrage zur Schemaauflösung.

SchemaQuery

Eine Anfrage zum Auflösen des Schemas, das für die gestellte Frage relevant ist.

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

string

Optional. Die Frage, die zur Schemaauflösung an das System gesendet werden soll.

SchemaResult

Das Ergebnis der Schemaauflösung.

JSON-Darstellung 
{
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
Felder
datasources[]

object (Datasource)

Optional. Die Datenquellen, die zum Auflösen der Schemaanfrage verwendet wurden.

Datasource

Eine Datenquelle, die zum Beantworten von Fragen verwendet werden kann.

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

  // Union field reference can be only one of the following:
  "bigqueryTableReference": {
    object (BigQueryTableReference)
  },
  "studioDatasourceId": string,
  "lookerExploreReference": {
    object (LookerExploreReference)
  }
  // End of list of possible types for union field reference.
}
Felder
schema

object (Schema)

Optional. Das Schema der Datenquelle.
Union-Feld reference. Der Verweis auf die Datenquelle. Für reference ist nur einer der folgenden Werte zulässig:
bigqueryTableReference

object (BigQueryTableReference)

Ein Verweis auf eine BigQuery-Tabelle.
studioDatasourceId

string

Ein Verweis auf eine Looker Studio-Datenquelle.
lookerExploreReference

object (LookerExploreReference)

Ein Verweis auf ein Looker-Explore.

DataMessage

Eine Nachricht, die beim Abrufen von Daten ausgegeben wird.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "query": {
    object (DataQuery)
  },
  "generatedSql": string,
  "result": {
    object (DataResult)
  },
  "generatedLookerQuery": {
    object (LookerQuery)
  },
  "bigQueryJob": {
    object (BigQueryJob)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Gibt an, ob diese Nachricht die Anfrage, das Ergebnis oder generiertes SQL für den Datenabruf enthält. Für kind ist nur einer der folgenden Werte zulässig:
query

object (DataQuery)

Eine Anfrage zum Abrufen von Daten.
generatedSql

string

SQL, das vom System zum Abrufen von Daten generiert wird.
result

object (DataResult)

Abgerufene Daten.
generatedLookerQuery

object (LookerQuery)

Vom System generierte Looker-Anfrage zum Abrufen von Daten.
bigQueryJob

object (BigQueryJob)

Ein BigQuery-Job, der vom System ausgeführt wird, um Daten abzurufen.

DataQuery

Eine Anfrage zum Abrufen von Daten.

JSON-Darstellung 
{
  "question": string,
  "name": string,
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
Felder
question

string

Optional. Eine Frage in natürlicher Sprache, die beantwortet werden soll.
name

string

Optional. Ein Name im Snake-Case-Format für die Anfrage, der den Zweck der Anfrage widerspiegelt. Damit wird das entsprechende Datenergebnis benannt, sodass in späteren Schritten darauf verwiesen werden kann.

  • Beispiel: „total_sales_by_product“
  • Beispiel: „sales_for_product_12345“
datasources[]

object (Datasource)

Optional. Die Datenquellen, die zur Beantwortung der Frage zur Verfügung stehen.

DataResult

Abgerufene Daten.

JSON-Darstellung 
{
  "name": string,
  "schema": {
    object (Schema)
  },
  "data": [
    {
      object
    }
  ]
}
Felder
name

string

Optional. Ein Name im Snake-Case-Format für das Datenergebnis, der den Inhalt des Ergebnisses widerspiegelt. Der Name wird verwendet, um das Ergebnis per Verweis zu übergeben, und dient als Signal für seine Bedeutung.

  • Beispiel: „total_sales_by_product“
  • Beispiel: „sales_for_product_12345“
schema

object (Schema)

Optional. Das Schema der Daten.
data[]

object (Struct format)

Optional. Der Inhalt der Daten. Jede Zeile ist ein Struct, das dem Schema entspricht. Einfache Werte werden als Strings dargestellt, verschachtelte Strukturen als Listen oder Structs.

LookerQuery

Eine Anfrage zum Abrufen von Daten aus einem Looker-Explore. Weitere Informationen finden Sie unter Inline-Anfrage ausführen.

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

Pflichtangabe. 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

Pflichtangabe. Der Wert f, nach dem gefiltert werden soll.

BigQueryJob

Ein BigQuery-Job, der vom System ausgeführt wird.

JSON-Darstellung 
{
  "projectId": string,
  "jobId": string,
  "location": string,
  "destinationTable": {
    object (BigQueryTableReference)
  },
  "schema": {
    object (Schema)
  }
}
Felder
projectId

string

Pflichtangabe. Das Projekt, zu dem der Job gehört.

Siehe JobReference.
jobId

string

Pflichtangabe. Die ID des Jobs.

Siehe JobReference.
location

string

Optional. Der Ort des Jobs.

Siehe JobReference.
destinationTable

object (BigQueryTableReference)

Optional. Ein Verweis auf die Zieltabelle der Anfrageergebnisse des Jobs.

Siehe JobConfigurationQuery.
schema

object (Schema)

Optional. Das Schema der Anfrageergebnisse des Jobs.

Siehe JobStatistics2.

AnalysisMessage

Eine Nachricht, die während der Analyse ausgegeben wird.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "query": {
    object (AnalysisQuery)
  },
  "progressEvent": {
    object (AnalysisEvent)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Gibt an, ob diese Nachricht die Anfrage oder eines der Ereignisse aus der Analyse enthält. Für kind ist nur einer der folgenden Werte zulässig:
query

object (AnalysisQuery)

Eine Analyseanfrage.
progressEvent

object (AnalysisEvent)

Ein Ereignis, das den Fortschritt der Analyse angibt.

AnalysisQuery

Eine Anfrage zum Durchführen einer Analyse.

JSON-Darstellung 
{
  "question": string,
  "dataResultNames": [
    string
  ]
}
Felder
question

string

Optional. Eine Analysefrage, die dabei helfen soll, die ursprüngliche Frage des Nutzers zu beantworten.
dataResultNames[]

string

Optional. Die Namen von zuvor abgerufenen Datenergebnissen, die analysiert werden sollen.

AnalysisEvent

Ein Ereignis, das den Fortschritt einer Analyse angibt.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "plannerReasoning": string,
  "coderInstruction": string,
  "code": string,
  "executionOutput": string,
  "executionError": string,
  "resultVegaChartJson": string,
  "resultNaturalLanguage": string,
  "resultCsvData": string,
  "resultReferenceData": string,
  "error": string
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art des Ereignisses, das während der Analyse aufgetreten ist. Für kind ist nur einer der folgenden Werte zulässig:
plannerReasoning

string

Begründung des Python-Codegen-Planers.
coderInstruction

string

Anweisungen, die für die Codegenerierung ausgestellt wurden.
code

string

Generierter Code.
executionOutput

string

Ausgabe der Codeausführung.
executionError

string

Ein Fehler bei der Codeausführung.
resultVegaChartJson

string

Ergebnis als JSON-String für ein Vega-Diagramm.
resultNaturalLanguage

string

Ergebnis als NL-String.
resultCsvData

string

Ergebnis als CSV-String.
resultReferenceData

string

Ergebnis als Verweis auf eine Datenquelle.
error

string

Eine allgemeine Fehlermeldung.

ChartMessage

Eine Nachricht, die während der Diagrammerstellung ausgegeben wird.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "query": {
    object (ChartQuery)
  },
  "result": {
    object (ChartResult)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Gibt an, ob diese Nachricht die Anfrage oder das Ergebnis der Diagrammerstellung enthält. Für kind ist nur einer der folgenden Werte zulässig:
query

object (ChartQuery)

Eine Anfrage zum Erstellen eines Diagramms.
result

object (ChartResult)

Das Ergebnis einer Anfrage zur Diagrammerstellung.

ChartQuery

Eine Anfrage zum Erstellen eines Diagramms.

JSON-Darstellung 
{
  "instructions": string,
  "dataResultName": string
}
Felder
instructions

string

Optional. Anweisungen in natürlicher Sprache zum Erstellen des Diagramms.
dataResultName

string

Optional. Der Name eines zuvor abgerufenen Datenergebnisses, das im Diagramm verwendet werden soll.

ChartResult

Das Ergebnis einer Anfrage zur Diagrammerstellung.

JSON-Darstellung 
{
  "vegaConfig": {
    object
  },
  "image": {
    object (Blob)
  }
}
Felder
vegaConfig

object (Struct format)

Optional. Eine generierte Vega-Diagrammkonfiguration. Weitere Informationen finden Sie unter https://vega.github.io/vega/docs/config/.
image

object (Blob)

Optional. Eine gerenderte Version des Diagramms, wenn dies im Kontext angefordert wurde.

Blob

Ein Blob mit Daten vom MIME-Typ.

JSON-Darstellung 
{
  "mimeType": string,
  "data": string
}
Felder
mimeType

string

Pflichtangabe. Der IANA-Standard-MIME-Typ der Nachrichtendaten.
data

string (bytes format)

Pflichtangabe. Die Daten als Byte dargestellt.

Ein base64-codierter String.

ErrorMessage

Eine Fehlermeldung.

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

string

Nur Ausgabe. Der Text des Fehlers.