---
read_when:
    - คุณต้องการให้เอเจนต์แบ่ง มุ่งเน้น ปิด หรือนำทางบานหน้าต่าง Control UI
    - คุณต้องการให้เอเจนต์แสดงหรือซ่อนแถบด้านข้าง เทอร์มินัล หรือแผงเบราว์เซอร์
    - คุณต้องมีความสามารถ ui.command และสัญญาการกระจายงานแบบ fan-out
sidebarTitle: Screen
summary: ให้เอเจนต์จัดเตรียม Control UI ที่เชื่อมต่ออยู่
title: หน้าจอ
x-i18n:
    generated_at: "2026-07-19T07:41:08Z"
    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` ช่วยให้เอเจนต์จัดวาง Control UI บนเบราว์เซอร์ได้ โดยเป็น
พื้นผิวการจัดวางและการนำทางแบบมีชนิดข้อมูล ไม่ใช่การจับภาพหน้าจอหรือระบบอัตโนมัติ
ของเบราว์เซอร์

เครื่องมือนี้จะแสดงให้ใช้เฉพาะเมื่อไคลเอนต์ต้นทางประกาศความสามารถ
`ui-commands` เท่านั้น และขณะเครื่องมือทำงาน ต้องยังมี Control UI ที่รองรับอย่างน้อยหนึ่งรายการ
เชื่อมต่ออยู่ มิฉะนั้น Gateway จะส่งคืน `UNAVAILABLE`

## การดำเนินการ

| การดำเนินการ                            | ผลลัพธ์                                     | อินพุตที่ไม่บังคับ                                |
| --------------------------------- | ------------------------------------------ | ---------------------------------------------- |
| `split_right`                     | แบ่งบานหน้าต่างเซสชันเป้าหมายไปทางขวา | `sessionKey` (ค่าเริ่มต้นคือเซสชันปัจจุบัน) |
| `split_down`                      | แบ่งบานหน้าต่างเซสชันเป้าหมายลงด้านล่าง     | `sessionKey` (ค่าเริ่มต้นคือเซสชันปัจจุบัน) |
| `close_pane`                      | ปิดบานหน้าต่างเซสชันเป้าหมาย              | `sessionKey` (ค่าเริ่มต้นคือเซสชันปัจจุบัน) |
| `focus`                           | โฟกัสบานหน้าต่างเซสชันเป้าหมาย              | `sessionKey` (ค่าเริ่มต้นคือเซสชันปัจจุบัน) |
| `navigate`                        | เปิดเซสชันเป้าหมาย                    | `sessionKey` (ค่าเริ่มต้นคือเซสชันปัจจุบัน) |
| `sidebar_show` / `sidebar_hide`   | แสดงหรือซ่อนแถบด้านข้างหลัก              | -                                              |
| `terminal_show` / `terminal_hide` | แสดงหรือซ่อนแผงเทอร์มินัลของผู้ปฏิบัติงาน   | `dock` (`bottom` หรือ `right`) เมื่อแสดง      |
| `browser_show` / `browser_hide`   | แสดงหรือซ่อนแผงเบราว์เซอร์             | `dock` (`bottom` หรือ `right`) เมื่อแสดง      |

คำสั่งที่สำเร็จจะส่งคืน `{ "ok": true }` หลังจาก Gateway เผยแพร่
เหตุการณ์แบบมีชนิดข้อมูล `ui.command`

## การกำหนดเส้นทางและความปลอดภัย

โปรโตคอล v1 ตั้งใจส่งคำสั่งไปยัง Control UI ที่เชื่อมต่ออยู่ทุกตัวซึ่ง
ประกาศ `ui-commands` โดยไม่ได้กำหนดเป้าหมายเป็นแท็บเบราว์เซอร์ใดแท็บหนึ่ง ประเด็นนี้สำคัญเมื่อ
ผู้ปฏิบัติงานคนเดียวกันเปิดแดชบอร์ดไว้หลายรายการ

RPC ของ Gateway ต้องใช้ `operator.write` เครื่องมือนี้เปลี่ยนได้เฉพาะสถานะ
การนำเสนอเท่านั้น โดยไม่สามารถอ่านพิกเซล จับภาพหน้าจอ คลิกเนื้อหาใด ๆ
บนหน้าเว็บ หรือข้ามสิทธิ์ของเซสชันและแผงผู้ปฏิบัติงาน
ที่เลือกไว้ได้

## ที่เกี่ยวข้อง

- [Control UI](/th/web/control-ui)
- [โปรโตคอล Gateway](/th/gateway/protocol#method-families)
- [เครื่องมือเบราว์เซอร์](/th/tools/browser)