Gestionar agentes de datos en Cloud SQL para PostgreSQL Studio

MySQL   |  PostgreSQL   |  SQL Server

Vista previa — Data agents

Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Serviciosy a los Términos Adicionales para Productos de IA Generativa en Versión Preliminar. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Para saber cómo conseguir acceso a esta versión, visita la página de solicitud de acceso.

En este documento se describe cómo crear un agente de datos en Cloud SQL para PostgreSQL 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:

• API Data Analytics de Gemini
• API de Gemini para Google Cloud

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

• Añade un usuario de IAM o una cuenta de servicio a la instancia. Para obtener más información, consulta Gestionar usuarios con la autenticación de bases de datos de gestión de identidades y accesos de Cloud SQL.
• Concede los roles cloudsql.studioUser y cloudsql.instanceUser al usuario de IAM a nivel de proyecto. Para obtener más información, consulta Añadir una vinculación de política de gestión de identidades y accesos a un proyecto.
También debes conceder privilegios de base de datos a un usuario de IAM o a una cuenta de servicio. Para obtener más información, consulta [Conceder privilegios de base de datos a un usuario o una cuenta de servicio de IAM](/sql/docs/postgres/add-manage-iam-users#grant-db-privileges).También debes conceder privilegios de base de datos a un usuario o una cuenta de servicio de IAM. Para obtener más información, consulta Conceder privilegios de base de datos a un usuario o una cuenta de servicio de IAM concretos.

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.

Nota: Crear el primer agente de un proyecto puede tardar varios minutos.

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.

Nota: Antes de eliminar una base de datos, debes eliminar todos los agentes asociados a ella.

Siguientes pasos

• Más información sobre los agentes de datos
• Consulta cómo inspeccionar y llamar a un agente de datos.