К содержанию
Pukemo агентская система
Инструкция пользователя

Как пользоваться системой

Восемь шагов от нуля до первой встречи с итогом. Идите по порядку — каждый шаг опирается на предыдущий.

Содержание инструкции
  1. 01 Знакомство
  2. 02 Аккаунт Krisp
  3. 03 Ключ OpenRouter
  4. 04 Nextcloud
  5. 05 Telegram-бот
  6. 06 n8n
  7. 07 Приложение-агент (ядро)
  8. 08 Как пользоваться
01

Знакомство

Что за система, как устроен путь «встреча → итог» и её главные принципы.

Система сама записывает и расшифровывает все ваши встречи и звонки, превращает расшифровку в аккуратный итог — что решили, кто что должен сделать, какие риски — складывает оригиналы в ваше личное облако и потом отвечает на вопросы по прошлым встречам.

Путь одной встречи

  • Встреча состоялась (звонок или очная).
  • Krisp записывает её и делает расшифровку.
  • n8n наводит порядок (имена, формат), кладёт оригинал в Nextcloud и передаёт расшифровку агенту.
  • Агент с помощью нейросети пишет итог:
    • Решения
    • Задачи — кто что должен сделать
    • Риски и нюансы
  • Итог сохраняется, добавляется в поиск, короткая выжимка приходит в Telegram.
  • Позже вы задаёте вопрос («что мы решили по X?») и получаете ответ со ссылкой на встречу.
Принцип Оригиналы всегда целы. Любой итог можно пересобрать заново — данные принадлежат вам, а нейросеть сменная.
02

Аккаунт Krisp

Регистрация, подключение к календарю и конференц-связи, проверка связи.

Что сделать

  • Зарегистрируйте аккаунт Krisp.
  • Подключите календарь и конференц-связь:
    • Zoom
    • Google Meet
    • Microsoft Teams
  • Включите события, которые система будет ловить:
    • transcript_created — появилась расшифровка
    • recording_ready — готова запись
  • Возьмите URL вебхука из n8n (шаг 06) и вставьте его в Krisp.
  • Проведите тестовый звонок — убедитесь, что расшифровка дошла до n8n.
Заметка На старте аккаунта Krisp может ещё не быть. Тогда расшифровки загружаются вручную — это не блокирует настройку остальных частей.
03

Ключ OpenRouter

Один ключ — доступ к Claude, GPT, Gemini и другим моделям.

Что сделать

  • Зарегистрируйтесь в OpenRouter и пополните баланс.
  • Создайте API-ключ.
  • Выберите модели под задачи:
    • по умолчанию — Claude Haiku (быстро и дёшево)
    • сложные сводки и разборы — более мощная модель по ситуации
  • Вставьте ключ в настройки:
    • credentials n8n → OpenRouter
    • конфиг ядра (.env)
Важно Следите за балансом: при исчерпании лимита нейросеть перестаёт отвечать, и итоги перестают собираться.
04

Nextcloud

Аккаунт, структура папок, app-пароли для n8n и ядра.

Структура папок

  • Work — рабочие встречи
  • Self-Reflection — личные сессии
  • Health — здоровье
  • Knowledge — база знаний
  • Coach — папка-приёмник для ядра
    • сюда n8n складывает готовые .md-расшифровки
    • ядро забирает их автоматически

Доступ для автоматизации

Для n8n и ядра создайте app-пароли (а не основной пароль) и выдайте им права только на нужные папки. Так доступ ограничен и его легко отозвать.

05

Telegram-бот

Создание бота, получение токена и вашего chat_id.

Что сделать

  • Откройте @BotFather и создайте бота — получите токен.
  • Узнайте свой chat_id:
    • напишите @userinfobot
    • бот ответит вашим числовым chat_id
  • Вставьте токен и chat_id в credentials n8n и в конфиг ядра.
  • Напишите боту любое сообщение — иначе он не сможет вам написать первым.
06

n8n

Импорт воркфлоу, credentials, активация.

Что сделать

  • Зайдите в self-hosted n8n (URL и логин — у администратора).
  • Импортируйте воркфлоу Krisp - LLM - Nextcloud - Telegram.
  • Заведите credentials:
    • Krisp — URL вебхука
    • OpenRouter — API-ключ
    • Nextcloud/WebDAV — app-пароль
    • Telegram — токен бота
  • Вынесите в настройки id людей и пути Nextcloud.
  • Активируйте воркфлоу.
Заметка Вебхук Krisp указывайте именно из ноды n8n «Webhook» — её URL подставляется в Krisp на шаге 02.
07

Приложение-агент (ядро)

Конфиг, запуск через Docker, проверка связи с папкой «Coach».

Что сделать

  • Заполните конфиг:
    • модели и провайдер (OpenRouter)
    • ключ API
    • пути к папкам Nextcloud
    • токен и chat_id Telegram
  • Запустите ядро через Docker.
  • Проверьте, что ядро видит папку-приёмник «Coach» и забирает оттуда расшифровки.
Принцип Ядро читает готовые .md из Nextcloud-папки «Coach» (или принимает payload по HTTP). Сменить модель — правка конфига, без переделки кода.
08

Как пользоваться

Повседневный сценарий: встреча, итог, вопрос, сводка.

Каждый день

  • Проведите встречу — дождитесь итога в Telegram.
  • Задайте системе вопрос («что мы решили по X?») и получите ответ со ссылкой на встречу.
  • Читайте утреннюю сводку и недельный обзор.

Пространства

Встречи распределяются по сферам — Работа, Саморефлексия, Здоровье, Знания. От сферы зависит, как ядро их разбирает и где хранит итог.

Готово — можно проводить встречу

Итог придёт в Telegram, а вопрос можно задать системе.

К ходу разработки