Analiza datos con conversaciones

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 a los agentes de datos preguntas de varias partes que usen términos comunes, por ejemplo, "ventas" o "más populares", sin especificar nombres de campos de 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 y las instrucciones de procesamiento que ofrece un agente de datos.

Antes de comenzar

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

  2. Habilita Cloud SQL, la API de Data Analytics with Gemini y Gemini para Google Cloud APIs.

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

    Habilitar las API

Roles obligatorios

Para trabajar con agentes de datos, debes tener uno de los siguientes roles de Identity and Access Management (IAM) de la API de Conversational Analytics:

  • Consultar datos de fuentes de datos compatibles con el método QueryData: Usuario de datos de consulta de Gemini Data Analytics (roles/geminidataanalytics.queryDataUser) a nivel del proyecto
  • Crear, editar, compartir y borrar todos los agentes de datos del proyecto: Propietario del agente de datos de análisis de datos de Gemini (roles/geminidataanalytics.dataAgentOwner) a nivel del proyecto
  • Crear tus propios agentes de datos en el proyecto: Creador de agentes de análisis de datos de Gemini (roles/geminidataanalytics.dataAgentCreator) a nivel del proyecto Este rol te otorga automáticamente el rol Propietario del agente de datos de análisis de datos de Gemini en los agentes de datos que crees.
  • Ver y editar todos los agentes de datos del proyecto: Editor de agentes de análisis de datos de Gemini (roles/geminidataanalytics.dataAgentEditor) a nivel del proyecto
  • Ver todos los agentes de datos del proyecto: Visualizador de agentes de análisis de datos de Gemini (roles/geminidataanalytics.dataAgentViewer) a nivel del proyecto

Además, debes tener los siguientes roles para crear o editar un agente de datos:

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

  • Google Cloud IAM: Controla el acceso a la instancia de base de datos como un recurso de la nube. Esto incluye permisos para conectarse, administrar la instancia y ejecutar consultas de SQL, por ejemplo, con el permiso executeSql.
  • Permisos de base de datos: Controlan el acceso a objetos en 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 Información sobre 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 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 Google Cloud consola de Cloud SQL para PostgreSQL desde la pestaña Catálogo de agentes en la página Agentes.

Crear una conversación con un agente de datos

Para crear una conversación con un agente de datos, primero crea un agente de datos y publícalo. También puedes iniciar una conversación con los agentes que otros compartan contigo.

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

  1. En la Google Cloud consola, 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 Agentes.

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

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

  6. En el campo Haz una pregunta, ingresa una pregunta para el agente de datos. Por ejemplo, "¿Cuáles fueron nuestras ventas totales el último trimestre?" 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 responder tu pregunta y, luego, muestra 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ó esto? 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 corresponde a los datos, el agente de datos proporciona gráficos, tablas y otras visualizaciones. Para ver tu historial de chat, 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 Agentes.

Abrir una conversación existente

  1. En la Google Cloud consola, 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 Agentes.

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

Cambiar el nombre de una conversación

  1. En la Google Cloud consola, 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 Agentes.

  4. En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación cuyo nombre deseas cambiar.

  5. Haz clic en Ver acciones > Cambiar nombre.

  6. En el diálogo Cambiar el 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 Google Cloud consola, 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 Agentes.

  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 diálogo ¿Borrar conversación?, haz clic en Borrar.

Ubicaciones

El análisis conversacional opera de forma global; no puedes elegir qué región usar.

¿Qué sigue?