DataAgent(mapping=None, *, ignore_unknown_fields=False, **kwargs)Message describing a DataAgent object.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
Attributes |
|
|---|---|
| Name | Description |
data_analytics_agent |
google.cloud.geminidataanalytics_v1beta.types.DataAnalyticsAgent
Data analytics agent. This field is a member of oneof_ type.
|
name |
str
Optional. Identifier. The unique resource name of a DataAgent. Format: projects/{project}/locations/{location}/dataAgents/{data_agent_id}
{data_agent} 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/global/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/{data_agent_id}.
|
display_name |
str
Optional. User friendly display name. - Must be between 1-256 characters. |
description |
str
Optional. Description of the agent. - Must be between 1-1024 characters. |
labels |
MutableMapping[str, str]
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 |
create_time |
google.protobuf.timestamp_pb2.Timestamp
Output only. The time when the data agent was created. |
update_time |
google.protobuf.timestamp_pb2.Timestamp
Output only. The time when the data agent was last updated. |
delete_time |
google.protobuf.timestamp_pb2.Timestamp
Output only. [Output only] The time the data agent was soft deleted. |
purge_time |
google.protobuf.timestamp_pb2.Timestamp
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. |
kms_key |
str
Optional. Customer managed encryption key (CMEK) to use for encrypting the DataAgent resources. Cloud KMS CryptoKeys must reside in the same location as the DataAgent. The expected format is projects/*/locations/*/keyRings/*/cryptoKeys/*.
This field is a member of oneof_ _kms_key.
|
bigquery_agent_analytics_enabled |
bool
Optional. Controls whether BigQuery Agent Analytics trace logging is enabled for the agent. Trace logging is suppressed for the entire turn, without error, when any table in the agent's data source carries row-level security, column-level security, policy tags, or data masking. It is also suppressed when that determination cannot be made, for example when the caller lacks permission to inspect a table's security policies. Trace rows are written only when this is true and
bigquery_agent_analytics_table is set. On a BigQuery
agent, enabling this without a table has no effect: no table
is created for the agent and no rows are written. On an
agent whose data source is not BigQuery, CreateDataAgent
and UpdateDataAgent reject setting this field to
true or setting bigquery_agent_analytics_table with
INVALID_ARGUMENT. See bigquery_agent_analytics_table
for when this is checked.
This setting is independent of the project-level BigQuery
Agent Analytics setting configured through
setAgentOpsObservability. An agent does not inherit that
setting.
On read, this field reflects the setting that applies to
conversations served from published_context, or from
staging_context while the agent is unpublished. An
update that changes this field or
bigquery_agent_analytics_table applies both fields to
conversations served from staging_context and, once the
agent has been published, from published_context.
This field is a member of oneof_ _bigquery_agent_analytics_enabled.
|
bigquery_agent_analytics_table |
google.cloud.geminidataanalytics_v1beta.types.BigQueryTableReference
Optional. The BigQuery table that BigQuery Agent Analytics trace rows are written to. Has no effect unless bigquery_agent_analytics_enabled is true.
The trace table is validated when it is set on
CreateDataAgent, and on UpdateDataAgent as described
below. A call to UpdateDataAgent writes a field if the
field is in update_mask or, when update_mask is
omitted, if the field is present in the request, even if its
value is unchanged. The following are rejected with
INVALID_ARGUMENT:
- The table must belong to the same project as the agent.
- The agent's data source must be BigQuery. BigQuery Agent
Analytics is not supported for Looker, Looker Studio or
AlloyDB agents.
On UpdateDataAgent, the table's project is checked
whenever the call writes a table to this field, or turns
bigquery_agent_analytics_enabled on over a stored table.
An update that only clears this field is not checked.
On CreateDataAgent, the data source is validated against
the agent in the request. On UpdateDataAgent, it is
validated against the stored agent after applying the update
whenever the update changes the data source of
staging_context or published_context, turns
bigquery_agent_analytics_enabled on, or sets a different
table in this field. For example, switching an agent that
turns logging on or names a trace table to a non-BigQuery
data source is rejected, unless the same update turns
logging off and clears this field. An unrelated edit,
including a call to UpdateDataAgent without
update_mask that carries an unchanged
bigquery_agent_analytics_enabled = true or the stored
table, is not rejected, and neither is an update that only
turns bigquery_agent_analytics_enabled off or clears
this field. A context that carries no data source is not
validated.
The destination dataset must already exist and must grant
write access to the project's Gemini Data Analytics service
agent, whose address is
service-PROJECT_NUMBER@gcp-sa-geminidataanalytics.iam.gserviceaccount.com
(that grant is not performed on your behalf). Without it the
agent answers normally and no trace rows are written.
Changing the table on an existing agent affects subsequent
turns only. Rows already written to the previous table are
left in place.
On read, this field reflects the table that applies to
conversations served from published_context, or from
staging_context while the agent is unpublished. An
update that changes this field or
bigquery_agent_analytics_enabled applies both fields to
conversations served from staging_context and, once the
agent has been published, from published_context.
|
Classes
LabelsEntry
LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)The abstract base class for a message.
| Parameters | |
|---|---|
| Name | Description |
kwargs |
dict
Keys and values corresponding to the fields of the message. |
mapping |
Union[dict,
A dictionary or message to be used to determine the values for this message. |
ignore_unknown_fields |
Optional(bool)
If True, do not raise errors for unknown fields. Only applied if |