# API керування комп'ютерами
SUMMARY: Віддалене керування зареєстрованими комп'ютерами — постановка команд у чергу, знімки екрана, запуск скриптів на віддалених машинах.

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

API керування комп'ютерами
API керування комп'ютерами дозволяє віддалено керувати зареєстрованими комп'ютерами.
Невеликий агент () працює на цільовій машині, опитує сервер
щодо команд, виконує їх та надсилає результати назад. Це забезпечує автоматизацію
GUI під керуванням LLM.
Архітектура
[CODE BLOCK]
Кінцеві точки для користувача (Mind Key або JWT)
GET /computers/list
Список усіх зареєстрованих комп'ютерів.
[CODE BLOCK]
GET /computers/:id
Отримати деталі конкретного комп'ютера.
[CODE BLOCK]
POST /computers/install-code
Згенерувати код встановлення для реєстрації нового комп'ютера.
[CODE BLOCK]
Відповідь: 
POST /computers/:id/commands
Поставити команду в чергу для виконання віддаленим агентом.
[CODE BLOCK]
Відповідь: 
GET /computers/:id/command (через запит)
Поставити команду в чергу через GET (для простих випадків).
[CODE BLOCK]
GET /computers/:id/commands
Список нещодавніх команд для комп'ютера.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Отримати статус + результат конкретної команди.
[CODE BLOCK]
GET /computers/:id/screenshot
Одноразове виконання: поставити команду знімка екрана в чергу та чекати до 30 с на результат.
[CODE BLOCK]
POST /computers/:id/disable
Вимкнути комп'ютер (відкликає його токен, зберігає запис для аудиту).
[CODE BLOCK]
DELETE /computers/:id
Видалити комп'ютер назавжди.
[CODE BLOCK]
Кінцеві точки для агента (Computer Token)
Ці кінцеві точки використовує , що працює на цільовій
машині. Вони використовують Computer Token (повертається ), а
не Mind Key.
POST /computers/register
Активувати код встановлення та отримати Computer Token.
[CODE BLOCK]
Відповідь: 
> [!CRITICAL]
> Збережіть  — він показується лише один раз і потрібен для всіх
> кінцевих точок на боці агента.
GET /computers/me/poll
Довге опитування нових команд. Агент викликає це в циклі.
[CODE BLOCK]
Повертає негайно, якщо команди очікують, або через  секунд, якщо ні.
POST /computers/me/commands/:cid/result
Надіслати результат виконання команди.
[CODE BLOCK]
Типи команд
| Тип | Payload | Опис |
|------|---------|-------------|
|  |  | Захоплення екрана як PNG (base64) |
|  |  | Клацання за координатами |
|  |  | Переміщення миші за координатами |
|  |  | Введення тексту в позиції курсора |
|  |  | Натискання комбінації клавіш |
|  |  | Прокручування колеса |
|  |  | Перетягування |
Типовий шаблон: автоматизація GUI під керуванням LLM
[CODE BLOCK]
Наступні кроки
- Браузерний проксі — окрема служба для автоматизації браузера
- Посібник із self-hosted агентів