Guía de inicio rápido: Envía instrucciones de texto a Gemini con Agent Studio

Puedes usar Agent Studio para diseñar, probar y administrar instrucciones para los modelos de lenguaje grande (LLM) Gemini de Google y los modelos abiertos y de socios. Agent Studio admite ciertos modelos de socios y abiertos que se ofrecen en Agent Platform como modelos como servicio (MaaS), como los modelos Claude de Anthropic y Llama de Meta.

En esta guía de inicio rápido, puedes hacer lo siguiente:

  • Envía estas instrucciones a la API de Agent Platform con ejemplos de la galería de instrucciones de IA generativa, incluidas las siguientes:
    • Una instrucción de texto de resumen
    • Una instrucción de generación de código
  • Ver el código que se usó para generar las respuestas

Instrucciones de ejemplo en Agent Studio

Una instrucción es una solicitud en lenguaje natural que se envía a un modelo de lenguaje que genera una respuesta. Las instrucciones pueden contener preguntas, información contextual, algunos ejemplos, y entradas parciales para que el modelo las complete. Según el tipo de modelo que se use, cuando el modelo reciba una instrucción, podrá generar texto, embeddings, código, imágenes, videos, música y mucho más.

Las instrucciones de muestra en la Galería de instrucciones de Agent Studio están prediseñadas para ayudar a demostrar las capacidades del modelo. Cada instrucción tiene preconfigurado un modelo y valores de parámetros especificados, de modo que puedes abrir la instrucción de muestra y hacer clic en Enviar para generar una respuesta.

Prueba el modelo de Gemini con una instrucción de texto de resumen

Enviar una instrucción de texto de resumen a la API de Agent Platform En una tarea de resumen, se extrae la información más importante de un texto. Puedes proporcionar información en la instrucción para ayudar al modelo a crear un resumen o pedirle que cree un resumen por sí solo.

  1. Ve a la página Galería de instrucciones desde la sección Agent Platform en la consola de Google Cloud .
    Ir a la galería de instrucciones

  2. En el menú desplegable Tareas, selecciona Resumir.

  3. Abre la tarjeta Resumen de audio.

    Esta instrucción de ejemplo incluye un archivo de audio y solicita un resumen del contenido del archivo en una lista con viñetas.

  4. Observa que, en el panel de configuración, el valor predeterminado del modelo se establece en gemini-3.7-flash. Puedes elegir un modelo de Gemini diferente en el panel Configuración del modelo.

  5. Haz clic en Enviar para generar el resumen.

    El resultado se muestra en la respuesta.

  6. Para ver el código de Gemini Enterprise Agent Platform que se usó para generar el resumen de la transcripción, haz clic en Código.

    En el panel Obtener código, puedes elegir el lenguaje que prefieras para obtener el código de muestra de la instrucción, o bien puedes abrir el código de Python en un notebook de Colab Enterprise.

Prueba el modelo de Gemini con una instrucción de generación de código

Enviar una instrucción de generación de código a la API de Agent Platform Una tarea de generación de código genera código a través de una descripción en lenguaje natural.

  1. Ve a la página Galería de instrucciones desde la sección Agent Platform en la consola de Google Cloud .
    Ir a la galería de instrucciones

  2. En el menú desplegable Tareas, selecciona Código.

  3. Abre la tarjeta Genera código a partir de comentarios.

    Esta instrucción de ejemplo incluye una instrucción del sistema que le indica al modelo cómo responder y algunos métodos de Java incompletos.

  4. Observa que, en el panel de configuración, el valor predeterminado del modelo se establece en gemini-3.7-flash. Puedes elegir un modelo de Gemini diferente en el panel Configuración del modelo.

  5. Para completar cada método generando código en las áreas marcadas como <WRITE CODE HERE>, haz clic en Enviar .

    El resultado se muestra en la respuesta.

  6. Para ver el código de Gemini Enterprise Agent Platform que se usó para generar el código, haz clic en Código.

    En el panel Obtener código, puedes elegir el lenguaje que prefieras para obtener el código de muestra de la instrucción, o bien puedes abrir el código de Python en un notebook de Colab Enterprise.

Detección automática de intenciones en el espacio de trabajo de instrucciones

Cuando chateas o pruebas instrucciones en Agent Studio, la detección de intents en segundo plano evalúa automáticamente cada mensaje enviado para identificar si tu intención es compilar un agente autónomo o una aplicación. Si se detecta un intent, aparece un banner contextual con una acción de un clic para transferir tu solicitud al compilador adecuado.

Cómo funciona la detección de intents

Cada vez que envías un mensaje en el espacio de trabajo de instrucciones de chat, una evaluación en segundo plano procesa tu entrada:

  • Se detectó la intención de crear un agente: Aparece un banner con la acción Crear agente.

    • Si el motor de detección tiene suficiente contexto para determinar qué tipo de agente deseas compilar, te dirige a Agent Designer y envía automáticamente tu instrucción inicial para comenzar a compilar el agente de inmediato.

    • El lienzo se abre con instrucciones generadas, parámetros de configuración del sistema y herramientas adjuntas previamente listas para seguir editándolas.

  • Se detectó un intent de app: Aparece un banner con la acción Crear app.

    • Cuando se hace clic en el botón de acción, se navega a la interfaz de App Builder.

    • El campo de instrucción se completa previamente con los detalles de tu instrucción si el contexto está disponible.

    • A diferencia del flujo del agente, App Builder nunca envía la compilación automáticamente, sino que se detiene en la página para que puedas revisar y enviar la instrucción de forma manual.

Facturación y precios

Cada evaluación de detección de intents en segundo plano se cobra a tu cuenta de Google Cloud:

  • Modelo usado: La detección de intents se basa en Gemini 3.5 Flash-Lite, un modelo ligero optimizado.

  • Costo: Debido a que el modelo es liviano, el cargo por detección es mínimo. Aproximadamente $0.002 por evaluación de mensaje.

  • Los cargos de inferencia estándar se aplican por separado a tu instrucción y respuesta principales.

Crea un agente con la detección de intents

Para crear un agente a partir de una sesión de chat con la detección automática de intents, sigue estos pasos:

  1. En la consola de Google Cloud ,
    ve a Agent Platform.

  2. En el menú de navegación, haz clic en Studio > + Nuevo > Chat > Nuevo chat.

  3. En el campo de instrucción que se encuentra en la parte inferior del espacio de trabajo, ingresa una instrucción que indique claramente tu intención de compilar un agente, junto con una descripción del propósito y las tareas del agente.

  4. Haz clic en Enviar .

  5. Cuando comience la respuesta, busca el banner de detección de intents que se encuentra sobre el campo de instrucción.

  6. En el banner, haz clic en Crear agente.

  7. En el diálogo de confirmación, haz clic para continuar. Agent Studio abre el lienzo visual en Agent Designer y, luego, inicializa el flujo de tu agente.

  8. En el panel lateral, revisa y establece los parámetros de configuración propagados:

    • Detalles: Edita el nombre y la descripción del agente.

    • Instrucciones: Revisa y ajusta las instrucciones del sistema.

    • Herramientas: Verifica y configura las herramientas adjuntas (como la Búsqueda de Google).

Crea una app con la detección de intents

Para crear una aplicación a partir de una sesión de chat con la detección automática de intents, sigue estos pasos:

  1. En la consola de Google Cloud ,
    ve a Agent Platform.

  2. En el menú de navegación, haz clic en Studio > + Nuevo > Chat > Nuevo chat.

  3. En el campo de instrucción que se encuentra en la parte inferior del espacio de trabajo, ingresa una instrucción que indique claramente tu intención de compilar una aplicación, junto con una descripción de la aplicación.

  4. Haz clic en Enviar .

  5. Cuando aparezca el banner de detección de intents sobre el campo de instrucciones, haz clic en Crear app. Agent Studio abrirá el espacio de trabajo de App Builder con tu instrucción prepropagada en el campo de entrada.

  6. Revisa y edita el texto de la instrucción según sea necesario.

  7. Dentro del campo de instrucción, haz clic en Enviar para iniciar el proceso de compilación de la aplicación.

Inhabilitar la detección de intents

Si quieres evitar las evaluaciones en segundo plano y los cargos por detección por mensaje mientras chateas, haz lo siguiente:

  1. En la consola de Google Cloud ,
    ve a Agent Platform.

  2. En el menú de navegación, haz clic en Studio > + Nuevo > Chat > Nuevo chat.

  3. En el encabezado del espacio de trabajo, haz clic en Configuración (ícono de ajustes).

  4. En el menú de configuración, busca el parámetro Detect build intent.

  5. Haz clic en el interruptor para desactivarlo.

Cuando se inhabilita, no se ejecuta ninguna detección en segundo plano, no aparecen banners de sugerencias y no se cobran tarifas de detección.

¿Qué sigue?

Descripción general

Aprende a crear agentes en Google Agent Platform.

Guía

Obtener información sobre las funciones de Agent Studio

Guía

Sigue la guía para implementar tu instrucción como una aplicación web desde Agent Studio.