# Агентский режим Ydalenka («Удалёнка»)

Ydalenka позволяет AI-агенту готовить и выполнять проверяемые сценарии удалённого администрирования Windows без обязательной трансляции экрана.

## Как агенту найти API в установленной программе

Прочитайте ключ `HKLM\Software\Ydalenka v3`. Значения `AgentApiPath`, `AgentToolPath` и `AgentSchemaPath` указывают на актуальные файлы конкретной установленной версии. Стандартный путь утилиты — `%ProgramFiles%\Ydalenka\Ydalenka.Agent.ps1`.

Получить машиночитаемое описание:

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:ProgramFiles\Ydalenka\Ydalenka.Agent.ps1" info
```

Создать отключённый сценарий синхронизации:

```powershell
& "$env:ProgramFiles\Ydalenka\Ydalenka.Agent.ps1" create-sync -TargetId 739234558 -Name "Синхронизация YdalenkaSync" -LocalRoot "C:\YdalenkaSync"
```

Не придумывайте `TargetId`: возьмите ID выбранного контакта либо спросите пользователя. Создание сценария не означает разрешение на запуск.

Полное описание для автоматического чтения: [agent-mode-api.json](agent-mode-api.json).