Files
buryan-infra/ops/hub/SECRETARY-AGENT-ACTIONS.md
T

4.1 KiB

Секретарь как агент: действия, а не команды (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 что система делала и где ошиблась