Tools
Widget'ı göster
show_widget, Control UI sohbet dökümünde kendi kendine yeten bir SVG veya HTML parçasını satır içinde işler. Birlikte gelen Canvas Plugin, aracın sahibidir ve her sonucu aynı kaynaklı bir Canvas belgesi olarak barındırır.
Araç yalnızca isteği başlatan Gateway istemcisi inline-widgets yeteneğini bildirdiğinde kullanılabilir. Control UI bu yeteneği otomatik olarak bildirir. Telegram ve WhatsApp gibi kanal çalıştırmaları show_widget aracını almaz.
Yetenek aktarımı; gömülü, Codex app-server ve CLI destekli model arka uçlarını kapsar. İzinle kimliği doğrulanmış MCP çağırıcıları ve doğrudan HTTP araç çağırıcıları, istemci yeteneklerini bildirmedikleri için varsayılan olarak erişime kapalı kalır.
Aracı kullanma
Aracı iki zorunlu dizeyle agent sağlar:
titlestringrequiredSatır içi önizlemeyle birlikte ve barındırılan belgenin başlığında gösterilen kısa başlık.
widget_codestringrequiredKendi kendine yeten SVG veya HTML parçası. Kırpıldıktan sonra <svg ile başlayan girdi SVG modunda işlenir; diğer tüm girdiler HTML parçası olarak değerlendirilir. En fazla uzunluk: 262.144 karakter.
Araç sonucu bir Canvas önizleme tanıtıcısı içerir; böylece web sohbeti widget'ı doğrudan araç çağrısından işler ve geçmiş yeniden yüklendikten sonra geri yükler. Önizlemeleri işlemeyen dökümler barındırılan Canvas yolunu yine de gösterir.
Güvenlik ve depolama
Widget belgeleri kısıtlayıcı bir İçerik Güvenliği Politikası kullanır: satır içi stil ve betiklere izin verilir, görseller data: URL'lerini kullanabilir; harici getirme işlemleri ve kaynak yüklemeleri ise engellenir. Tüm işaretlemeyi, stilleri, betikleri ve görsel verilerini widget_code içinde tutun.
Control UI'ın genel gömme modu trusted olsa bile iframe her zaman allow-same-origin niteliğini içermez; böylece widget betikleri üst uygulamanın kaynağını okuyamaz. Canvas sunucusu ayrıca widget belgelerini Content-Security-Policy: sandbox allow-scripts yanıt üstbilgisiyle sunar; dolayısıyla barındırılan URL doğrudan açıldığında bile widget, Control UI kaynağı yerine opak bir kaynakta çalışır. Tarayıcı korumalı alanı, bir betiğin kendi iframe'inde gezinmesini engellemez; yalnızca bu yalıtılmış çerçevede çalıştırmayı kabul ettiğiniz widget kodunu işleyin.
Iframe ayrıca gateway.controlUi.embedSandbox ayarına uyar. Varsayılan scripts katmanı, kaynak yalıtımını korurken etkileşimli widget'ları destekler.
Canvas, oturum başına (oturum yoksa agent başına) en fazla 32 widget saklar. Başka bir widget oluşturulduğunda, bu kapsamdaki en eski belge kaldırılır.
