# Bilgisayar Kontrol API'si
SUMMARY: Kayıtlı bilgisayarların uzaktan kontrolü — komut kuyruğa alma, ekran görüntüsü alma, uzak makinelerde betik çalıştırma.

KEY CONTEXT:
Two sides: user-facing (Mind Key/JWT) and agent-facing (Computer Token)
Register agent: POST /computers/register { install_code } → returns computer_token
List: GET /computers/list (Mind Key or JWT)
Queue command: POST /computers/:id/commands { type, payload }
Command types: screenshot, click, move, type, key, scroll, drag
Agent poll: GET /computers/me/poll?wait=5 (Computer Token)
Agent result: POST /computers/me/commands/:cid/result (Computer Token)
One-shot screenshot: GET /computers/:id/screenshot (waits 30s for result)
Pattern: register agent on remote machine → user queues commands → agent polls and executes

Bilgisayar Kontrol API'si
Computer Control API, kayıtlı bilgisayarları uzaktan kontrol etmenizi sağlar. Hedef makinede küçük bir ajan () çalışır, komutlar için poll yapar, bunları yürütür ve sonuçları geri gönderir. Bu, LLM odaklı GUI otomasyonunu mümkün kılar.
Mimari
[CODE BLOCK]
Kullanıcıya Yönelik Uç Noktalar (Mind Key veya JWT)
GET /computers/list
Tüm kayıtlı bilgisayarları listele.
[CODE BLOCK]
GET /computers/:id
Tek bir bilgisayarın detaylarını alın.
[CODE BLOCK]
POST /computers/install-code
Yeni bir bilgisayar kaydetmek için bir install code oluşturun.
[CODE BLOCK]
Yanıt: 
POST /computers/:id/commands
Uzak ajanın yürütmesi için bir komut kuyruğa al.
[CODE BLOCK]
Yanıt: 
GET /computers/:id/command (via query)
GET ile komut kuyruğa al (basit durumlar için).
[CODE BLOCK]
GET /computers/:id/commands
Bir bilgisayar için son komutları listele.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Belirli bir komutun durumu + sonucunu alın.
[CODE BLOCK]
GET /computers/:id/screenshot
Tek seferlik: bir screenshot komutu kuyruğa al ve sonuç için en fazla 30s bekle.
[CODE BLOCK]
POST /computers/:id/disable
Bir bilgisayarı devre dışı bırak (token'ını iptal eder, denetim için kaydı tutar).
[CODE BLOCK]
DELETE /computers/:id
Bir bilgisayarı kalıcı olarak sil.
[CODE BLOCK]
Ajana Yönelik Uç Noktalar (Computer Token)
Bu uç noktalar hedef makinede çalışan  tarafından kullanılır. Bir Mind Key değil, bir Computer Token ( tarafından döndürülür) kullanırlar.
POST /computers/register
Bir install code'u kullan ve bir Computer Token al.
[CODE BLOCK]
Yanıt: 
> [!CRITICAL]
> 'ı kaydedin — yalnızca bir kez gösterilir ve tüm ajan tarafı uç noktalar için gereklidir.
GET /computers/me/poll
Yeni komutlar için long-poll. Ajan bunu bir döngüde çağırır.
[CODE BLOCK]
Bekleyen komutlar varsa hemen döner, yoksa  saniye sonra döner.
POST /computers/me/commands/:cid/result
Bir komutun yürütülmesinin sonucunu gönder.
[CODE BLOCK]
Komut Tipleri
| Tip | Payload | Açıklama |
|------|---------|-------------|
|  |  | Ekranı PNG olarak yakala (base64) |
|  |  | Koordinatlarda tıkla |
|  |  | Fareyi koordinatlara taşı |
|  |  | İmleç konumunda metin yaz |
|  |  | Tuş kombinasyonuna bas |
|  |  | Tekerleği kaydır |
|  |  | Sürükle ve bırak |
Yaygın Desen: LLM Odaklı GUI Otomasyonu
[CODE BLOCK]
Sonraki Adımlar
- Browser Proxy — tarayıcı otomasyonu için ayrı hizmet
- Self-Hosted Agents Rehberi