En este documento se describe cómo crear un agente de datos en Spanner 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 Spanner
- Asegúrate de que haya una instancia de Spanner disponible. Para obtener más información, consulta Crear una instancia.
- 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 gestión de identidades y accesos o una cuenta de servicio al clúster. Para obtener más información, consulta Aplicar roles de gestión de identidades y accesos.
- Asigna los roles
spanner.databaseReaderal 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. - Concede roles y permisos al usuario de gestión de identidades y accesos a nivel de proyecto para las bases de datos necesarias.
Crear un agente de datos
Para crear un agente de datos, sigue estos pasos:
En la Google Cloud consola, ve a la página de Spanner.
Selecciona una instancia de la lista y, a continuación, una base de datos.
En el menú de navegación, haz clic en Spanner Studio.
En el panel Explorador, junto a Agentes de datos, haga clic en Ver acciones.
Haz clic en Crear agente.
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.
Opcional. En Descripción del agente, añade una descripción del agente.
Opcional. Haga clic en Mostrar opciones avanzadas y, en Seleccionar una ubicación, elija una región para almacenar el contexto del agente.
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:
En la Google Cloud consola, ve a la página de Spanner.
Selecciona una instancia de la lista y, a continuación, una base de datos.
En el menú de navegación, haz clic en Spanner Studio.
En el panel Explorador, junto a Agentes de datos, haga clic en Ver acciones.
Haz clic en Editar agente.
Opcional: Edita la descripción del agente.
En la sección Subir archivo de contexto del agente, haz clic en Examinar y selecciona el archivo de contexto del agente.
Haz clic en Guardar.
Eliminar un agente de datos
Para eliminar un agente de datos, sigue estos pasos:
En la Google Cloud consola, ve a la página de Spanner.
Selecciona una instancia de la lista y, a continuación, una base de datos.
En el menú de navegación, haz clic en Spanner Studio.
En el panel Explorador, junto a Agentes de datos, haga clic en Ver acciones.
Haz clic en Eliminar agente.
En el cuadro de diálogo de confirmación Eliminar agente, introduce el nombre del agente.
Haz clic en Confirmar para eliminar el agente.
Siguientes pasos
- Más información sobre los agentes de datos
- Consulta cómo inspeccionar y llamar a un agente de datos.