En este documento, se describe cómo crear un agente de datos en AlloyDB Studio para PostgreSQL con un archivo de contexto del agente. Un agente de datos se asocia con un solo archivo de contexto del agente.
Para obtener más información sobre los agentes de datos, consulta Descripción general de los agentes de datos.Antes de comenzar
Completa los siguientes requisitos previos antes de crear un agente.
Habilita los servicios obligatorios
Habilita los siguientes servicios para tu proyecto:
Prepara un clúster y una instancia de AlloyDB para PostgreSQL
- Asegúrate de tener acceso a un clúster y una instancia existentes de AlloyDB, o crea uno nuevo.
- Propaga la base de datos con los datos y el esquema a los que el usuario final desea acceder.
Roles y permisos requeridos
- Agrega un usuario o una cuenta de servicio de Identity and Access Management (IAM) al clúster a nivel de la base de datos. Para obtener más información, consulta Administra usuarios de bases de datos.
- Otorga el rol
alloydb.databaseUseral usuario de IAM a nivel del proyecto. Para obtener más información, consulta Cómo agregar una vinculación de política de IAM para un proyecto.
Crea un agente de datos
Para crear un agente de datos, sigue estos pasos:
En la consola de Google Cloud , ve a la página de AlloyDB.
Selecciona un clúster de la lista.
En el menú de navegación, haz clic en AlloyDB Studio.
Accede a Studio con la autenticación de Identity and Access Management (IAM).
En el panel Explorador, junto a Agentes de datos, haz clic en Ver acciones.
Haz clic en Create agent.
En Nombre del agente, proporciona un nombre único para el agente. El nombre del agente distingue mayúsculas de minúsculas y puede contener letras, números, guiones y guiones bajos.
Es opcional. En Descripción del agente, agrega una descripción para tu agente.
Es opcional. Haz clic en Mostrar opciones avanzadas y, en Selecciona una ubicación, elige una región para almacenar el contexto del agente.
Haz clic en Crear.
Crea el contexto del agente
Después de crear un agente, sigue los pasos que se indican en Cómo compilar contextos con la CLI de Gemini para crear un archivo de contexto del agente. Luego, puedes editar tu agente para subir el archivo de contexto.
Cómo editar un agente
Para editar un agente de datos, sigue estos pasos:
En la consola de Google Cloud , ve a la página de AlloyDB.
Selecciona un clúster de la lista.
En el menú de navegación, haz clic en AlloyDB Studio.
Accede a Studio con la autenticación de Identity and Access Management (IAM).
En el panel Explorador, junto a Agentes de datos, haz clic en Ver acciones.
Haz clic en Editar agente.
Opcional: Edita la Descripción del agente.
Haz clic en Examinar en la sección Subir archivo de contexto del agente y selecciona el archivo de contexto del agente.
Haz clic en Guardar.
Borra un agente de datos
Para borrar un agente de datos, sigue estos pasos:
En la consola de Google Cloud , ve a la página de AlloyDB.
Selecciona un clúster de la lista.
En el menú de navegación, haz clic en AlloyDB Studio.
Accede a Studio con la autenticación de Identity and Access Management (IAM).
En el panel Explorador, junto a Agentes de datos, haz clic en Ver acciones.
Haz clic en Borrar agente.
En el diálogo de confirmación Borrar agente, ingresa el nombre del agente.
Haz clic en Confirmar para borrar el agente.
¿Qué sigue?
- Obtén más información sobre los agentes de datos.
- Obtén más información para inspeccionar y llamar a un agente de datos.