conversational-analytics-update-data-agent

A “conversational-analytics-update-data-agent” tool allows updating an existing Conversational Analytics data agent.

About

A conversational-analytics-update-data-agent tool allows you to update an existing data agent in Conversational Analytics.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Gemini Data Analytics Source

Parameters

conversational-analytics-update-data-agent accepts the following parameters:

  • data_agent_id: The ID of the data agent to update.

  • agent_config: The JSON representation of the DataAgent resource fields to update. For the full schema, see the DataAgent REST resource documentation.

  • update_mask: Comma-separated list of fields to update, using the API’s camelCase JSON field names (e.g. "displayName,description" or "dataAnalyticsAgent.publishedContext.systemInstruction"). Every field listed here must also be present in agent_config.

    Example agent_config:

    {
      "displayName": "Updated Support Agent",
      "description": "Updated description",
      "dataAnalyticsAgent": {
        "publishedContext": {
          "systemInstruction": "You are a helpful support data analyst."
        }
      }
    }
    

Example

kind: tool
name: update_agent
type: conversational-analytics-update-data-agent
source: my-conversational-analytics-source
location: global
description: |
  Use this tool to update an existing data agent with the specified configuration and update mask.

Output Format

The tool returns the updated DataAgent object after waiting for the operation to complete successfully. Note that the tool will block and poll for up to 60 seconds.

Reference

fieldtyperequireddescription
typestringtrueMust be “conversational-analytics-update-data-agent”.
sourcestringtrueName of the source.
descriptionstringtrueDescription of the tool that is passed to the LLM.
locationstringfalseThe Google Cloud location (default: “global”).
authRequired[]stringfalseList of auth services required to use the tool.



Last modified October 22, 2026: chore(main): release 1.15.0 (#4255) (8e8e569)