From 3e47b3f0a71d37dbad6c318f75bf46f2dafc1e09 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Mon, 9 Nov 2026 22:24:25 +0300 Subject: [PATCH] =?UTF-8?q?[BOTS]=20=D0=A1=D0=B5=D0=BA=D1=80=D0=B5=D1=82?= =?UTF-8?q?=D0=B0=D1=80=D1=8C=20=D1=81=D1=82=D0=B0=D0=BB=20=D0=B4=D0=B5?= =?UTF-8?q?=D0=B9=D1=81=D1=82=D0=B2=D0=BE=D0=B2=D0=B0=D1=82=D1=8C:=20?= =?UTF-8?q?=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BC=D0=B5=D0=BD=D1=82=20?= =?UTF-8?q?light=5Fcontrol,=20downloads=20(Sonarr/Radarr=20+=20=D1=80?= =?UTF-8?q?=D1=83=D1=81-=D0=BB=D0=B0=D1=82=20=D1=81=D0=BE=D0=BF=D0=BE?= =?UTF-8?q?=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B8=D0=B5),=20TTL?= =?UTF-8?q?=20=D0=BF=D0=B0=D0=BC=D1=8F=D1=82=D0=B8=202=D1=87,=20MAX=5FSTEP?= =?UTF-8?q?S=205.=20=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD?= =?UTF-8?q?=D0=BE:=20=D0=BF=D1=80=D0=BE=D1=82=D0=B5=D0=BA=D0=B0=D0=BD?= =?UTF-8?q?=D0=B8=D0=B5=20=D1=81=D1=82=D0=B0=D1=80=D1=8B=D1=85=20=D1=82?= =?UTF-8?q?=D0=B5=D0=BC=20(=D0=A5=D0=BE=D0=B1=D0=B1=D0=B8=D1=82=20=D0=B2?= =?UTF-8?q?=D0=BC=D0=B5=D1=81=D1=82=D0=BE=20=D0=A4=D0=B5=D1=80=D0=BC=D1=8B?= =?UTF-8?q?=20=D0=9A=D0=BB=D0=B0=D1=80=D0=BA=D1=81=D0=BE=D0=BD=D0=B0)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/hub/SECRETARY-AGENT-ACTIONS.md | 71 ++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 ops/hub/SECRETARY-AGENT-ACTIONS.md 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` | что система делала и где ошиблась |