Message

使用者與系統互動時傳送的訊息。

JSON 表示法 
{
  "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.
}
欄位
timestamp

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

string

選用。對話中郵件的專屬 ID，用於保存對話。
聯集欄位 kind。訊息類型。kind 只能是下列其中一項：
userMessage

object (UserMessage)

與系統互動的使用者傳送的訊息。
systemMessage

object (SystemMessage)

系統回覆使用者的訊息。

UserMessage

與系統互動的使用者傳送的訊息。

JSON 表示法 
{

  // Union field kind can be only one of the following:
  "text": string
  // End of list of possible types for union field kind.
}
欄位
聯集欄位 kind。使用者訊息中的內容類型。kind 只能是下列其中一項：
text

string

文字應使用這個欄位，而非 Blob。

SystemMessage

系統回覆使用者的訊息。這則訊息也可以是使用者傳送的訊息，做為系統多輪對話的歷史脈絡。

JSON 表示法 
{

  // 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
}
欄位
聯集欄位 kind。系統訊息中的內容類型。kind 只能是下列其中一項：
text

object (TextMessage)

直接以自然語言回覆使用者訊息。
schema

object (SchemaMessage)

結構定義解析期間產生的訊息。
data

object (DataMessage)

在資料擷取期間產生的訊息。
analysis

object (AnalysisMessage)

分析期間產生的訊息。
chart

object (ChartMessage)

圖表生成期間產生的訊息。
error

object (ErrorMessage)

錯誤訊息。
groupId

integer

用於識別事件所屬的群組。類似事件在邏輯上互有關聯，應在 UI 中一併顯示。

TextMessage

包含多個部分的簡訊。

JSON 表示法 
{
  "parts": [
    string
  ]
}
欄位
parts[]

string

(選用步驟) 訊息的各個部分。

SchemaMessage

結構定義解析期間產生的訊息。

JSON 表示法 
{

  // 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.
}
欄位
聯集欄位 kind。這則訊息是否包含查詢或結構定義解析結果。kind 只能是下列其中一項：
query

object (SchemaQuery)

結構定義解析查詢。
result

object (SchemaResult)

結構定義解析查詢的結果。

SchemaQuery

查詢，用於解析與所提問題相關的結構定義。

JSON 表示法 
{
  "question": string
}
欄位
question

string

(選用步驟) 要傳送給系統以解決結構定義的問題。

SchemaResult

結構定義解析結果。

JSON 表示法 
{
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
欄位
datasources[]

object (Datasource)

(選用步驟) 用於解析結構定義查詢的資料來源。

資料來源

可用於回答問題的資料來源。

JSON 表示法 
{
  "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.
}
欄位
schema

object (Schema)

(選用步驟) 資料來源的結構定義。
聯集欄位 reference。資料來源的參照。reference 只能是下列其中一項：
bigqueryTableReference

object (BigQueryTableReference)

BigQuery 資料表的參照。
studioDatasourceId

string

Looker Studio 資料來源的參照。
lookerExploreReference

object (LookerExploreReference)

Looker 探索的參照。

DataMessage

在資料擷取期間產生的訊息。

JSON 表示法 
{

  // 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.
}
欄位
聯集欄位 kind。這則訊息是否包含查詢、結果，或是擷取資料時產生的 SQL。kind 只能是下列其中一項：
query

object (DataQuery)

資料擷取查詢。
generatedSql

string

系統產生的 SQL，用於擷取資料。
result

object (DataResult)

已擷取的資料。
generatedLookerQuery

object (LookerQuery)

系統產生的 Looker 查詢，用於擷取資料。
bigQueryJob

object (BigQueryJob)

系統執行的 BigQuery 工作，用於擷取資料。

DataQuery

用於擷取資料的查詢。

JSON 表示法 
{
  "question": string,
  "name": string,
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
欄位
question

string

(選用步驟) 要回答的自然語言問題。
name

string

(選用步驟) 查詢的蛇形命名名稱，可反映查詢意圖。用於命名對應的資料結果，以便在後續步驟中參照。

  • 例如：「total_sales_by_product」
  • 例如：「sales_for_product_12345」
datasources[]

object (Datasource)

(選用步驟) 可用於回答問題的資料來源。

DataResult

已擷取的資料。

JSON 表示法 
{
  "name": string,
  "schema": {
    object (Schema)
  },
  "data": [
    {
      object
    }
  ]
}
欄位
name

string

(選用步驟) 資料結果的蛇形命名法名稱，可反映其內容。這個名稱用於依參照傳遞結果，並做為其意義的信號。

  • 例如：「total_sales_by_product」
  • 例如：「sales_for_product_12345」
schema

object (Schema)

(選用步驟) 資料的結構定義。
data[]

object (Struct format)

(選用步驟) 資料內容。每個資料列都是符合結構定義的結構體。簡單值會以字串表示，巢狀結構則會以清單或結構體表示。

LookerQuery

用於從 Looker Explore 擷取資料的查詢。請參閱「執行內嵌查詢」。

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

這是必要旗標，要篩選的 f 欄位值。

BigQueryJob

系統執行的 BigQuery 工作。

JSON 表示法 
{
  "projectId": string,
  "jobId": string,
  "location": string,
  "destinationTable": {
    object (BigQueryTableReference)
  },
  "schema": {
    object (Schema)
  }
}
欄位
projectId

string

這是必要旗標，工作所屬的專案。

請參閱 JobReference。
jobId

string

這是必要旗標，工作 ID。

請參閱 JobReference。
location

string

(選用步驟) 工作地點。

請參閱 JobReference。
destinationTable

object (BigQueryTableReference)

(選用步驟) 工作查詢結果的目的地資料表參照。

請參閱 JobConfigurationQuery。
schema

object (Schema)

(選用步驟) 工作查詢結果的結構定義。

請參閱 JobStatistics2。

AnalysisMessage

分析期間產生的訊息。

JSON 表示法 
{

  // 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.
}
欄位
聯集欄位 kind。這則訊息是否包含查詢或分析中的其中一個事件。kind 只能是下列其中一項：
query

object (AnalysisQuery)

分析查詢。
progressEvent

object (AnalysisEvent)

表示分析進度的事件。

AnalysisQuery

用於執行分析的查詢。

JSON 表示法 
{
  "question": string,
  "dataResultNames": [
    string
  ]
}
欄位
question

string

(選用步驟) 分析問題，協助解答使用者的原始問題。
dataResultNames[]

string

(選用步驟) 要分析的先前擷取資料結果名稱。

AnalysisEvent

表示分析進度的事件。

JSON 表示法 
{

  // 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.
}
欄位
聯集欄位 kind。分析期間發生的事件類型。kind 只能是下列其中一項：
plannerReasoning

string

Python 程式碼產生器規劃工具的推理。
coderInstruction

string

生成程式碼的指令。
code

string

產生的程式碼。
executionOutput

string

程式碼執行作業的輸出內容。
executionError

string

程式碼執行時發生錯誤。
resultVegaChartJson

string

結果為 Vega 圖表 JSON 字串。
resultNaturalLanguage

string

結果為 NL 字串。
resultCsvData

string

以 CSV 字串形式傳回結果。
resultReferenceData

string

結果做為資料來源的參照。
error

string

一般錯誤訊息。

ChartMessage

圖表生成期間產生的訊息。

JSON 表示法 
{

  // 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.
}
欄位
聯集欄位 kind。這則訊息是否包含查詢或圖表生成結果。kind 只能是下列其中一項：
query

object (ChartQuery)

用於生成圖表的查詢。
result

object (ChartResult)

圖表生成查詢的結果。

ChartQuery

用於生成圖表的查詢。

JSON 表示法 
{
  "instructions": string,
  "dataResultName": string
}
欄位
instructions

string

(選用步驟) 生成圖表的自然語言指令。
dataResultName

string

(選用步驟) 先前擷取的資料結果名稱，用於圖表。

ChartResult

圖表生成查詢的結果。

JSON 表示法 
{
  "vegaConfig": {
    object
  },
  "image": {
    object (Blob)
  }
}
欄位
vegaConfig

object (Struct format)

(選用步驟) 產生的 Vega 圖表設定。請參閱 https://vega.github.io/vega/docs/config/
image

object (Blob)

(選用步驟) 如果是在背景資訊充足的情況下要求，就會顯示圖表。

Blob

具有 MIME 類型的資料 Blob。

JSON 表示法 
{
  "mimeType": string,
  "data": string
}
欄位
mimeType

string

這是必要旗標，訊息資料的 IANA 標準 MIME 類型。
data

string (bytes format)

這是必要旗標，以位元組表示的資料。

Base64 編碼字串。

ErrorMessage

錯誤訊息。

JSON 表示法 
{
  "text": string
}
欄位
text

string

僅供輸出。錯誤訊息文字。