Message

Một thông báo từ một lượt tương tác giữa người dùng và hệ thống.

Biểu diễn dưới dạng 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.
}
Các trường
timestamp

string (Timestamp format)

Chỉ có đầu ra. Đối với thông báo của người dùng, đây là thời điểm hệ thống nhận được thông báo. Đối với thông báo hệ thống, đây là thời điểm hệ thống tạo thông báo.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
messageId

string

Không bắt buộc. mã nhận dạng duy nhất của tin nhắn trong cuộc trò chuyện để lưu trữ.
Trường hợp hợp nhất kind. Loại thông báo. kind chỉ có thể là một trong những loại sau:
userMessage

object (UserMessage)

Thông báo của người dùng đang tương tác với hệ thống.
systemMessage

object (SystemMessage)

Thông báo từ hệ thống để phản hồi người dùng.

UserMessage

Thông báo của người dùng đang tương tác với hệ thống.

Biểu diễn dưới dạng JSON 
{

  // Union field kind can be only one of the following:
  "text": string
  // End of list of possible types for union field kind.
}
Các trường
Trường hợp hợp nhất kind. Loại nội dung trong tin nhắn của người dùng. kind chỉ có thể là một trong những loại sau:
text

string

Văn bản nên sử dụng trường này thay vì blob.

SystemMessage

Thông báo từ hệ thống để phản hồi người dùng. Thông báo này cũng có thể là thông báo của người dùng dưới dạng ngữ cảnh trước đây cho các cuộc trò chuyện nhiều lượt với hệ thống.

Biểu diễn dưới dạng 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.
}
Các trường
Trường hợp hợp nhất kind. Loại nội dung trong thông báo hệ thống. kind chỉ có thể là một trong những loại sau:
text

object (TextMessage)

Nội dung phản hồi trực tiếp bằng ngôn ngữ tự nhiên cho tin nhắn của người dùng.
schema

object (SchemaMessage)

Một thông báo được tạo trong quá trình phân giải giản đồ.
data

object (DataMessage)

Thông báo được tạo trong quá trình truy xuất dữ liệu.
analysis

object (AnalysisMessage)

Thông báo được tạo trong quá trình phân tích.
chart

object (ChartMessage)

Thông báo được tạo trong quá trình tạo biểu đồ.
error

object (ErrorMessage)

Thông báo lỗi.

TextMessage

Tin nhắn văn bản nhiều phần.

Biểu diễn dưới dạng JSON 
{
  "parts": [
    string
  ]
}
Các trường
parts[]

string

Chỉ có đầu ra. Các phần của thông báo.

SchemaMessage

Một thông báo được tạo trong quá trình phân giải giản đồ.

Biểu diễn dưới dạng 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.
}
Các trường
Trường hợp hợp nhất kind. Liệu thông báo này có chứa truy vấn hay kết quả của việc phân giải giản đồ. kind chỉ có thể là một trong những loại sau:
query

object (SchemaQuery)

Truy vấn phân giải giản đồ.
result

object (SchemaResult)

Kết quả của truy vấn phân giải giản đồ.

SchemaQuery

Truy vấn để phân giải giản đồ liên quan đến câu hỏi được đặt ra.

Biểu diễn dưới dạng JSON 
{
  "question": string
}
Các trường
question

string

Chỉ có đầu ra. Câu hỏi cần gửi đến hệ thống để phân giải giản đồ.

SchemaResult

Kết quả của việc phân giải giản đồ.

Biểu diễn dưới dạng JSON 
{
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
Các trường
datasources[]

object (Datasource)

Chỉ có đầu ra. Nguồn dữ liệu dùng để phân giải truy vấn giản đồ.

Nguồn dữ liệu

Một nguồn dữ liệu có thể dùng để trả lời câu hỏi.

Biểu diễn dưới dạng 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.
}
Các trường
schema

object (Schema)

Chỉ có đầu ra. Giản đồ của nguồn dữ liệu.
Trường hợp hợp nhất reference. Tham chiếu đến nguồn dữ liệu. reference chỉ có thể là một trong những loại sau:
bigqueryTableReference

object (BigQueryTableReference)

Tham chiếu đến một bảng BigQuery.
studioDatasourceId

string

Tham chiếu đến nguồn dữ liệu Looker Studio.
lookerExploreReference

object (LookerExploreReference)

Tham chiếu đến một dữ liệu khám phá trên Looker.

DataMessage

Thông báo được tạo trong quá trình truy xuất dữ liệu.

Biểu diễn dưới dạng 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.
}
Các trường
Trường hợp hợp nhất kind. Liệu thông báo này có chứa truy vấn, kết quả hay SQL đã tạo để truy xuất dữ liệu hay không. kind chỉ có thể là một trong những loại sau:
query

object (DataQuery)

Truy vấn truy xuất dữ liệu.
generatedSql

string

SQL do hệ thống tạo để truy xuất dữ liệu.
result

object (DataResult)

Dữ liệu được truy xuất.
generatedLookerQuery

object (LookerQuery)

Truy vấn Looker do hệ thống tạo để truy xuất dữ liệu.
bigQueryJob

object (BigQueryJob)

Công việc BigQuery do hệ thống thực thi để truy xuất dữ liệu.

DataQuery

Truy vấn để truy xuất dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "question": string,
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
Các trường
name

string

Chỉ có đầu ra. Tên viết thường cho truy vấn phản ánh ý định của truy vấn. Hàm này được dùng để đặt tên cho kết quả dữ liệu tương ứng để có thể tham chiếu đến kết quả đó trong các bước sau.

Ví dụ: "total_sales_by_product" Ví dụ: "sales_for_product_12345"
question

string

Chỉ có đầu ra. Câu hỏi cần trả lời.
datasources[]

object (Datasource)

Chỉ có đầu ra. Các nguồn dữ liệu có sẵn để trả lời câu hỏi.

DataResult

Dữ liệu được truy xuất.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "schema": {
    object (Schema)
  },
  "data": [
    {
      object
    }
  ]
}
Các trường
name

string

Chỉ có đầu ra. Tên viết thường cho kết quả dữ liệu phản ánh nội dung của kết quả đó. Tên này được dùng để truyền kết quả theo tham chiếu và đóng vai trò là tín hiệu về ý nghĩa của kết quả.

Ví dụ: "total_sales_by_product" Ví dụ: "sales_for_product_12345"
schema

object (Schema)

Chỉ có đầu ra. Giản đồ của dữ liệu.
data[]

object (Struct format)

Chỉ có đầu ra. Nội dung của dữ liệu. Mỗi hàng là một cấu trúc khớp với giản đồ. Các giá trị đơn giản được biểu thị dưới dạng chuỗi, còn các cấu trúc lồng nhau được biểu thị dưới dạng danh sách hoặc cấu trúc.

LookerQuery

Truy vấn để truy xuất dữ liệu từ một bảng Khám phá trong Looker. Xem phần Chạy truy vấn cùng dòng.

Biểu diễn dưới dạng JSON 
{
  "model": string,
  "explore": string,
  "fields": [
    string
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "sorts": [
    string
  ],
  "limit": string
}
Các trường
model

string

Bắt buộc. Mô hình LookML dùng để tạo truy vấn.
explore

string

Bắt buộc. Dữ liệu khám phá LookML dùng để tạo truy vấn.
fields[]

string

Không bắt buộc. Các trường cần truy xuất từ dữ liệu khám phá.
filters[]

object (Filter)

Không bắt buộc. Bộ lọc để áp dụng cho dữ liệu khám phá.
sorts[]

string

Không bắt buộc. Các kiểu sắp xếp áp dụng cho dữ liệu khám phá.
limit

string

Không bắt buộc. Giới hạn trong truy vấn.

Bộ lọc

Bộ lọc truy vấn Looker.

Biểu diễn dưới dạng JSON 
{
  "field": string,
  "value": string
}
Các trường
field

string

Bắt buộc. Trường để lọc.
value

string

Bắt buộc. Trường giá trị f để lọc.

BigQueryJob

Một công việc BigQuery do hệ thống thực thi.

Biểu diễn dưới dạng JSON 
{
  "projectId": string,
  "jobId": string,
  "location": string,
  "destinationTable": {
    object (BigQueryTableReference)
  },
  "schema": {
    object (Schema)
  }
}
Các trường
projectId

string

Bắt buộc. Dự án chứa công việc đó.

Xem JobReference.
jobId

string

Bắt buộc. Mã của công việc.

Xem JobReference.
location

string

Không bắt buộc. Vị trí của công việc.

Xem JobReference.
destinationTable

object (BigQueryTableReference)

Chỉ có đầu ra. Tham chiếu đến bảng đích của kết quả truy vấn của công việc.

Xem JobConfigurationQuery.
schema

object (Schema)

Chỉ có đầu ra. Giản đồ của kết quả truy vấn của công việc.

Xem JobStatistics2.

AnalysisMessage

Thông báo được tạo trong quá trình phân tích.

Biểu diễn dưới dạng 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.
}
Các trường
Trường hợp hợp nhất kind. Thông báo này có chứa truy vấn hay một trong các sự kiện trong bản phân tích hay không. kind chỉ có thể là một trong những loại sau:
query

object (AnalysisQuery)

Một truy vấn phân tích.
progressEvent

object (AnalysisEvent)

Một sự kiện cho biết tiến trình phân tích.

AnalysisQuery

Truy vấn để thực hiện phân tích.

Biểu diễn dưới dạng JSON 
{
  "question": string,
  "dataResultNames": [
    string
  ]
}
Các trường
question

string

Chỉ có đầu ra. Câu hỏi phân tích để giúp trả lời câu hỏi ban đầu của người dùng.
dataResultNames[]

string

Chỉ có đầu ra. Tên của các kết quả dữ liệu đã truy xuất trước đó để phân tích.

AnalysisEvent

Một sự kiện cho biết tiến trình của một quá trình phân tích.

Biểu diễn dưới dạng 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.
}
Các trường
Trường hợp hợp nhất kind. Loại sự kiện xảy ra trong quá trình phân tích. kind chỉ có thể là một trong những loại sau:
plannerReasoning

string

Lý do của trình lập kế hoạch codegen Python.
coderInstruction

string

Hướng dẫn được đưa ra để tạo mã.
code

string

Mã đã tạo.
executionOutput

string

Kết quả thực thi mã.
executionError

string

Lỗi khi thực thi mã.
resultVegaChartJson

string

Kết quả dưới dạng chuỗi JSON của biểu đồ Vega.
resultNaturalLanguage

string

Kết quả dưới dạng chuỗi NL.
resultCsvData

string

Kết quả dưới dạng chuỗi CSV.
resultReferenceData

string

Kết quả dưới dạng tham chiếu đến một nguồn dữ liệu.
error

string

Thông báo lỗi chung.

ChartMessage

Thông báo được tạo trong quá trình tạo biểu đồ.

Biểu diễn dưới dạng 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.
}
Các trường
Trường hợp hợp nhất kind. Thông báo này có chứa truy vấn hay kết quả tạo biểu đồ. kind chỉ có thể là một trong những loại sau:
query

object (ChartQuery)

Truy vấn để tạo biểu đồ.
result

object (ChartResult)

Kết quả của truy vấn tạo biểu đồ.

ChartQuery

Truy vấn để tạo biểu đồ.

Biểu diễn dưới dạng JSON 
{
  "instructions": string,
  "dataResultName": string
}
Các trường
instructions

string

Chỉ có đầu ra. Hướng dẫn bằng ngôn ngữ tự nhiên để tạo biểu đồ.
dataResultName

string

Chỉ có đầu ra. Tên của kết quả dữ liệu đã truy xuất trước đó để sử dụng trong biểu đồ.

ChartResult

Kết quả của truy vấn tạo biểu đồ.

Biểu diễn dưới dạng JSON 
{
  "vegaConfig": {
    object
  },
  "image": {
    object (Blob)
  }
}
Các trường
vegaConfig

object (Struct format)

Chỉ có đầu ra. Cấu hình biểu đồ Vega đã tạo. Xem https://vega.github.io/vega/docs/config/
image

object (Blob)

Không bắt buộc. Kết xuất biểu đồ nếu biểu đồ này được yêu cầu trong ngữ cảnh.

Blob

Một blob dữ liệu có loại MIME.

Biểu diễn dưới dạng JSON 
{
  "mimeType": string,
  "data": string
}
Các trường
mimeType

string

Bắt buộc. Loại MIME tiêu chuẩn IANA của dữ liệu thư.
data

string (bytes format)

Bắt buộc. Dữ liệu được biểu thị dưới dạng byte.

Chuỗi được mã hoá base64.

ErrorMessage

Thông báo lỗi.

Biểu diễn dưới dạng JSON 
{
  "text": string
}
Các trường
text

string

Chỉ có đầu ra. Văn bản của lỗi.