REST Resource: projects.locations.dataAgents

资源：DataAgent

描述 DataAgent 对象的消息。

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "purgeTime": string,

  // Union field type can be only one of the following:
  "dataAnalyticsAgent": {
    object (DataAnalyticsAgent)
  }
  // End of list of possible types for union field type.
}
字段
name

string

可选。标识符。DataAgent 的唯一资源名称。格式：projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent} 是资源 ID，长度不得超过 63 个字符，并且必须符合 https://google.aip.dev/122#resource-id-segments 中所述的格式

示例：projects/1234567890/locations/us-central1/dataAgents/my-agent。

建议在创建代理期间跳过设置此字段，因为系统会自动推理此字段，并使用 {parent}/dataAgents/{dataAgentId} 覆盖此字段。
displayName

string

可选。简单易记的显示名称。

  • 长度必须介于 1 到 256 个字符之间。
description

string

可选。代理的说明。

  • 长度必须介于 1 到 1024 个字符之间。
labels

map (key: string, value: string)

可选。可帮助用户过滤相关代理的标签。例如，“sales”“business”“etl”等。请注意，标签仅用于过滤，不用于政策。如需详细了解标签用法，请参阅标签文档。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
createTime

string (Timestamp format)

仅限输出。创建数据代理的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。上次更新数据代理的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
deleteTime

string (Timestamp format)

仅限输出。[仅限输出] 将数据代理软删除的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
purgeTime

string (Timestamp format)

仅限输出。相应数据代理被视为过期时的时间戳（世界协调时间 [UTC]）。无论输入中发送的是什么内容，输出中始终都会提供此时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
联合字段 type。代理的类型。可以是以下各项之一：* 数据分析代理。* 数据工程代理 type 只能是下列其中一项：
dataAnalyticsAgent

object (DataAnalyticsAgent)

数据分析代理。

DataAnalyticsAgent

描述 DataAnalyticsAgent 对象的消息。

JSON 表示法 
{
  "stagingContext": {
    object (Context)
  },
  "publishedContext": {
    object (Context)
  },
  "lastPublishedContext": {
    object (Context)
  }
}
字段
stagingContext

object (Context)

可选。代理的暂存上下文。此上下文用于在发布之前测试和验证更改。
publishedContext

object (Context)

可选。代理的已发布上下文。此上下文由 Chat API 在生产环境中使用。
lastPublishedContext

object (Context)

仅限输出。代理的上次发布上下文。这是仅限输出的字段，在已发布的内容更新时由系统进行填充。它用于将代理恢复到之前的状态。

Context

要应用于此对话的上下文集合

JSON 表示法 
{
  "systemInstruction": string,
  "datasourceReferences": {
    object (DatasourceReferences)
  },
  "options": {
    object (ConversationOptions)
  },
  "exampleQueries": [
    {
      object (ExampleQuery)
    }
  ]
}
字段
systemInstruction

string

可选。数据所有者为代理创建领域知识的基本入口点。

原因：业务术语（例如 YTD revenue is calculated as…、Retirement Age is 65 in the USA 等）和系统指令（例如 answer like a Pirate）可以帮助模型了解用户问题的业务上下文。
datasourceReferences

object (DatasourceReferences)

必需。可用于回答问题的数据源。
options

object (ConversationOptions)

可选。适用于对话的其他选项。
exampleQueries[]

object (ExampleQuery)

可选。示例查询列表，可提供相关的常用 SQL 查询示例及其相应的自然语言查询（可选）。目前仅用于 BigQuery 数据源。

DatasourceReferences

对数据源的引用的集合。

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.
}
字段
联合字段 references。要使用的数据源。references 只能是下列其中一项：
bq

object (BigQueryTableReferences)

对 BigQuery 表的引用。
studio

object (StudioDatasourceReferences)

对 Looker Studio 数据源的引用。
looker

object (LookerExploreReferences)

对 Looker 探索的引用。

BigQueryTableReferences

表示对 BigQuery 表的引用的消息。

JSON 表示法 
{
  "tableReferences": [
    {
      object (BigQueryTableReference)
    }
  ]
}
字段
tableReferences[]

object (BigQueryTableReference)

必需。对 BigQuery 表的引用。

BigQueryTableReference

表示对单个 BigQuery 表的引用的消息。

JSON 表示法 
{
  "projectId": string,
  "datasetId": string,
  "tableId": string,
  "schema": {
    object (Schema)
  }
}
字段
projectId

string

必需。表所属的项目。
datasetId

string

必需。表所属的数据集。
tableId

string

必需。表 ID。
schema

object (Schema)

可选。数据源的架构。

架构

数据源或 QueryResult 实例的架构。

JSON 表示法 
{
  "fields": [
    {
      object (Field)
    }
  ],
  "description": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "filters": [
    {
      object (DataFilter)
    }
  ]
}
字段
fields[]

object (Field)

可选。架构中的字段。
description

string

可选。表内容和用途的文本说明。例如：“Contains information about customer orders in our e-commerce store.”目前仅用于 BigQuery 数据源。
synonyms[]

string

可选。可用于引用表的备用名称或同义词的列表。例如：["sales", "orders", "purchases"]。目前仅用于 BigQuery 数据源。
tags[]

string

可选。与表关联的标记或关键字的列表（用于分类）。例如：["transaction", "revenue", "customer_data"]。目前仅用于 BigQuery 数据源。
displayName

string

可选。表显示名称（与 cloud/data_analytics/anarres/data/looker/proto/model_explore.proto 中的标签相同），不是必需的，目前只有 Looker 具有此字段。
filters[]

object (DataFilter)

可选。针对数据源底层数据的过滤条件。目前仅用于 Looker 数据源。

Field

架构中的字段。

JSON 表示法 
{
  "name": string,
  "type": string,
  "description": string,
  "mode": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "subfields": [
    {
      object (Field)
    }
  ],
  "category": string,
  "valueFormat": string
}
字段
name

string

可选。字段的名称。
type

string

可选。字段的类型。
description

string

可选。字段的简要说明。
mode

string

可选。字段的模式（例如 NULLABLE、REPEATED）。
synonyms[]

string

可选。可用于引用此字段的备用名称或同义词的列表。例如：["id", "customerid", "cust_id"]。目前仅用于 BigQuery 数据源。
tags[]

string

可选。与字段关联的标记或关键字的列表（用于分类）。例如：["identifier", "customer", "pii"]。目前仅用于 BigQuery 数据源。
displayName

string

可选。字段显示名称（与标签相同）
subfields[]

object (Field)

可选。嵌套架构结构的递归属性。
category

string

可选。字段类别，不是必需的，目前仅用于 Looker。我们使用字符串以避免依赖外部软件包，并使此软件包保持独立。
valueFormat

string

可选。仅限 Looker。字段的值格式。参考：https://cloud.google.com/looker/docs/reference/param-field-value-format

DataFilter

针对数据源底层数据的过滤条件。过滤条件语法文档：https://cloud.google.com/looker/docs/filter-expressions

JSON 表示法 
{
  "field": string,
  "value": string,
  "type": enum (DataFilterType)
}
字段
field

string

可选。要过滤的字段。 例如：["event_date", "customer_id", "product_category"]
value

string

可选。如果未在查询中替换此过滤条件，则是用于此过滤条件的默认值。例如：["after 2024-01-01", "123", "-fashion"]
type

enum (DataFilterType)

可选。数据源上存在的过滤条件的类型，例如 ALWAYS_FILTER。

DataFilterType

数据源上存在的过滤条件的类型，例如 ALWAYS_FILTER。

枚举
DATA_FILTER_TYPE_UNSPECIFIED 未指定过滤条件类型。
ALWAYS_FILTER 用户配置的过滤条件，对探索发出的任何查询始终默认应用此过滤条件。目前仅用于 Looker 数据源。

StudioDatasourceReferences

表示对 Looker Studio 数据源的引用的消息。

JSON 表示法 
{
  "studioReferences": [
    {
      object (StudioDatasourceReference)
    }
  ]
}
字段
studioReferences[]

object (StudioDatasourceReference)

对 Studio 数据源的引用。

StudioDatasourceReference

表示对单个 Looker Studio数据源的引用的消息。

JSON 表示法 
{
  "datasourceId": string
}
字段
datasourceId

string

必需。数据源的 ID。

LookerExploreReferences

表示对 Looker 探索的引用的消息。

JSON 表示法 
{
  "exploreReferences": [
    {
      object (LookerExploreReference)
    }
  ],
  "credentials": {
    object (Credentials)
  }
}
字段
exploreReferences[]

object (LookerExploreReference)

必需。对 Looker 探索的引用。
credentials

object (Credentials)

可选。调用 Looker API 时要使用的凭证。

目前支持基于 OAuth 令牌和 API 密钥的凭证，如使用 SDK 进行身份验证中所述。

LookerExploreReference

表示对单个 Looker 探索的引用的消息。

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.
}
字段
lookmlModel

string

必需。Looker 模型，如主要 LookML 结构中所述。LookML 模型的名称。
explore

string

必需。Looker 探索，如主要 LookML 结构中所述。LookML 探索的名称。
schema

object (Schema)

可选。数据源的架构。
联合字段 instance。Looker 探索的实例。instance 只能是下列其中一项：
lookerInstanceUri

string

必需。Looker 实例的基础网址。
privateLookerInstanceInfo

object (PrivateLookerInstanceInfo)

专用 Looker 实例信息。

PrivateLookerInstanceInfo

表示专用 Looker 实例信息的消息（在 Looker 实例位于专用网络后面时需要）。

JSON 表示法 
{
  "lookerInstanceId": string,
  "serviceDirectoryName": string
}
字段
lookerInstanceId

string

Looker 实例 ID。
serviceDirectoryName

string

Looker 实例的服务目录名称。

凭据

表示不同形式的凭证规范。

JSON 表示法 
{

  // Union field kind can be only one of the following:
  "oauth": {
    object (OAuthCredentials)
  }
  // End of list of possible types for union field kind.
}
字段
联合字段 kind。凭证的种类。kind 只能是下列其中一项：
oauth

object (OAuthCredentials)

OAuth 凭证。

OAuthCredentials

表示 OAuth 凭证。

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.
}
字段
联合字段 kind。OAuth 凭证的种类。kind 只能是下列其中一项：
secret

object (SecretBased)

基于 Secret 的 OAuth 凭证。
token

object (TokenBased)

基于令牌的 OAuth 凭证。

SecretBased

包含访问令牌的 Secret 的名称。表示基于 Secret 的 OAuth 凭证。

JSON 表示法 
{
  "clientId": string,
  "clientSecret": string
}
字段
clientId

string

必需。OAuth 客户端 ID。
clientSecret

string

必需。OAuth 客户端密钥。

TokenBased

如需详细了解 Looker 访问令牌，请访问以下网址：https://developers.looker.com/api/advanced-usage/looker-api-oauth

JSON 表示法 
{
  "accessToken": string
}
字段
accessToken

string

必需。包含访问令牌的 Secret 的名称。

ConversationOptions

适用于对话的选项。

JSON 表示法 
{
  "chart": {
    object (ChartOptions)
  },
  "analysis": {
    object (AnalysisOptions)
  }
}
字段
chart

object (ChartOptions)

可选。适用于图表生成的选项。
analysis

object (AnalysisOptions)

可选。适用于分析的选项。

ChartOptions

适用于图表生成的选项。

JSON 表示法 
{
  "image": {
    object (ImageOptions)
  }
}
字段
image

object (ImageOptions)

可选。指定后，代理将使用提供的格式呈现生成的图表。默认为无图片。

ImageOptions

用于呈现生成的图表的图片的选项。

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.
}
字段
联合字段 kind。要呈现的图片的种类。kind 只能是下列其中一项：
noImage

object (NoImage)

没有图片。
svg

object (SvgOptions)

SVG 格式。

NoImage

此类型没有字段。

没有图片。

SvgOptions

此类型没有字段。

SVG 选项。

AnalysisOptions

适用于分析的选项。

JSON 表示法 
{
  "python": {
    object (Python)
  }
}
字段
python

object (Python)

可选。适用于 Python 分析的选项。

Python

适用于 Python 分析的选项。

JSON 表示法 
{
  "enabled": boolean
}
字段
enabled

boolean

可选。是否启用 Python 分析。默认值为 false。

ExampleQuery

相关的常用 SQL 查询示例及其相应的自然语言查询（可选）。目前仅用于 BigQuery 数据源。

JSON 表示法 
{
  "naturalLanguageQuestion": string,

  // Union field query can be only one of the following:
  "sqlQuery": string
  // End of list of possible types for union field query.
}
字段
naturalLanguageQuestion

string

可选。用户可能会提出的自然语言问题。例如：“How many orders were placed last month?”
联合字段 query。为回答自然语言查询而应生成的 SQL 或 Looker 查询。query 只能是下列其中一项：
sqlQuery

string

可选。为回答自然语言查询而应生成的 SQL 查询。例如：“SELECT COUNT(*) FROM orders WHERE order_date BETWEEN '2024-01-01' AND '2024-01-31'”

方法

create

 在给定的项目和位置中创建新 DataAgent。

delete

 删除单个 DataAgent。

get

 获取单个 DataAgent 的详细信息。

getIamPolicy

 获取 DataAgent 的 IAM 政策

list

 列出给定项目和位置中的 DataAgent。

listAccessible

 列出给定项目和位置中调用方可访问的 DataAgent。

patch

 更新单个 DataAgent 的参数。

setIamPolicy

 为 DataAgent 设置 IAM 政策。