REST Resource: projects.locations.dataAgents

Resource: DataAgent

Message describing a DataAgent object.

JSON representation 
{
  "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.
}
Fields
name

string

Optional. Identifier. The unique resource name of a DataAgent. Format: projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent} is the resource id and should be 63 characters or less and must match the format described in https://google.aip.dev/122#resource-id-segments

Example: projects/1234567890/locations/us-central1/dataAgents/my-agent.

It is recommended to skip setting this field during agent creation as it will be inferred automatically and overwritten with the {parent}/dataAgents/{dataAgentId}.
displayName

string

Optional. User friendly display name.

  • Must be between 1-256 characters.
description

string

Optional. Description of the agent.

  • Must be between 1-1024 characters.
labels

map (key: string, value: string)

Optional. Labels to help users filter related agents. For example, "sales", "business", "etl", and so on. Note labels are used only for filtering and not for policies. See the labels documentation for more details on label usage.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Output only. The time when the data agent was created.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Output only. The time when the data agent was last updated.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Output only. [Output only] The time the data agent was soft deleted.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
purgeTime

string (Timestamp format)

Output only. Timestamp in UTC of when this data agent is considered expired. This is always provided on output, regardless of what was sent on input.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Union field type. The type of the agent. Can be one of the following: * Data analytics agent. * Data engineering agent type can be only one of the following:
dataAnalyticsAgent

object (DataAnalyticsAgent)

Data analytics agent.

DataAnalyticsAgent

Message describing a DataAnalyticsAgent object.

JSON representation 
{
  "stagingContext": {
    object (Context)
  },
  "publishedContext": {
    object (Context)
  },
  "lastPublishedContext": {
    object (Context)
  }
}
Fields
stagingContext

object (Context)

Optional. The staging context for the agent. This context is used to test and validate changes before publishing.
publishedContext

object (Context)

Optional. The published context for the agent. This context is used by the Chat API in production.
lastPublishedContext

object (Context)

Output only. The last published context for the agent. This is an output-only field populated by the system when the published context is updated. It is used to restore the agent to a previous state.

Context

A collection of context to apply to this conversation

JSON representation 
{
  "systemInstruction": string,
  "datasourceReferences": {
    object (DatasourceReferences)
  },
  "options": {
    object (ConversationOptions)
  },
  "exampleQueries": [
    {
      object (ExampleQuery)
    }
  ]
}
Fields
systemInstruction

string

Optional. The basic entry point for data owners creating domain knowledge for Agent.

Why: Business jargon (e.g., YTD revenue is calculated as…, Retirement Age is 65 in the USA, etc) and system instructions (e.g., answer like a Pirate) can help the model understand the business context around a user question.
datasourceReferences

object (DatasourceReferences)

Required. Data sources that are available for answering the question.
options

object (ConversationOptions)

Optional. Additional options for the conversation.
exampleQueries[]

object (ExampleQuery)

Optional. A list of example queries, providing examples of relevant and commonly used SQL queries and their corresponding natural language queries optionally present. Currently only used for BigQuery data sources.

DatasourceReferences

A collection of references to datasources.

JSON representation 
{

  // 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.
}
Fields
Union field references. The datasources to use. references can be only one of the following:
bq

object (BigQueryTableReferences)

References to BigQuery tables.
studio

object (StudioDatasourceReferences)

References to Looker Studio datasources.
looker

object (LookerExploreReferences)

References to Looker Explores.

BigQueryTableReferences

Message representing references to BigQuery tables.

JSON representation 
{
  "tableReferences": [
    {
      object (BigQueryTableReference)
    }
  ]
}
Fields
tableReferences[]

object (BigQueryTableReference)

Required. References to BigQuery tables.

BigQueryTableReference

Message representing a reference to a single BigQuery table.

JSON representation 
{
  "projectId": string,
  "datasetId": string,
  "tableId": string,
  "schema": {
    object (Schema)
  }
}
Fields
projectId

string

Required. The project that the table belongs to.
datasetId

string

Required. The dataset that the table belongs to.
tableId

string

Required. The table id.
schema

object (Schema)

Optional. The schema of the datasource.

Schema

The schema of a Datasource or QueryResult instance.

JSON representation 
{
  "fields": [
    {
      object (Field)
    }
  ],
  "description": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "filters": [
    {
      object (DataFilter)
    }
  ]
}
Fields
fields[]

object (Field)

Optional. The fields in the schema.
description

string

Optional. A textual description of the table's content and purpose. For example: "Contains information about customer orders in our e-commerce store." Currently only used for BigQuery data sources.
synonyms[]

string

Optional. A list of alternative names or synonyms that can be used to refer to the table. For example: ["sales", "orders", "purchases"]. Currently only used for BigQuery data sources.
tags[]

string

Optional. A list of tags or keywords associated with the table, used for categorization. For example: ["transaction", "revenue", "customer_data"]. Currently only used for BigQuery data sources.
displayName

string

Optional. Table displayName (same as label in cloud/data_analytics/anarres/data/looker/proto/model_explore.proto), not required, currently only Looker has this field.
filters[]

object (DataFilter)

Optional. The filters on the datasource's underlying data. Currently only used for Looker data sources.

Field

A field in a schema.

JSON representation 
{
  "name": string,
  "type": string,
  "description": string,
  "mode": string,
  "synonyms": [
    string
  ],
  "tags": [
    string
  ],
  "displayName": string,
  "subfields": [
    {
      object (Field)
    }
  ],
  "category": string,
  "valueFormat": string
}
Fields
name

string

Optional. The name of the field.
type

string

Optional. The type of the field.
description

string

Optional. A brief description of the field.
mode

string

Optional. The mode of the field (e.g., NULLABLE, REPEATED).
synonyms[]

string

Optional. A list of alternative names or synonyms that can be used to refer to this field. For example: ["id", "customerid", "cust_id"]. Currently only used for BigQuery data sources.
tags[]

string

Optional. A list of tags or keywords associated with the field, used for categorization. For example: ["identifier", "customer", "pii"]. Currently only used for BigQuery data sources.
displayName

string

Optional. Field displayName (same as label in
subfields[]

object (Field)

Optional. Recursive property for nested schema structures.
category

string

Optional. Field category, not required, currently only useful for Looker. We are using a string to avoid depending on an external package and keep this package self-contained.
valueFormat

string

Optional. Looker only. Value format of the field. Ref: https://cloud.google.com/looker/docs/reference/param-field-value-format

DataFilter

A filter on a datasource's underlying data. Filter syntax documentation: https://cloud.google.com/looker/docs/filter-expressions

JSON representation 
{
  "field": string,
  "value": string,
  "type": enum (DataFilterType)
}
Fields
field

string

Optional. The field to filter on. For example: ["event_date", "customer_id", "product_category"]
value

string

Optional. The default value used for this filter if the filter is not overridden in a query. For example: ["after 2024-01-01", "123", "-fashion"]
type

enum (DataFilterType)

Optional. The type of filter present on a datasource, such as ALWAYS_FILTER.

DataFilterType

The type of filter present on a datasource, such as ALWAYS_FILTER.

Enums
DATA_FILTER_TYPE_UNSPECIFIED The filter type was not specified.
ALWAYS_FILTER A filter that the user configures, and any queries to the Explore will always apply this filter by default. Currently only used for Looker data sources.

StudioDatasourceReferences

Message representing references to Looker Studio datasources.

JSON representation 
{
  "studioReferences": [
    {
      object (StudioDatasourceReference)
    }
  ]
}
Fields
studioReferences[]

object (StudioDatasourceReference)

The references to the studio datasources.

StudioDatasourceReference

Message representing a reference to a single Looker Studio datasource.

JSON representation 
{
  "datasourceId": string
}
Fields
datasourceId

string

Required. The id of the datasource.

LookerExploreReferences

Message representing references to Looker explores.

JSON representation 
{
  "exploreReferences": [
    {
      object (LookerExploreReference)
    }
  ],
  "credentials": {
    object (Credentials)
  }
}
Fields
exploreReferences[]

object (LookerExploreReference)

Required. References to Looker explores.
credentials

object (Credentials)

Optional. The credentials to use when calling the Looker API.

Currently supports both OAuth token and API key-based credentials, as described in Authentication with an SDK.

LookerExploreReference

Message representing a reference to a single Looker explore.

JSON representation 
{
  "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.
}
Fields
lookmlModel

string

Required. Looker model, as outlined in Major LookML structures. Name of the LookML model.
explore

string

Required. Looker Explore, as outlined in Major LookML structures. Name of the LookML Explore.
schema

object (Schema)

Optional. The schema of the datasource.
Union field instance. The instance of the Looker explore. instance can be only one of the following:
lookerInstanceUri

string

Required. The base url of the Looker instance.
privateLookerInstanceInfo

object (PrivateLookerInstanceInfo)

Private Looker instance info.

PrivateLookerInstanceInfo

Message representing a private Looker instance info required if the Looker instance is behind a private network.

JSON representation 
{
  "lookerInstanceId": string,
  "serviceDirectoryName": string
}
Fields
lookerInstanceId

string

The Looker instance id.
serviceDirectoryName

string

The service directory name of the Looker instance.

Credentials

Represents different forms of credential specification.

JSON representation 
{

  // Union field kind can be only one of the following:
  "oauth": {
    object (OAuthCredentials)
  }
  // End of list of possible types for union field kind.
}
Fields
Union field kind. The kind of credentials. } kind can be only one of the following:
oauth

object (OAuthCredentials)

OAuth credentials.

OAuthCredentials

Represents OAuth credentials.

JSON representation 
{

  // 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.
}
Fields
Union field kind. The kind of OAuth credentials. kind can be only one of the following:
secret

object (SecretBased)

Secret-based OAuth credentials.
token

object (TokenBased)

Token-based OAuth credentials.

SecretBased

The name of the secret containing the access token. Represents secret-based OAuth credentials.

JSON representation 
{
  "clientId": string,
  "clientSecret": string
}
Fields
clientId

string

Required. An OAuth client ID.
clientSecret

string

Required. An OAuth client secret.

TokenBased

Read more about Looker access tokens here: https://developers.looker.com/api/advanced-usage/looker-api-oauth

JSON representation 
{
  "accessToken": string
}
Fields
accessToken

string

Required. The name of the secret containing the access token.

ConversationOptions

Options for the conversation.

JSON representation 
{
  "chart": {
    object (ChartOptions)
  },
  "analysis": {
    object (AnalysisOptions)
  }
}
Fields
chart

object (ChartOptions)

Optional. Options for chart generation.
analysis

object (AnalysisOptions)

Optional. Options for analysis.

ChartOptions

Options for chart generation.

JSON representation 
{
  "image": {
    object (ImageOptions)
  }
}
Fields
image

object (ImageOptions)

Optional. When specified, the agent will render generated charts using the provided format. Defaults to no image.

ImageOptions

Options for rendering images of generated charts.

JSON representation 
{

  // 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.
}
Fields
Union field kind. The kind of image to render. kind can be only one of the following:
noImage

object (NoImage)

No image.
svg

object (SvgOptions)

SVG format.

NoImage

This type has no fields.

No image.

SvgOptions

This type has no fields.

SVG options.

AnalysisOptions

Options for analysis.

JSON representation 
{
  "python": {
    object (Python)
  }
}
Fields
python

object (Python)

Optional. Options for Python analysis.

Python

Options for Python analysis.

JSON representation 
{
  "enabled": boolean
}
Fields
enabled

boolean

Optional. Whether to enable Python analysis. Defaults to false.

ExampleQuery

Example of relevant and commonly used SQL query and its corresponding natural language queries optionally present. Currently only used for BigQuery data sources.

JSON representation 
{
  "naturalLanguageQuestion": string,

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

string

Optional. A natural language question that a user might ask. For example: "How many orders were placed last month?"
Union field query. The SQL or Looker query that should be generated to answer the natural language query. query can be only one of the following:
sqlQuery

string

Optional. The SQL query that should be generated to answer the natural language question. For example: "SELECT COUNT(*) FROM orders WHERE order_date BETWEEN '2024-01-01' AND '2024-01-31'"

Methods

create

 Creates a new DataAgent in a given project and location.

delete

 Deletes a single DataAgent.

get

 Gets details of a single DataAgent.

getIamPolicy

 Gets the IAM policy for DataAgent

list

 Lists DataAgents in a given project and location.

listAccessible

 Lists DataAgents that are accessible to the caller in a given project and location.

patch

 Updates the parameters of a single DataAgent.

setIamPolicy

 Sets the IAM policy for a DataAgent.