REST Resource: projects.locations.dataAgents

Tài nguyên: DataAgent

Thông báo mô tả đối tượng DataAgent.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,

  // Union field type can be only one of the following:
  "dataAnalyticsAgent": {
    object (DataAnalyticsAgent)
  }
  // End of list of possible types for union field type.
}
Các trường
name

string

Không bắt buộc. Giá trị nhận dạng. Tên tài nguyên duy nhất của một Tác nhân. Định dạng: "projects/{project}/locations/{location}/dataAgents/{dataAgentId}" {dataAgent} là mã nhận dạng tài nguyên và phải có tối đa 63 ký tự, đồng thời phải khớp với định dạng được mô tả trong https://google.aip.dev/122#resource-id-segments

Ví dụ: "projects/1234567890/locations/us-central1/dataAgents/my-agent"
displayName

string

Không bắt buộc. Tên hiển thị dễ hiểu cho người dùng.

  • Phải có từ 1 đến 256 ký tự.
description

string

Không bắt buộc. Nội dung mô tả về tác nhân.

  • Phải có từ 1 đến 1024 ký tự.
labels

map (key: string, value: string)

Không bắt buộc. Nhãn giúp người dùng lọc các nhân viên hỗ trợ có liên quan. Ví dụ: "doanh số", "doanh nghiệp", "etl", v.v. Lưu ý rằng nhãn chỉ dùng để lọc chứ không dùng cho chính sách. Hãy xem phần Tổng quan về nhãn để biết thêm thông tin chi tiết về cách sử dụng nhãn.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian tạo tác nhân dữ liệu.

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

string (Timestamp format)

Chỉ có đầu ra. Thời gian gần đây nhất mà tác nhân dữ liệu được cập nhật.

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

object (DataAnalyticsAgent)

Tác nhân phân tích dữ liệu.

DataAnalyticsAgent

Thông báo mô tả đối tượng DataAnalyticsAgent.

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

object (Context)

Không bắt buộc. Ngữ cảnh dàn dựng cho tác nhân. Ngữ cảnh này được dùng để kiểm thử và xác thực các thay đổi trước khi phát hành.
publishedContext

object (Context)

Không bắt buộc. Ngữ cảnh đã xuất bản cho tác nhân. Ngữ cảnh này được API Chat sử dụng trong bản phát hành chính thức.

Bối cảnh

Một tập hợp ngữ cảnh để áp dụng cho cuộc trò chuyện này

Biểu diễn dưới dạng JSON 
{
  "systemInstruction": string,
  "datasourceReferences": {
    object (DatasourceReferences)
  },
  "options": {
    object (ConversationOptions)
  }
}
Các trường
systemInstruction

string

Không bắt buộc. Điểm truy cập cơ bản cho chủ sở hữu dữ liệu tạo kiến thức về miền cho Trợ lý.
datasourceReferences

object (DatasourceReferences)

Bắt buộc. Các nguồn dữ liệu có sẵn để trả lời câu hỏi.
options

object (ConversationOptions)

Không bắt buộc. Các tuỳ chọn khác cho cuộc trò chuyện.

DatasourceReferences

Một tập hợp các tệp tham chiếu đến nguồn dữ liệu.

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

  // Union field references can be only one of the following:
  "bq": {
    object (BigQueryTableReferences)
  },
  "studio": {
    object (StudioDatasourceReferences)
  },
  "looker": {
    object (LookerExploreReferences)
  }
  // End of list of possible types for union field references.
}
Các trường
Trường hợp hợp nhất references. Nguồn dữ liệu cần sử dụng. references chỉ có thể là một trong những loại sau:
bq

object (BigQueryTableReferences)

Tham chiếu đến các bảng BigQuery.
studio

object (StudioDatasourceReferences)

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

object (LookerExploreReferences)

Tham chiếu đến dữ liệu khám phá của Looker.

BigQueryTableReferences

Thông báo đại diện cho các tệp tham chiếu đến bảng BigQuery.

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

object (BigQueryTableReference)

Bắt buộc. Tham chiếu đến các bảng BigQuery.

BigQueryTableReference

Thông báo đại diện cho một tham chiếu đến một bảng BigQuery.

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

string

Bắt buộc. Dự án mà bảng thuộc về.
datasetId

string

Bắt buộc. Tập dữ liệu mà bảng thuộc về.
tableId

string

Bắt buộc. Mã bảng.

StudioDatasourceReferences

Thông báo thể hiện các tệp tham chiếu đến nguồn dữ liệu Looker Studio.

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

object (StudioDatasourceReference)

Các tệp tham chiếu đến nguồn dữ liệu của Studio.

StudioDatasourceReference

Thông báo đại diện cho một tham chiếu đến một nguồn dữ liệu Looker Studio.

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

string

Bắt buộc. Mã nhận dạng của nguồn dữ liệu.

LookerExploreReferences

Thông báo đại diện cho các tệp tham chiếu đến Looker Explore.

Biểu diễn dưới dạng JSON 
{
  "exploreReferences": [
    {
      object (LookerExploreReference)
    }
  ],
  "credentials": {
    object (Credentials)
  }
}
Các trường
exploreReferences[]

object (LookerExploreReference)

Bắt buộc. Tham chiếu đến dữ liệu khám phá của Looker.
credentials

object (Credentials)

Không bắt buộc. Thông tin xác thực cần sử dụng khi gọi Looker API.

Hiện hỗ trợ cả mã thông báo oauth và thông tin xác thực dựa trên khoá API, như mô tả trong phần Xác thực bằng SDK.

LookerExploreReference

Thông báo đại diện cho một tham chiếu đến một Looker Explore.

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

string

Bắt buộc. Tên của mô hình LookML, như được nêu trong phần Các cấu trúc LookML chính.
explore

string

Bắt buộc. Tên của Looker Explore, như được nêu trong phần Các cấu trúc LookML chính.
schema

object (Schema)

Không bắt buộc. Giản đồ của nguồn dữ liệu.
Trường hợp hợp nhất instance. Phiên bản của Looker Explore. instance chỉ có thể là một trong những loại sau:
lookerInstanceUri

string

Bắt buộc. URL cơ sở của thực thể Looker.
privateLookerInstanceInfo

object (PrivateLookerInstanceInfo)

Thông tin về phiên bản Looker riêng tư.

PrivateLookerInstanceInfo

Thông báo thể hiện thông tin về phiên bản Looker riêng tư bắt buộc nếu phiên bản Looker nằm sau một mạng riêng tư.

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

string

Mã phiên bản Looker.
serviceDirectoryName

string

Tên thư mục dịch vụ của thực thể Looker.

Sơ đồ

Giản đồ của một thực thể Datasource hoặc QueryResult.

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

object (Field)

Chỉ có đầu ra. Các trường trong giản đồ.

Trường

Một trường trong giản đồ.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "type": string,
  "description": string,
  "mode": string,
  "displayName": string,
  "subfields": [
    {
      object (Field)
    }
  ]
}
Các trường
name

string

Chỉ có đầu ra. Tên của trường.
type

string

Chỉ có đầu ra. Loại trường.
description

string

Chỉ có đầu ra. Nội dung mô tả ngắn gọn về trường.
mode

string

Chỉ có đầu ra. Chế độ của trường (ví dụ: NULLABLE, REPEATED).
displayName

string

Không bắt buộc. Tên hiển thị của trường (tương tự như nhãn trong
subfields[]

object (Field)

Không bắt buộc. Thuộc tính đệ quy cho các cấu trúc giản đồ lồng nhau.

Thông tin đăng nhập

Biểu thị các hình thức thông số kỹ thuật về thông tin xác thực.

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

  // Union field kind can be only one of the following:
  "oauth": {
    object (OAuthCredentials)
  }
  // End of list of possible types for union field kind.
}
Các trường
oauth

object (OAuthCredentials)

Thông tin xác thực OAuth.

OAuthCredentials

Biểu thị thông tin xác thực OAuth.

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

  // 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.
}
Các trường
Trường hợp hợp nhất kind. Loại thông tin xác thực OAuth. kind chỉ có thể là một trong những loại sau:
secret

object (SecretBased)

Thông tin đăng nhập OAuth dựa trên khoá bí mật.
token

object (TokenBased)

Thông tin xác thực OAuth dựa trên mã thông báo.

SecretBased

Tên của khoá bí mật chứa mã thông báo truy cập. Biểu thị thông tin xác thực OAuth dựa trên khoá bí mật.

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

string

Bắt buộc. Mã ứng dụng khách OAuth.
clientSecret

string

Bắt buộc. Khoá bí mật của ứng dụng khách OAuth.

TokenBased

Để biết thêm thông tin về mã truy cập Looker, hãy xem phần Xác thực API Looker.

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

string

Bắt buộc. Tên của khoá bí mật chứa mã thông báo truy cập.

ConversationOptions

Các tuỳ chọn cho cuộc trò chuyện.

Biểu diễn dưới dạng JSON 
{
  "chart": {
    object (ChartOptions)
  },
  "analysis": {
    object (AnalysisOptions)
  }
}
Các trường
chart

object (ChartOptions)

Không bắt buộc. Các tuỳ chọn để tạo biểu đồ.
analysis

object (AnalysisOptions)

Không bắt buộc. Các tuỳ chọn phân tích.

ChartOptions

Các tuỳ chọn để tạo biểu đồ.

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

object (ImageOptions)

Không bắt buộc. Khi được chỉ định, tác nhân sẽ hiển thị các biểu đồ được tạo bằng định dạng được cung cấp. Giá trị mặc định là không có hình ảnh.

ImageOptions

Các tuỳ chọn để kết xuất hình ảnh của biểu đồ được tạo.

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

  // 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.
}
Các trường
Trường hợp hợp nhất kind. Loại hình ảnh cần kết xuất. kind chỉ có thể là một trong những loại sau:
noImage

object (NoImage)

Không có hình ảnh.
svg

object (SvgOptions)

Định dạng SVG.

NoImage

Loại này không có trường nào.

Không có hình ảnh.

SvgOptions

Loại này không có trường nào.

Tuỳ chọn SVG.

AnalysisOptions

Các tuỳ chọn phân tích.

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

object (Python)

Không bắt buộc. Các tuỳ chọn để phân tích Python.

Python

Các tuỳ chọn để phân tích Python.

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

boolean

Không bắt buộc. Có bật tính năng phân tích Python hay không. Giá trị mặc định là sai.

Phương thức

create

 Tạo một DataAgent mới trong một dự án và vị trí nhất định.

delete

 Xoá một DataAgent.

get

 Lấy thông tin chi tiết về một DataAgent.

list

 Liệt kê các DataAgent trong một dự án và vị trí nhất định.

patch

 Cập nhật các tham số của một DataAgent.