Tools
Mostrar widget
show_widget renderiza en línea un fragmento SVG o HTML autocontenido en la transcripción del chat de la interfaz de control. El Plugin Canvas incluido es el propietario de la herramienta y aloja cada resultado como un documento Canvas del mismo origen.
La herramienta solo está disponible cuando el cliente Gateway de origen declara la capacidad inline-widgets. La interfaz de control declara esta capacidad automáticamente. Las ejecuciones en canales como Telegram y WhatsApp no reciben show_widget.
El transporte de capacidades abarca los backends de modelos integrados, los basados en el servidor de aplicaciones de Codex y los respaldados por la CLI. Los invocadores de MCP autenticados mediante concesión y los invocadores directos de herramientas mediante HTTP mantienen el cierre seguro porque no declaran capacidades de cliente.
Usar la herramienta
El agente proporciona dos cadenas obligatorias:
titlestringrequiredTítulo breve que se muestra con la vista previa en línea y en el título del documento alojado.
widget_codestringrequiredFragmento SVG o HTML autocontenido. La entrada que comienza con <svg después de eliminar los espacios en blanco se renderiza en modo SVG; cualquier otra entrada se trata como un fragmento HTML. Longitud máxima: 262 144 caracteres.
El resultado de la herramienta incluye un identificador de vista previa de Canvas, por lo que el chat web renderiza el widget directamente desde la llamada a la herramienta y lo restaura después de volver a cargar el historial. Las transcripciones que no renderizan vistas previas siguen mostrando la ruta de Canvas alojada.
Seguridad y almacenamiento
Los documentos de widgets usan una política de seguridad de contenido restrictiva: se permiten los estilos y scripts en línea, las imágenes pueden usar URL data: y se bloquean las solicitudes externas y las cargas de recursos. Mantenga todo el marcado, los estilos, los scripts y los datos de imágenes dentro de widget_code.
El iframe siempre omite allow-same-origin, incluso cuando el modo global de contenido insertado de la interfaz de control es trusted, por lo que los scripts del widget no pueden leer el origen de la aplicación principal. El host de Canvas también sirve los documentos de widgets con un encabezado de respuesta Content-Security-Policy: sandbox allow-scripts, por lo que abrir directamente la URL alojada sigue ejecutando el widget en un origen opaco en lugar del origen de la interfaz de control. El aislamiento del navegador no impide que un script navegue dentro de su propio iframe; renderice únicamente código de widgets que esté dispuesto a ejecutar en ese marco aislado.
El iframe también sigue gateway.controlUi.embedSandbox. El nivel predeterminado scripts admite widgets interactivos a la vez que conserva el aislamiento del origen.
Canvas conserva como máximo 32 widgets por sesión (o por agente cuando no hay ninguna sesión disponible). Al crear otro widget, se elimina el documento más antiguo de ese ámbito.
