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)

출력 전용입니다. 사용자 메시지의 경우 시스템이 메시지를 수신한 시간입니다. 시스템 메시지의 경우 시스템이 메시지를 생성한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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.
}
필드
통합 필드 kind. 시스템 메시지의 콘텐츠 종류입니다. kind은 다음 중 하나여야 합니다.
text

object (TextMessage)

사용자 메시지에 대한 직접적인 자연어 응답입니다.
schema

object (SchemaMessage)

스키마 확인 중에 생성된 메시지입니다.
data

object (DataMessage)

데이터를 가져오는 중에 생성된 메시지입니다.
analysis

object (AnalysisMessage)

분석 중에 생성된 메시지입니다.
chart

object (ChartMessage)

차트 생성 중에 생성된 메시지입니다.
error

object (ErrorMessage)

오류 메시지입니다.

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 Explore에 대한 참조입니다.

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 표현 
{
  "name": string,
  "question": string,
  "datasources": [
    {
      object (Datasource)
    }
  ]
}
필드
name

string

출력 전용입니다. 인텐트를 반영하는 쿼리의 스네이크 표기법 이름입니다. 이후 단계에서 참조할 수 있도록 해당 데이터 결과를 명명하는 데 사용됩니다.

예: 'total_sales_by_product' 예: 'sales_for_product_12345'
question

string

출력 전용입니다. 답변할 질문입니다.
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 codegen planner의 추론입니다.
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

출력 전용입니다. 오류 텍스트입니다.