Descripción general del Modo de desarrollador de las Apps con Gemini

El modo de desarrollador de las Apps con Gemini es un espacio de trabajo interactivo de depuración y evaluación basado en la Web en el que puedes inspeccionar la ejecución de herramientas en tiempo real, validar esquemas y simular el contexto del usuario antes de enviar tu app conectada para su revisión.

Puedes conectar tu servidor de Protocolo de contexto del modelo (MCP) al modo de desarrollador de dos maneras, según tu flujo de trabajo:

  • A través de Google Connected Console: Si estás incorporando tu servidor de MCP en Google Connected Console, puedes iniciar el modo de desarrollador con tu app registrada ya preseleccionada.
  • Como una app de MCP personalizada: Si quieres crear un prototipo o depurar un extremo de servidor de MCP de HTTPS implementado antes de registrarlo en la consola, puedes conectar tu servidor directamente en Gemini como una app de MCP personalizada.

El modo de desarrollador de las Apps con Gemini te ayuda a completar las siguientes tareas:

  • Inspecciona las cargas útiles de solicitudes y respuestas de JSON-RPC, los códigos de estado HTTP y la latencia de ejecución en tiempo real.
  • Verifica cómo Gemini analiza los esquemas de herramientas de MCP, las restricciones de parámetros y las anotaciones de seguridad.
  • Simula los atributos del entorno del usuario, como la fecha, la hora y el idioma, y prueba los flujos de autenticación del cliente.

Para ingresar al Modo de desarrollador de las Apps con Gemini en la app web de Gemini, haz lo siguiente:

  1. Abre la app de Gemini en tu navegador web.
  2. Haz clic en Configuración > Modo de desarrollador de las Apps con Gemini (o ve directamente a gemini.google.com/devmode).
  3. En el diálogo Elige una app, selecciona tu app conectada registrada (si aún no está preseleccionada) o haz clic en + Crear nueva para conectar un extremo de servidor de MCP HTTPS como una app de MCP personalizada. Para obtener instrucciones de configuración completas, consulta Habilita el modo de desarrollador de Apps con Gemini.

Espacio de trabajo de panel dividido

Cuando habilitas el modo de desarrollador de las Apps con Gemini en las Apps con Gemini y seleccionas tu app de MCP personalizada, Gemini abre un espacio de trabajo de panel dividido que está vinculado al extremo de tu servidor. En la barra de encabezado superior, se muestra el nombre de la app activa y te permite cambiar entre las apps personalizadas conectadas. Puedes volver a abrir el panel lateral del Modo de desarrollador de las Apps con Gemini desde Configuración > Modo de desarrollador de las Apps con Gemini en cualquier momento.

Interfaz de panel dividido del modo de desarrollador de las Apps con Gemini que muestra una conversación de chat de Gemini a la izquierda y el inspector de registro de eventos a la derecha con un evento get_summit_info expandido que muestra 200 OK, latencia de ejecución y cargas útiles JSON de solicitud y respuesta con formato.
Figura 1: El espacio de trabajo de panel dividido del Modo de desarrollador de las Apps con Gemini que muestra la vista previa del chat de Gemini y el inspector del registro de eventos.

Versión preliminar de Gemini Chat

En el panel izquierdo, se simula la experiencia del cliente de Gemini para que puedas probar cómo interactúan los usuarios finales con tu app conectada.

Pestañas Inspector y Telemetría

El panel derecho proporciona cuatro pestañas de diagnóstico y configuración para inspeccionar y probar tu servidor de MCP:

  • Registro de eventos: Muestra un flujo cronológico de telemetría de instrucciones, interacciones de la IU, solicitudes de Tool call salientes y respuestas de Tool result entrantes. Cada evento muestra insignias para el código de estado HTTP, la latencia de ejecución en milisegundos y el tamaño de la carga útil en kilobytes. Puedes expandir un evento para revelar el texto completo de la instrucción y las cargas útiles de solicitud y respuesta JSON-RPC con formato. Puedes usar Borrar y Exportar para administrar la telemetría de la sesión.
  • Esquemas de herramientas: Muestra las instrucciones del servidor y todas las operaciones que devuelve el extremo tools/list de tu servidor. Puedes filtrar las herramientas con Filtrar herramientas, revisar las insignias de seguridad y autenticación (Solo lectura, Destructiva, Requiere autenticación) y expandir cualquier herramienta para inspeccionar sus tipos de parámetros, campos obligatorios, descripciones, JSON de esquema sin procesar y estructura de respuesta de muestra. También puedes hacer clic en Sincronizar esquema para volver a recuperar tools/list de tu servidor de MCP sin restablecer el historial de conversaciones.
  • Entorno: Proporciona controles de contexto simulado para probar el comportamiento de las herramientas que dependen del contexto sin modificar tu máquina local. Puedes anular la Fecha y hora (Fecha simulada y Hora simulada) y las Preferencias (Idioma), o bien hacer clic en Restablecer para restablecer los valores predeterminados.
  • Autenticación: Configura cómo Gemini establece las credenciales de cliente y usuario con tu servidor de MCP en Registro dinámico de clientes.
Pestaña Esquemas de herramientas que muestra insignias de seguridad, restricciones de parámetros y vistas previas de respuestas.
Figura 2: La pestaña Esquemas de herramientas, que muestra insignias de seguridad, restricciones de parámetros y vistas previas de respuestas.

Anotaciones de seguridad y encadenamiento de herramientas

Gemini evalúa las anotaciones de tu herramienta de MCP y el contexto de la conversación activa para determinar cuándo solicitarle al usuario que confirme antes de ejecutar una herramienta. Durante las pruebas en el modo de desarrollador de las Apps con Gemini, puedes verificar que tus herramientas declaren las anotaciones readOnlyHint y destructiveHint adecuadas y que invoquen tarjetas de confirmación cuando se espera.

Recursos adicionales