Agentes de diseño en Agent Studio

Vista previa

La función de agentes de diseño en Agent Studio está sujeta a las "Condiciones de la Oferta de la Fase 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 "tal como están" y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Relación con otras condiciones. La función de agentes de diseño en Agent Studio ayuda a los clientes a diseñar "agentes de IA" según se define en las Condiciones Específicas del Servicio y, por lo tanto, se aplican las Condiciones Específicas del Servicio de "Servicios de IA de Agentes". Cuando se usa la Búsqueda de Google como herramienta en Agent Studio, también se aplica la sección titulada "Fundamentación con la Búsqueda de Google" en las Condiciones Específicas del Servicio, excepto que la primera referencia a "Gemini Enterprise o Agentspace" en la subsección (iv) de la sección "Servicios de IA de Agentes" se reemplaza por "Plataforma de Agentes de Gemini Enterprise". Asegúrate de revisar las condiciones de cualquier otra herramienta que se use en Agent Studio y verifica que tu agente sea adecuado para la implementación en Agent Runtime antes de usar esa función.

En esta página, se proporciona una descripción general de cómo usar Agent Studio en la Google Cloud consola.

Agent Studio es un diseñador visual de poco código dentro de la Google Cloud consola que simplifica el desarrollo de agentes. Puedes asignar visualmente flujos de trabajo de agentes, probar respuestas en tiempo real y experimentar con diferentes configuraciones antes de implementar o pasar al código.

En este documento, se proporciona una descripción general de Agent Studio y se explica cómo configurar tu entorno, crear y probar agentes, y, luego, implementarlos directamente en un entorno de ejecución de producción.

Configura tu entorno

Antes de usar Agent Studio, configura Google Cloud.

Obtén los roles necesarios

Para obtener los permisos que necesitas para usar Agent Studio, pídele a tu administrador que te otorgue el rol de IAM de usuario de Agent Platform (roles/aiplatform.user) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Crea un agente

Nota: Todos los archivos de configuración de los agentes creados se almacenan en la región us-west1. Si tu organización tiene políticas que te impiden usar esta región, es posible que no puedas crear un agente. Para obtener más información, consulta Restringe las ubicaciones de recursos.

Sigue estos pasos para diseñar y probar un agente en Agent Studio:

1. En la Google Cloud consola, ve a la página Agentes.
   

   Ir a Agentes

2. Haz clic en Crear agente para abrir el lienzo de Agent Studio para un agente nuevo.

3. Diseña y guarda tu agente en el lienzo de Agent Studio. Puedes cambiar entre las siguientes pestañas:

   • Flujo: Crea el agente principal y los agentes secundarios con una representación visual del flujo de trabajo y la lógica de control de tu agente.

     1. Haz clic en un agente para abrir el panel Detalles de ese agente. También puedes hacer clic en Agregar un agente secundario (+) para agregar agentes secundarios.

     2. Configura tu agente principal y los agentes secundarios en el panel Detalles:

        1. Nombre: Agrega un nombre para ayudar a identificar el agente.

        2. Descripción: Un resumen del propósito de tu agente.

        3. Instrucciones: Agrega instrucciones para guiar a tu agente.

        4. Modelo: Selecciona el modelo para potenciar tu agente.

        5. Herramientas: Haz clic en Agregar herramientas (+) para agregar herramientas que permitan que el agente complete tareas. Para obtener más información, consulta Configura y agrega herramientas.

     3. Para guardar tu agente, haz clic en Guardar en el encabezado del lienzo y sigue las indicaciones. Para obtener más información, consulta Guarda un agente.

   • Pestaña Vista previa: Chatea con tu agente en el panel de vista previa para probar sus capacidades y respuestas.

4. Haz clic en Obtener código para ver el código de tu agente. Si deseas continuar desarrollando tu agente en otro lugar, puedes copiar el código y pegarlo en un editor de código de tu elección.

Cuando tu agente esté completo, puedes implementarlo directamente desde Agent Studio. Para obtener más información, consulta Implementa un agente desde Agent Studio.

Guarda un agente

Debes guardar un agente antes de obtener una vista previa o implementarlo, ya que un agente no guardado aún no tiene una identidad. Para guardar un agente por primera vez, haz lo siguiente:

1. En el lienzo de Agent Studio, haz clic en Guardar.

2. En el cuadro de diálogo Guardar agente, ingresa un nombre del agente.

3. Haz clic en Guardar.

Después de la primera vez que lo guardes, Agent Studio guardará automáticamente los cambios adicionales que realices. Si intentas salir del lienzo antes de guardar un agente nuevo, Agent Studio te pedirá que lo guardes primero.

Configura y agrega herramientas en Agent Studio

Puedes configurar las siguientes herramientas para tu agente:

• Búsqueda de Google: Permite que el agente realice búsquedas web con la Búsqueda de Google. Está activada de forma predeterminada.

• Contexto de URL: Permite que el modelo analice las URLs de las instrucciones enviadas al agente. Está activada de forma predeterminada.

• Almacén de datos de Agent Search: Haz clic en Agregar (+) para permitir que tu agente acceda a la información que se indexó en tu almacén de datos de Agent Search.

  • Número de proyecto: Es el Google Cloud número de proyecto asociado con tu almacén de datos de Agent Search. Consulta tu número de proyecto.

  • Ubicación: Es la ubicación de tu almacén de datos.

  • ID del almacén de datos: Es el ID de Firestore en modo Datastore (Datastore) de los datos que se incluirán. Consulta una lista de tus almacenes de datos y sus IDs.

  • ID de la colección: Es el ID de la colección de los datos que se incluirán. Consulta una lista de tus almacenes de datos y los IDs de las colecciones. Si tu almacén de datos no tiene un ID de colección, ingresa default_collection.

  Si no tienes un almacén de datos existente, consulta Comienza a usar la búsqueda personalizada para crear uno. Luego, otorga acceso a la cuenta de servicio a Agent Search:

  1. En la Google Cloud consola, ve a la páginaIAM.
     

     Ir a Identity and Access Management (IAM)

  2. Haz clic en Otorgar acceso.

  3. En el campo Principales nuevas, ingresa la siguiente información de la cuenta de servicio:

     [e-mail].

  4. Selecciona + Agregar roles. Busca y selecciona Usuario de Discovery Engine. Haz clic en Aplicar y, luego, en Guardar.

• Servidor de MCP: Conecta un servidor de Protocolo de contexto del modelo (MCP) directamente.

  1. Para agregar herramientas de MCP conectándote a un servidor de MCP, haz clic en Agregar (+) junto a Servidor de MCP.
  2. Nombre visible de MCP: Ingresa un nombre para tu servidor de MCP.
  3. URL de extremo: Ingresa una URL de extremo para el servidor de MCP.
  4. Autenticación: Se completa automáticamente como Ninguna. Agent Studio solo admite servidores de MCP que no requieren autenticación.

  Tu agente puede usar todas las herramientas de tu servidor de MCP conectado.

Implementa un agente desde Agent Studio

Después de crear y obtener una vista previa de un agente, puedes implementarlo en producción. Sigue estos pasos para implementar un agente desde Agent Studio:

1. En la página de la lista Agentes, haz clic en el agente que deseas implementar. Aparecerá la página de detalles del agente seleccionado.
2. Haz clic en Implementar para abrir el cuadro de diálogo Implementar en una instancia de Agent Runtime.

3. (Opcional) Edita el Nombre visible o la Descripción de tu agente.

4. Selecciona una región de implementación de la lista de regiones disponibles y, luego, haz clic en Aceptar.

5. Haz clic en Implementar.

Deployment crea una nueva instancia de entorno de ejecución y puede tardar hasta cinco minutos en completarse. Si la operación se realiza de forma correcta, aparecerá un mensaje en la pestaña Flujo del lienzo de Agent Studio. Tu agente ahora está disponible en producción y se puede integrar de forma segura con tus apps externas.

Visualiza un agente implementado

Para ver tu agente implementado, haz lo siguiente:

1. En la Google Cloud consola, ve a la página Implementaciones de Agent Platform.
   

   Ir a Implementaciones

2. Usa la lista Región para filtrar por región de implementación.

3. Los agentes implementados que forman parte del proyecto seleccionado aparecen en la lista.

4. Haz clic en el nombre del agente especificado. Se abrirá la página Métricas del agente.

5. Selecciona la pestaña Playground para probar tu agente.

6. Ingresa una consulta de prueba en el panel de chat para verificar que el agente se ejecute correctamente.

Para obtener más información sobre las métricas disponibles para tu agente, consulta Visualiza las métricas de tu agente implementado.