En este documento, se describe cómo crear, editar y borrar conversaciones en Spanner. 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 ni las instrucciones de procesamiento que ofrece un agente de datos.
Antes de comenzar
-
Verifica que la facturación esté habilitada para tu Google Cloud proyecto.
-
Habilita las APIs de Spanner, Data Analytics with Gemini y Gemini for Google Cloud .
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 Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.
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 obligatorios según si creas y publicas agentes, aprovisionas agentes en Gemini Enterprise o descubres y usas agentes. Para obtener más información, consulta los roles de Identity and Access Management de la API de Conversational Analytics.
| Caso de uso | Roles obligatorios |
|---|---|
| Crear, editar, publicar, compartir y borrar agentes |
|
| Aprovisionar 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. |
| Descubrir y usar agentes |
|
Para trabajar con recursos de Spanner, consulta Roles y permisos de Spanner.
Crear conversaciones
Puedes crear conversaciones persistentes con un agente o con una fuente de datos en la Google Cloud consola de Spanner desde la pestaña Catálogo de agentes en la página Agentes.
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 otros compartan contigo.
Para crear una conversación con un agente de datos en la Google Cloud consola, sigue estos pasos:
En la Google Cloud consola de, ve a la página Spanner.
Selecciona una instancia de la lista y, luego, selecciona una base de datos.
En el menú de navegación, haz clic en Agentes.
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.
Haz clic en Iniciar una conversación. Se abrirá un panel de chat nuevo.
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.
Abre una conversación existente
En la Google Cloud consola de, ve a la página Spanner.
Selecciona una instancia de la lista y, luego, selecciona una base de datos.
En el menú de navegación, haz clic en Agentes.
En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación que deseas abrir.
Cambia el nombre de una conversación
En la Google Cloud consola de, ve a la página Spanner.
Selecciona una instancia de la lista y, luego, selecciona una base de datos.
En el menú de navegación, haz clic en Agentes.
En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación a la que deseas cambiarle el nombre.
Haz clic en Ver acciones > Cambiar nombre.
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.
Haga clic en Cambiar nombre.
Borrar una conversación
En la Google Cloud consola de, ve a la página Spanner.
Selecciona una instancia de la lista y, luego, selecciona una base de datos.
En el menú de navegación, haz clic en Agentes.
En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación que deseas borrar.
Haz clic en Ver acciones > Borrar.
En el diálogo ¿Borrar conversación?, haz clic en Borrar.
Ubicaciones
Conversational Analytics opera a nivel global; no puedes elegir qué región usar.
¿Qué sigue?
- Obtén más información sobre Conversational Analytics en Spanner.
- Obtén más información sobre la API de Conversational Analytics.
- Crea un agente de datos en Spanner.