Gestionar agentes de datos en Cloud SQL Studio para MySQL

En este documento se describe cómo crear un agente de datos en Cloud SQL para MySQL Studio mediante un archivo de contexto de agente. Un agente de datos está asociado a un único archivo de contexto de agente.

Para obtener información sobre los agentes de datos, consulta el artículo Descripción general de los agentes de datos.

Antes de empezar

Completa los siguientes requisitos previos antes de crear un agente.

Habilitar los servicios necesarios

Habilita los siguientes servicios en tu proyecto:

Preparar una instancia de Cloud SQL

  • Asegúrate de que tienes acceso a una instancia de Cloud SQL o crea una. Para obtener más información, consulta Crear instancias para Cloud SQL.
  • Rellena la base de datos con los datos y el esquema a los que quiera acceder el usuario final.

Roles y permisos necesarios

Conceder permiso executesql a la instancia de Cloud SQL

Para conceder el permiso executesql a la instancia de Cloud SQL y habilitar la API Data de Cloud SQL, ejecuta el siguiente comando: 
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
Sustituye INSTANCE_ID por el ID de tu instancia de Cloud SQL.

Crear un agente de datos

Para crear un agente de datos, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página de Cloud SQL.

    Ir a Cloud SQL

  2. Selecciona una instancia de la lista.

  3. En el menú de navegación, haz clic en Cloud SQL Studio.

  4. Inicia sesión en Studio mediante la autenticación de gestión de identidades y accesos (IAM).

  5. En el panel Explorador, junto a Agentes de datos, haga clic en Ver acciones.

  6. Haz clic en Crear agente.

  7. En Nombre del agente, indica un nombre único para el agente. El nombre del agente distingue entre mayúsculas y minúsculas, y puede contener letras, números, guiones y guiones bajos.

  8. Opcional. En Descripción del agente, añade una descripción del agente.

  9. Opcional. Haga clic en Mostrar opciones avanzadas y, en Seleccionar una ubicación, elija una región para almacenar el contexto del agente. Puedes seleccionar una de las siguientes regiones admitidas:

    • us-central1
    • us‑east1
    • europe‑west4
    • asia‑southeast1

  10. Haz clic en Crear.

Crear contexto de agente

Después de crear un agente, sigue los pasos que se indican en Crear contextos con la CLI de Gemini para crear un archivo de contexto del agente. Después, puedes editar tu agente para subir el archivo de contexto.

Editar un agente

Para editar un agente de datos, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página de Cloud SQL.

    Ir a Cloud SQL

  2. Selecciona una instancia de la lista.

  3. En el menú de navegación, haz clic en Cloud SQL Studio.

  4. Inicia sesión en Studio mediante la autenticación de gestión de identidades y accesos (IAM).

  5. En el panel Explorador, junto a Agentes de datos, haga clic en Ver acciones.

  6. Haz clic en Editar agente.

  7. Opcional: Edita la descripción del agente.

  8. En la sección Subir archivo de contexto del agente, haz clic en Examinar y selecciona el archivo de contexto del agente.

  9. Haz clic en Guardar.

Eliminar un agente de datos

Para eliminar un agente de datos, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página de Cloud SQL.

    Ir a Cloud SQL

  2. Selecciona una instancia de la lista.

  3. En el menú de navegación, haz clic en Cloud SQL Studio.

  4. Inicia sesión en Studio mediante la autenticación de gestión de identidades y accesos (IAM).

  5. En el panel Explorador, junto a Agentes de datos, haga clic en Ver acciones.

  6. Haz clic en Eliminar agente.

  7. En el cuadro de diálogo de confirmación Eliminar agente, introduce el nombre del agente.

  8. Haz clic en Confirmar para eliminar el agente.

Siguientes pasos