Analiza datos con conversaciones

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En este documento, se describe cómo crear, editar y borrar conversaciones en Cloud SQL para PostgreSQL. Las conversaciones son chats persistentes con un agente de datos.

Puedes hacerles preguntas de varias partes a los agentes de datos que usen términos comunes, por ejemplo, "ventas" o "más popular", sin especificar los nombres de los campos de la tabla ni definir condiciones para filtrar los datos. La respuesta del chat proporciona la respuesta a tu pregunta como texto y código, y genera gráficos cuando corresponde. La respuesta incluye el razonamiento detrás de los resultados.

Puedes crear una conversación con un agente de datos. Cuando creas una conversación directa, la API de Conversational Analytics interpreta tu pregunta sin el contexto ni las instrucciones de procesamiento que ofrece un agente de datos.

Antes de comenzar

1. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

2. Habilita las APIs de Cloud SQL, Data Analytics con Gemini y Gemini para Google Cloud , si aún no están habilitadas.

   Roles necesarios para habilitar las APIs

   Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

   Habilitar las API

Roles obligatorios

Para trabajar con agentes de datos, debes tener permisos de IAM que coincidan con tu caso de uso. En la siguiente tabla, se enumeran los roles necesarios según si creas y publicas agentes, aprovisionas agentes en Gemini Enterprise o descubres y usas agentes. Para obtener más información, consulta Roles de IAM de la API de Conversational Analytics.

Caso de uso	Roles obligatorios
Crear, editar, publicar, compartir y borrar agentes	Para crear agentes de datos en un proyecto: Creador de agentes de datos de Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator) en el proyecto. Este rol te otorga automáticamente el rol de propietario de agentes de datos de Gemini Data Analytics en los agentes de datos que crees. Para editar, compartir o borrar un agente de datos: Propietario de agentes de análisis de datos de Gemini (roles/geminidataanalytics.dataAgentOwner) en el agente o proyecto. Para editar un agente de datos en un proyecto: Editor de agentes de datos de Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor) en el proyecto. Para ver los agentes de datos en un proyecto, se necesita el rol de visualizador de agentes de datos de Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer) en el proyecto. Además, debes tener los siguientes roles para crear o editar un agente de datos: Un usuario o una cuenta de servicio de IAM agregados a la instancia. Para obtener más información, consulta Administra usuarios con la autenticación de la base de datos de IAM para Cloud SQL. Los roles cloudsql.studioUser y cloudsql.instanceUser otorgados al usuario de IAM a nivel del proyecto. Para obtener más información, consulta Agrega una vinculación de política de IAM para un proyecto. Opcional: Si usas conjuntos de contexto (versión preliminar) con tu agente de datos de la base de datos, para crear, subir y administrar conjuntos de contexto, se debe otorgar el rol de editor de Dataplex Catalog (roles/dataplex.catalogEditor) o de administrador de Dataplex Catalog (roles/dataplex.catalogAdmin) al usuario de IAM a nivel del proyecto. Para obtener más información, consulta El contexto establece permisos. Privilegios de base de datos otorgados a un usuario o una cuenta de servicio de IAM cuando se accede como el usuario postgres. GRANT ALL ON SCHEMA public TO public; Para obtener más información, consulta Otorga privilegios de base de datos a un usuario o una cuenta de servicio de IAM individuales.
Aprovisiona agentes en Gemini Enterprise	Para que un agente publicado esté disponible para los usuarios de Gemini Enterprise, necesitas permisos para registrar y administrar agentes A2A en la Consola del administrador de Gemini Enterprise.
Descubre y usa agentes	Para chatear con agentes de datos: Usuario de agente de datos de Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser). Para ver todos los agentes de datos del proyecto: Visualizador de agentes de datos de Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer).

Cuando administres el acceso a los recursos de la base de datos de Cloud SQL para PostgreSQL, ten en cuenta las siguientes capas de permisos:

• Google Cloud IAM: Controla el acceso a la instancia de la base de datos como un recurso de la nube. Esto incluye permisos para conectarse, administrar la instancia y ejecutar consultas en SQL, por ejemplo, con el permiso executeSql.
• Permisos de la base de datos: Controlan el acceso a los objetos de la base de datos, como tablas, vistas y esquemas. Estos se administran con comandos de SQL, como GRANT, y sistemas de usuarios y roles específicos de la base de datos.

En el caso de Cloud SQL para PostgreSQL, necesitas los roles de IAM de Cloud SQL adecuados para conectarte a la instancia y tener autorización para enviar consultas. Para interactuar con objetos como tablas y vistas, el usuario de la base de datos que se conecta debe tener los privilegios necesarios otorgados con el sistema GRANT de Cloud SQL para PostgreSQL. Para obtener más información, consulta Acerca de los usuarios y los roles de PostgreSQL. Si el agente usa una cuenta de servicio, puedes obtener un rol de base de datos asignado. Por ejemplo, consulta Administra usuarios con la autenticación de la base de datos de IAM.

Crear conversaciones

Puedes crear conversaciones persistentes con un agente o con una fuente de datos en la consola de Google Cloud para Cloud SQL para PostgreSQL desde la pestaña Catálogo de agentes en la página Conversaciones.

Crea una conversación con un agente de datos

Para crear una conversación con un agente de datos, primero debes crear un agente de datos y publicarlo. También puedes iniciar una conversación con los agentes que otras personas compartan contigo.

Para crear una conversación con un agente de datos en la consola de Google Cloud , sigue estos pasos:

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

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Conversaciones.

4. En la sección Mis agentes o Compartido por otras personas de tu organización, haz clic en la tarjeta del agente con el que quieres chatear.

5. Haz clic en Iniciar una conversación. Se abrirá un nuevo panel de chat.

6. En el campo Haz una pregunta, ingresa una pregunta para el agente de datos. Por ejemplo, "¿Cuáles fueron nuestras ventas totales el trimestre pasado?" o "Muéstrame los 5 usuarios principales por tiempo de sesión". También puedes hacer clic en una de las preguntas sugeridas por Gemini para comenzar.

   El agente de datos responde indicando la acción que está realizando para abordar tu pregunta y, luego, devuelve los resultados.

   Para ver cada paso que realiza el agente de datos para proporcionar la respuesta a tu pregunta, haz clic en Mostrar razonamiento para ver cada mensaje en el proceso de razonamiento del agente.

   Para ver información sobre cómo se calcularon los resultados, haz clic en ¿Cómo se calculó? La sección Resumen ahora incluye una consulta generada seguida del resultado de la consulta. Puedes copiar el código y, luego, hacer clic en Studio para pegarlo en el editor de consultas.

   Cuando es apropiado para los datos, el agente de datos proporciona gráficos, tablas y otras visualizaciones. Para ver tu historial de chats, ve a la lista Administración de conversaciones.

   Para ver la información del agente, ve al panel Detalles. Este panel incluye una descripción del agente y sus fuentes de conocimiento.

Administración de conversaciones

Puedes abrir, cambiar el nombre o borrar una conversación en la página Conversaciones.

Abre una conversación existente.

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

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Conversaciones.

4. En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación que quieras abrir.

Cómo cambiar el nombre de una conversación

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

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Conversaciones.

4. En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación a la que quieres cambiarle el nombre.

5. Haz clic en Ver acciones > Cambiar nombre.

6. En el cuadro de diálogo Cambiar nombre de la conversación, ingresa un nombre nuevo para la conversación en el campo Nombre de la conversación.

7. Haga clic en Cambiar nombre.

Borrar una conversación

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

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Conversaciones.

4. En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación que deseas borrar.

5. Haz clic en Ver acciones > Borrar.

6. En el cuadro de diálogo ¿Quieres borrar la conversación?, haz clic en Borrar.

Ubicaciones

Las estadísticas de conversaciones operan de forma global; no puedes elegir qué región usar.

¿Qué sigue?

• Obtén más información sobre las estadísticas conversacionales en Cloud SQL para PostgreSQL.
• Obtén más información sobre la API de Conversational Analytics.
• Crea un agente de datos en Cloud SQL para PostgreSQL.