---
read_when:
    - Bir ajanın Control UI bölmelerini ayırmasını, odaklamasını, kapatmasını veya bunlar arasında gezinmesini istiyorsunuz
    - Bir ajanın kenar çubuğunu, terminali veya tarayıcı panellerini göstermesini ya da gizlemesini istiyorsunuz
    - ui.command yeteneğine ve fan-out sözleşmesine ihtiyacınız var
sidebarTitle: Screen
summary: Bir aracının bağlı Kontrol Arayüzünü düzenlemesini sağlayın
title: Ekran
x-i18n:
    generated_at: "2026-07-26T23:39:39Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: df2215db96af29fa6b0db8abad79a0a2787a194dab6d00f9ef32f45521907ae1
    source_path: tools/screen.md
    workflow: 16
---

`screen` aracı, bir ajanın tarayıcı tabanlı Control UI'ı düzenlemesini sağlar. Bu,
ekran görüntüsü yakalama veya tarayıcı otomasyonu değil, türü belirlenmiş bir
yerleşim ve gezinme yüzeyidir.

Araç yalnızca kaynak istemci `ui-commands` yeteneğini bildirdiğinde sunulur.
Araç çalıştırılırken en az bir yetenekli Control UI'ın hâlâ bağlı olması gerekir;
aksi takdirde Gateway, `UNAVAILABLE` döndürür.

## Eylemler

| Eylem                             | Etki                                            | İsteğe bağlı girdiler                                  |
| --------------------------------- | ----------------------------------------------- | ------------------------------------------------------ |
| `split_right`                | Hedef oturum bölmesini sağa doğru böler         | `sessionKey` (varsayılanı geçerli oturumdur)     |
| `split_down`                | Hedef oturum bölmesini aşağı doğru böler        | `sessionKey` (varsayılanı geçerli oturumdur)     |
| `close_pane`                | Hedef oturum bölmesini kapatır                  | `sessionKey` (varsayılanı geçerli oturumdur)     |
| `focus`                | Hedef oturum bölmesine odaklanır                | `sessionKey` (varsayılanı geçerli oturumdur)     |
| `navigate`                | Hedef oturumu açar                              | `sessionKey` (varsayılanı geçerli oturumdur)     |
| `sidebar_show` / `sidebar_hide` | Ana kenar çubuğunu gösterir veya gizler   | -                                                      |
| `terminal_show` / `terminal_hide` | Operatör terminal panelini gösterir veya gizler | Gösterirken `dock` (`bottom` veya `right`) |
| `browser_show` / `browser_hide` | Tarayıcı panelini gösterir veya gizler    | Gösterirken `dock` (`bottom` veya `right`) |

Başarılı bir komut, Gateway türü belirlenmiş `ui.command` olayını
yayımladıktan sonra `{ "ok": true }` döndürür.

## Yönlendirme ve güvenlik

Protokol v1, komutu kasıtlı olarak `ui-commands` bildiren tüm bağlı Control
UI'lara gönderir; belirli bir tarayıcı sekmesini hedeflemez. Aynı operatörün
birden fazla açık panosu olduğunda bu önemlidir.

Gateway RPC, `operator.write` gerektirir. Araç yalnızca sunum durumunu
değiştirebilir: pikselleri okuyamaz, ekran görüntüsü alamaz, rastgele sayfa
içeriğine tıklayamaz veya seçilen oturum ve operatör panellerinin izinlerini
atlayamaz.

## İlgili

- [Control UI](/tr/web/control-ui)
- [Gateway protokolü](/tr/gateway/protocol#method-families)
- [Tarayıcı aracı](/tr/tools/browser)