diff --git a/ops/hub/SECRETARY-AGENT-ACTIONS.md b/ops/hub/SECRETARY-AGENT-ACTIONS.md new file mode 100644 index 0000000..e0b1456 --- /dev/null +++ b/ops/hub/SECRETARY-AGENT-ACTIONS.md @@ -0,0 +1,71 @@ +# Секретарь как агент: действия, а не команды (09.11.2026) + +## Проблема, которую показал владелец + +«Секретарь не смог ничего из того что я попросил». Разбор выявил три причины: + +### 1. Память диалога протекала старыми темами + +`/var/lib/hub-bots/dialog_memory.json` хранил реплики от 28 октября +(«Хоббит», «Firefly») без срока годности. Агент подмешивал их в каждый +новый разговор: на вопрос про «Ферму Кларксона» отвечал про Хоббита. + +**Исправлено:** TTL 2 часа в `dialog.history()` — старые реплики +отбрасываются, а не подмешиваются. + +### 2. Не было инструмента проверки загрузки + +На вопрос «скачен ли сериал» агент мог только перечислить каталог. +Реального статуса (сколько серий есть) не было. + +**Исправлено:** инструмент `downloads` — Sonarr (192.168.1.117:8989) и +Radarr (192.168.1.118:7878), поля `episodeFileCount/totalEpisodeCount` +и `hasFile`. Ответ: «Ферма Кларксона — частично: 24 из 41 серии». + +**Ловушка:** русское название не совпадает с английским в Arr. +Решение — нормализация + транслитерация + `difflib` (порог 0.80 по слову). +Проверено: «ферма кларксона» ↔ «Clarkson's Farm» → пара найдена; +«ферма кларксона» ↔ «The Expanse» → нет. + +### 3. Из 17 инструментов действовали только 3 + +| Действуют | Читают | +|---|---| +| `request`, `play`, `wish` | 14 остальных, включая `lights` | + +То есть секретарь **рассказывал**, но не **делал**. + +**Исправлено (первый шаг):** инструмент `light_control` +(`action: on|off|toggle`, `name: коридор`, опционально `brightness`). +Поиск сущностей по русскому слову в `friendly_name`, вызов +`/api/services/light/turn_on|turn_off`. + +Проверено на живом HA: +``` +Q: какой сейчас свет включён? → «5 из 5: прихожая, коридор, тамбур…» +Q: выключи свет в коридоре → «Свет в коридоре выключен» +Q: включи свет в коридоре → «Свет в коридоре включён» +состояние HA после: light.lampa_koridor = on +``` + +### 4. Шагов на задачу было мало + +`MAX_STEPS = 3` → **5**. Сложная задача («проверь и докачай») теперь +может идти в несколько шагов. + +## Правила действий в промпте + +* безопасное (свет, громкость) — делать сразу, не спрашивать; +* необратимое (удалить, отменить загрузку, перезапустить сервис) — спрашивать; +* многошаговую задачу выполнять подряд, не останавливаться на первом шаге. + +## Что ещё нужно, чтобы это был полноценный агент + +| Инструмент | Действие | +|---|---| +| `climate_control` | температура/режим кондиционера | +| `media_control` | пауза, громкость, следующий трек | +| `cancel_download` | отменить загрузку (с подтверждением) | +| `service_restart` | перезапуск сервиса (с подтверждением) | +| `remind` | напоминание | +| `hermes_events` | что система делала и где ошиблась |