Агенты и команда

Piomio — это команда, а не один бот. Каждый агент — роль со своим именем, лицом, характером, интеллектом и инструментами, и с каждым у тебя свой длинный диалог. Агенты знают друг о друге, передают друг другу работу и помнят, что для тебя важно.

С какой командой ты начинаешь#

В новом хабе два агента:

• Ассистент (основной агент) — главный помощник. Он же управляет самим Piomio: настройками, новыми агентами, ключами, подключениями. Создавать, менять, архивировать и удалять других агентов может только основной агент.
• Исследователь — ищет, сравнивает и сводит информацию из нескольких источников, следит за темами. Ему доступны только интернет, браузер, память, задачи, коллеги, расписания и каналы.

При первом запуске ассистент предлагает ещё несколько ролей и собирает с тобой те, что нужны (см. Первый запуск).

Диалог основного агента — стартовая страница, и туда же приходит всё, что ты пишешь в Telegram (см. Telegram). Основным можно сделать любого другого агента: Сделать основным в его меню.

Каждый агент — ресепшен#

В своём диалоге любой агент сразу отвечает на быстрое, а всё, где есть шаги, отправляет в задачу на стороне: поиск, код, проверки, работу в браузере, длинные тексты. Он сам решает, кто сделает работу (он сам или коллега, чья роль или скиллы подходят лучше) и на каком компьютере, а короткий вопрос задаёт, только если это неясно и важно. Вопросы коллеге уходят ему сообщением, и ответ возвращается в диалог. Как задачи идут и отчитываются — в разделе Задачи, расписания и «Входящие».

В диалоге собственные инструменты агента только смотрят. Claude Code работает там без оболочки и правки файлов, Codex — только на чтение, а запросы разрешений Kimi отклоняются. Запускать команды и менять файлы — работа задачи.

Что такое агент#

Агент — это файл Markdown: настройки сверху, инструкции под ними. Формат совместим с файлами сабагентов Claude Code.

• Встроенные агенты лежат в папке agents/ самого приложения.
• Твои — в agents/<id>.md в папке данных хаба (на Mac ~/Library/Application Support/Piomio, на Windows %LOCALAPPDATA%\Piomio, на Linux-сервере ~/.local/share/piomio). Если поменять встроенного агента, там появится твоя копия, и она главнее.
• Правки, сделанные в файлах руками, хаб подхватит после перезапуска.
• Кто закреплён, а кто в архиве, хранится в настройках хаба, а не в файлах.

---
name: Повар
description: Планирует меню на неделю и список покупок.
avatar:
  color: orange
  shape: flower
brains:
  - claude-code@local
  - codex@local
  - kimi@local
  - api:*
initiative: 1
tools:
  - "*"
skills:
  - "*"
budget:
  backgroundRunsPerDay: 30
---
Ты планируешь еду для семьи. Один раз спроси про аллергии, запомни их и держи списки короткими.

Как создать агента#

Скажи ассистенту: «сделай агента для рецептов». Или нажми Добавить агента в конце списка команды (а ещё Новый агент на странице «Агенты» и в палитре команд, Ctrl+K или Cmd+K). Откроется короткий чат настройки, где уже ждёт первый вопрос: «Чем будет заниматься новый агент? Опишите его работу в паре предложений, и я его соберу».

1. Ответь своими словами. Ассистент спрашивает только то, чего не хватает, по одному короткому сообщению, и начинает с имени.
2. Появится карточка Новый агент: лицо, имя и описание. Цвет и Форму можно выбрать прямо на карточке или не трогать.
3. Что-то не так — просто скажи, и описание поправится.
4. Ассистент спросит, насколько агент должен быть проактивным; ответь словами или выбери на карточке в Проактивность.
5. Скажи «да» или нажми Создать агента. Карточка сообщит, что агент в команде, с кнопкой Открыть диалог, а чат настройки станет диалогом нового агента.

Id нового агента собирается из имени. Существующего агента новый никогда не заменит. Чат настройки, из которого ничего не вышло, убирается при следующем запуске хаба, если ему больше суток.

Как поменять агента#

Поговори с самим агентом: «зови себя Ада», «отвечай короче», «покажи, как ты выглядишь». Он сам меняет своё имя, описание, лицо, инициативу и инструкции и показывает карточку Как я выгляжу с выбором лица и Проактивность. Если он перед этим читал внешний контент (страницу, письмо), он сначала спросит тебя карточкой. Ассистент может так же поменять любого агента.

То же есть на странице Агенты: Настройки → Агенты. На карточке агента — лицо, имя, описание и значки: инициатива, встроенный или ваш, интеллект, на котором он сейчас, только на … для агентов, привязанных к компьютерам, и его собственные скиллы. Изменить открывает Имя, лицо, Описание, Промпт и Инициатива; в Дополнительно — Идентификатор, Интеллект по порядку предпочтения, Компьютеры, Модель, Профиль политики, Инструменты, Скиллы и Фоновых запусков в день.

Инициатива#

Инициатива — это сколько агент делает сам в фоновой работе: в расписаниях, каналах и фоновых задачах. В твоих разговорах и в задачах, запущенных из них, она ничего не меняет.

Что хаб соблюдает сейчас: ниже Действует фоновый запуск видит только инструменты чтения и несколько разрешённых всегда (уведомить тебя, память, пост в канал, страницы). Вместо действий агент их предлагает. Скилл, которому ты его научил, может пользоваться браузером и при запуске по расписанию.

У каждого агента есть и дневной бюджет фоновых запусков (по умолчанию 30, у ассистента 40). Когда он исчерпан, следующие запуски в этот день не проходят, и тебе приходит уведомление.

Какой интеллект отвечает#

У агента есть список интеллекта по порядку: отвечает первый, в который выполнен вход и который готов, а при лимите или ошибке работу подхватывает следующий. Внутри хаб под каждую просьбу выбирает модель и глубину: что-то лёгкое на «спасибо», быструю сильную модель для диалога, обычную для задач и самую мощную для сложного. Код уходит туда, где его можно запускать. Как подключить интеллект и войти в него — в разделе Интеллект и вход.

В диалоге выбранный тобой интеллект остаётся первым. Нажми на переключатель рядом с именем агента в шапке диалога (Как «Ассистент» думает в этом чате):

• Авто, Быстро, Сбалансированно или Глубоко;
• Точная модель и глубина — чтобы задать Модель и Глубина рассуждений;
• Интеллект — кто именно отвечает здесь;
• По-разному для задач, каналов, расписаний открывает чат, чтобы настроить их отдельно;
• Подключить ещё интеллект.

/brain и /effort в чате делают то же самое (см. Чат). Значок после времени ответа показывает, какие интеллект, модель и глубина его дали.

Закрепить, в архив, удалить#

У каждого агента есть меню: правый клик в списке команды, долгое нажатие на телефоне или ⋯. В нём Закрепить, Отметить непрочитанным, Сделать основным, Настройки агента, В архив и Удалить. У основного агента нет Закрепить и Сделать основным.

В архив — агент засыпает. Он пропадает из списка команды и из списков коллег, его текущая работа останавливается, расписания и каналы не работают, диалог не принимает сообщений. Переписка, память и настройки остаются. Агенты из архива ждут за строкой Архив · N в конце списка команды; Вернуть возвращает агента со всем, что у него было. /archive в диалоге агента показывает то же карточкой.

Удалить — навсегда. Удаляются файл агента, его диалог, задачи, расписания и уведомления, и он выходит из групповых чатов. Каналы, которые он вёл, переходят к основному агенту, а скиллы, которые были только у него, возвращаются всей команде. Память не трогается. В подтверждении есть Убрать в архив. Если агента по твоей просьбе удаляет ассистент, он всегда спрашивает карточкой.

Перед тем как отправить в архив или удалить основного агента, приложение спросит, кто займёт его место.

Агенты на своих компьютерах#

Агента можно привязать к компьютерам: «пусть программист работает только на моём ноутбуке». Тогда он пользуется интеллектом только этих компьютеров, никаких других, и его задачи тоже никуда больше не уходят. Пока ни один из них не в сети, диалог об этом скажет; сообщение останется, и его можно отправить снова, когда компьютер вернётся. То же самое — в Настройки агента → Дополнительно → Компьютеры: ничего не выбрано — значит, любой компьютер. Про компьютеры — в разделе Машины и другие компьютеры.

Что знает агент#

Агенты должны ощущаться как люди, которые понимают, где они и когда. На каждом ходу агент знает:

• кто он, на каком интеллекте, модели и глубине думает и на каком компьютере работает;
• местное время: строка [Now: …], обновляется не чаще раза в 10 минут;
• блок [You now], когда что-то изменилось: этот разговор, его другая работа, чем занят каждый коллега, какие компьютеры в сети и где ты;
• в диалоге — свои задачи, которые ещё идут.

Его диалог, задачи и переписка с коллегами — это один и тот же агент, поэтому он может сказать, чем ещё занят.

Где ты, хаб узнаёт из приложения для iPhone, если включить там передачу местоположения на вкладке Хаб (см. Приложение для iPhone). Хаб хранит только последнее место и забывает его, когда передачу выключаешь.

Память#

Команда помнит, что для тебя важно. Скажи любому агенту «запомни, что у меня аллергия на орехи» или просто упомяни это; агенты и сами сохраняют факты по ходу разговора, а под ответом появляется строка Запомнено: с фактом. Нужные факты сами всплывают в следующих разговорах, а по ночам память приводится в порядок и пополняется тем, что пропустили.

• Агенты запоминают, меняют и забывают факты без вопросов, в том числе после чтения внешнего контента. Каждое изменение хранится в истории факта, и его можно отменить.
• Секреты в память не попадают: пароли, токены и номера карт живут в хранилище.
• Факт может быть общим для команды или только для одного агента.

Страница Память (Настройки → Память) показывает, что команда знает, по группам: Вы, Предпочтения, Люди, Места, Проекты, Хроника, Как вы любите и Заметки. Там можно искать, Изменить, Забыть (и потом Отменить), открыть историю факта (История · N версий), Навести порядок и сделать Экспорт. То, что уже неверно, лежит в Уже неверно. Факты, которые остались неподтверждёнными со старых версий, видны в блоке Ждут вашего «да» с кнопками Запомнить и Не надо.

На диске каждый факт — файл Markdown в plugins-data/memory/memory/ в папке данных хаба. Если установлен git, каждое изменение коммитится (История в git в настройках плагина «Память»).

Свои скиллы#

Скилл — это набор инструкций, который агент подгружает, когда он нужен. Скилл принадлежит всей команде или только тем агентам, кому его дали. Собственные скиллы агента видны в списке команды у других агентов, так что работа, для которой нужен скилл, уходит к тому, у кого он есть.

• Скилл, которому ты научил агента, показав дело в браузере, принадлежит этому агенту (см. Браузер и режим обучения).
• Скажи «оставь скилл со счетами только Аде» или «верни его всей команде».
• В Настройки → Скиллы и команды — скиллы, команды и инструменты. У каждого скилла видно, у кого он есть: Вся команда или лица агентов. Нажми на эту строку, чтобы решить в чате.
• Свои скиллы — это папки с SKILL.md в skills/ в папке данных хаба.