conversational-analytics-create-data-agent

A “conversational-analytics-create-data-agent” tool allows creating a new Conversational Analytics data agent.

About

A conversational-analytics-create-data-agent tool allows you to create a new 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-create-data-agent accepts the following parameters:

  • data_agent_id: The ID to use for the new data agent. Must start with a lowercase letter, contain only lowercase letters, digits, and hyphens, end with a lowercase letter or digit, and be at most 63 characters long (e.g. sales-agent).

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

    Example agent_config:

    {
      "displayName": "My Support Agent",
      "description": "An agent that analyzes support tickets.",
      "dataAnalyticsAgent": {
        "publishedContext": {
          "datasourceReferences": {
            "bq": {
              "tableReferences": [
                {
                  "projectId": "my-project",
                  "datasetId": "support_data",
                  "tableId": "tickets"
                }
              ]
            }
          },
          "systemInstruction": "You are a helpful assistant."
        }
      }
    }
    

Example

kind: tool
name: create_agent
type: conversational-analytics-create-data-agent
source: my-conversational-analytics-source
location: global
description: |
  Use this tool to create a new data agent with the specified configuration.

Output Format

The tool returns the newly created DataAgent object after waiting for the operation to complete successfully. Note that the tool will block and poll for up to 60 seconds. A timeout error does not necessarily mean the creation failed; the operation may still be processing in the background.

Reference

fieldtyperequireddescription
typestringtrueMust be “conversational-analytics-create-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)