Работа с командой
Чат
Описывает Piomio 0.2.15Изменить страницу
У каждого агента команды с тобой один длинный диалог. Пишешь как человеку, а агент отвечает, переспрашивает кнопками, показывает картинки и карты и отправляет долгую работу в задачи на стороне. Чат одинаковый в приложении для компьютера, в браузере и в приложении для iPhone: там открывается та же страница чата. Про Telegram — в разделе Telegram, про телефон — в Приложении для iPhone.
Боковая панель
В боковой панели три вкладки: Агенты, Группы и Каналы. Точка на вкладке, которая сейчас не открыта, значит, что там есть непрочитанное.
- Агенты — твоя команда. Основной агент стоит сверху крупно, со звёздочкой (Основной агент); его диалог — стартовая страница. Ниже закреплённые, потом остальные. В строке видно последнее сообщение, Работает…, пока агент занят, и сколько ты ещё не прочитал. Добавить агента в конце открывает короткий чат, в котором собирается новый агент, а за строкой Архив · N лежат уснувшие агенты. Меню агента открывается правым кликом, долгим нажатием на телефоне или кнопкой ⋯. Всё это подробно — в разделе Агенты и команда.
- Группы — чаты сразу с несколькими агентами (см. Групповые чаты ниже).
- Каналы — новостные ленты, которые для тебя ведёт агент, см. Каналы.
Под вкладками — Входящие, Задачи (с живым счётчиком активных задач) и Настройки. Задачи и «Входящие» описаны в разделе Задачи, расписания и «Входящие».
Разговор с агентом
Пиши в поле внизу и жми Enter. Shift+Enter — новая строка. На телефоне Return переносит строку, а отправляет кнопка со стрелкой. Неотправленный текст остаётся в поле, даже если переключиться на другой чат.
Когда открываешь чат и начинаешь печатать, интеллект агента уже готовится, и первый ответ приходит быстрее.
Несколько сообщений подряд
Не обязательно укладывать всё в одно сообщение.
- Сообщения, отправленные до того, как агент начал отвечать, доходят до него вместе, одним ходом.
- Если он уже отвечает, новое сообщение вливается в текущий ответ: интеллект подхватывает его на следующем шаге, а ответ продолжается новым сообщением под твоим. Если интеллект не умеет принимать ввод посреди хода, сообщение станет следующим ходом.
- Каждый агент работает как ресепшен. Быстрое он отвечает сам, а всё, где есть шаги (поиск, код, проверки, длинные тексты), сразу отправляет в задачу на стороне и одной строкой говорит, что запустил. Диалог остаётся свободным, можно писать дальше. Как устроены задачи — в разделе Задачи, расписания и «Входящие».
- Твои собственные диалоги никогда не ждут в очереди. Задачи и переписка агентов между собой ждут, если интеллект занят (Параллельных сессий на интеллект в Настройки → Общие).
Строка текущего шага
Пока агент работает, под его именем вместо точек «печатает» видна короткая строка о том, что он делает прямо сейчас: Читает plan.md, Выполняет: npm test, В интернете…, Запускает задачу…, Пишет коллеге…. Если действию нужно твоё «да», строка становится жёлтой: Ждёт вашего разрешения (см. Подтверждения и автомод). Когда начинают идти слова ответа, строка уступает им место.
Ответ на твоё сообщение
Если задача закончилась, когда ты уже успел написать о другом, отчёт агента приходит ответом: над ним цитата твоей исходной просьбы. Нажми на цитату (Ответ на ваше сообщение: показать его), и чат прокрутится к тому сообщению.
Остановка
Пока агент отвечает, кнопка отправки превращается в Остановить. Она обрывает текущий ответ. В групповом чате не ответят и те участники, кто ещё ждал своей очереди. Если ничего не идёт, появится Нечего останавливать.
Уже запущенные задачи кнопка не отменяет. Скажи «отмени это», и агент отменит задачу, или нажми Отменить на странице задачи.
Шаги и значок модели
В меню ⋯ в верхней строке чата есть Показывать шаги. Если включить, в чате видны вызовы инструментов и служебные сообщения, которые обычно скрыты. В диалоге агента в том же меню — Настройки агента.
Маленький значок после времени каждого ответа (Как сделан этот ответ) по нажатию показывает, какие Интеллект, Модель и Глубина его дали.
Кнопки и карточки
Быстрые ответы
Когда ответ — один из нескольких понятных вариантов, агент ставит под сообщением кнопки: «По утрам», «Два раза в день», «Да». Нажатие отправляет текст варианта как твоё сообщение, и кнопки замирают на выбранном. Вместо кнопки всегда можно написать что угодно своими словами.
Живые карточки
Многое появляется в сообщениях агента карточками, и карточки меняются на месте по ходу дела:
- строка задачи со статусом и текущим шагом (нажми, чтобы открыть задачу);
- черновик нового агента, пока вы его вместе собираете, с кнопкой Создать агента;
- карточка канала: как часто он выходит, Собрать сейчас и Пауза;
- карточки подтверждения с кнопками Разрешить, Отклонить и Разрешать такое всегда;
- карточки входа в интеллект или сервис, карточка с просьбой о ключе, который сразу уходит в хранилище, страница, которую сделал агент.
Всё, что делает карточка, можно сказать и словами в чате.
Что показывают агенты
Оформление
Ответы — это Markdown: заголовки, списки, таблицы, ссылки и блоки кода с кнопкой копирования. Сырой HTML показывается простым текстом и никогда не выполняется.
Картинки и карусели
Агент может показать картинки прямо в чате: одну — карточкой, от двух до десяти — каруселью, которую листаешь. Нажми, чтобы открыть на весь экран. Картинки, которые показала задача, попадают и в диалог, из которого её запустили.
Картинки для чата загружает сам хаб, так что адрес картинки доходит до её сайта, как только ты её видишь. После того как агент прочитал внешний контент (веб-страницу, письмо), картинка с адресом, который он составил сам, сама не загружается: адрес может унести данные из чата на тот сайт. Вместо неё — тихая строка Картинка с и имя сайта и кнопка Показать: нажми, и картинка загрузится, дальше уже везде. Картинки из прочитанного, из твоих собственных сообщений и простые адреса на сайтах, которые ты назвал, загружаются как обычно. В карточке новости, посте канала и обложке страницы такой картинки просто не будет.
Карты и маршруты
Для мест, адресов и дороги агент показывает карту OpenStreetMap: места со значками и короткими подписями и маршрут через них. Пешие, автомобильные и велосипедные маршруты идут по настоящим дорогам и тропам, с длиной и временем в пути; общественный транспорт рисуется прямыми линиями.
- В чате карта не перехватывает прокрутку, пока по ней не кликнешь, так что чат листается мимо. Кнопки масштаба появляются, когда начинаешь ею пользоваться.
- На весь экран — там же список мест.
- Открыть в… открывает место или маршрут в Apple Карты, Google Карты или OpenStreetMap. Плагин Яндекс Карты и 2ГИС, включённый по умолчанию, добавляет эти два приложения.
Карточки новостей из каналов и страницы, которые делают агенты, описаны в разделах Каналы и Страницы.
Файлы, фото и скриншоты
Отправить файл можно тремя способами:
- скрепкой (Прикрепить файлы) рядом с полем;
- вставкой: скриншот или скопированный файл прикрепится сам;
- перетащив файлы в любое место чата (Отпустите, чтобы прикрепить файлы).
Файлы загружаются сразу, на каждом видна полоска загрузки. У неудавшегося появится кнопка повтора; любой можно убрать до отправки. В одном сообщении до 10 файлов, каждый до 25 МБ, с текстом или без.
Отметки на картинке перед отправкой
У картинки, которая ждёт в поле, есть кнопка с карандашом (Отметить). Она открывает картинку на весь экран: Перо, Маркер, Стрелка, Рамка, Овал и Текст, шесть цветов, три толщины, Отменить и Повторить. Готово заменяет картинку копией с отметками, и на ней появляется подпись с отметками.
Куда попадают файлы
Отправленный файл сохраняется в папке агента для этого чата, внутри папки данных хаба: workspaces/<агент>/<чат>/attachments/. Агент получает путь к файлу и открывает его своими инструментами.
Просмотр
Нажми на картинку или видео в чате, и откроется просмотр. В нём все картинки и видео этого чата:
- щипок, колесо мыши или двойное касание приближают, перетаскивание двигает приближенную картинку;
- свайп или стрелки — к следующему, свайп вниз или Закрыть — выйти;
- Скачать сохраняет файл (приложение для компьютера кладёт его в «Загрузки», приложение для iPhone открывает меню «Поделиться»), а Открыть оригинал открывает сам файл.
Остальные файлы показываются плашкой, которая открывает файл.
Голосовые сообщения
Голосовые и аудиофайлы превращаются в текст до того, как агент ответит. Расшифровка видна под голосовым, и агент читает её как обычное сообщение.
- Так расшифровываются голосовые из Telegram и аудиофайлы, которые ты прикрепляешь.
- Микрофон в приложении для iPhone устроен иначе: зажми его, говори, отпусти, и диктовка самого телефона отправит твои слова текстом. Настраивать ничего не нужно.
Как включить расшифровку
Напиши «настрой голосовые». Ассистент попросит ключ API Groq или OpenAI карточкой, которая кладёт его прямо в хранилище. У Groq есть бесплатный тариф. Как только ключ в хранилище, голосовые работают.
То же самое есть в Настройки → Общие → Голосовые сообщения. В поле Расшифровка речи выбираешь одно из:
| Вариант | Что используется |
|---|---|
| Автоматически: OpenAI или Groq, чей ключ есть в хранилище | По умолчанию. Сначала OpenAI, потом Groq |
| Groq (есть бесплатный тариф) | groq_api_key в хранилище, модель whisper-large-v3-turbo |
| OpenAI | openai_api_key в хранилище, модель gpt-4o-mini-transcribe |
| Свой сервер (OpenAI-совместимый) | Адрес сервера (до /audio/transcriptions, например локальный Whisper на http://127.0.0.1:8000/v1), Модель и, если серверу нужен ключ, Ключ в хранилище (vault://…) |
| Выключено | Ничего не расшифровывается |
Для Groq и OpenAI Модель можно не заполнять. Строка под выбором показывает Сейчас работает: … или Не настроено: голосовые доходят до агента аудиофайлами. Если ничего не настроено, агент получает аудиофайл и сам предлагает настроить расшифровку.
Ограничения: записи длиннее 10 минут и файлы больше 25 МБ сами не расшифровываются. Длинную запись агент всё равно может расшифровать, если попросить.
Собственные команды хаба
Набери / в начале поля, и появится список команд. На эти шесть отвечает сам хаб, сразу и без модели. Исключение — /schedule: она уходит агенту как просьба.
| Команда | Что делает |
|---|---|
/task <что сделать> | Запускает задачу для агента этого чата и показывает её строку. /task найди три квартиры у парка |
/goal <чего добиться> | Долгая цель: агент сам идёт к ней ход за ходом, пока не достигнет. /goal без слов показывает текущую цель |
/schedule <когда и что> | Просит агента настроить повторяющееся расписание или разовое напоминание. /schedule без слов покажет, что уже есть |
/brain [название] | Показывает, на чём думает агент, или переключает его интеллект в этом чате: /brain codex |
/effort [уровень] | Показывает или задаёт, как глубоко он думает: авто, быстро, сбалансированно, глубоко или уровень самого интеллекта, например высокая |
/archive | Показывает карточку, чтобы отправить агента в архив |
В чате одна цель за раз: новая /goal заменяет текущую. Управлять ею — /goal пауза, /goal продолжить и /goal сброс (английские pause, resume, clear тоже работают). Через 20 ходов цель сама встаёт на паузу и сообщает об этом. Подробнее — в разделе Задачи, расписания и «Входящие».
Команда, которой нужны слова, при выборе из списка встаёт в поле, остальные отправляются сразу. Если отправить команду из Telegram, ответ придёт туда текстом со ссылкой на чат. В чатах настройки хаб на команды не отвечает.
Остальные имена в списке — команды из скиллов и плагинов: шаблон в Markdown, который становится просьбой к агенту, а $ARGUMENTS в нём заменяется словами после имени команды. Свои команды клади в commands/<имя>.md в папке данных хаба. Список — в Настройки → Скиллы и команды.
Групповые чаты
Групповой чат — это ты и от двух до восьми агентов команды. Первый участник — ведущий.
Напиши в диалоге любого агента «сделай группу с Исследователем и Ассистентом для плана поездки», и группа появится на вкладке Группы. Переименовать её, добавить или убрать участника, сменить ведущего можно, попросив в самой группе. То же есть в форме: Новая группа на вкладке Группы (Название, Участники, Ведущий) и кнопка с названием группы в её шапке (Настройки группы). Для группы в команде должно быть хотя бы два агента.
Кто отвечает
- Сообщение без упоминаний получает ведущий.
@имя(id или имя агента) обращается к этому участнику; если упомянуть нескольких, они ответят по очереди в том же порядке.@все(или@all) — ответят все, по очереди.- Агент может передать слово другому, упомянув его в своём ответе. На одно твоё сообщение не больше трёх таких передач, чтобы агенты не перекидывали слово бесконечно.
В шапке видно, кто отвечает сейчас и кто дальше (Исследователь отвечает… · дальше: Ассистент). Остановить обрывает весь круг.
Каждый участник читает, что сказали другие после его последнего ответа, но не больше 40 сообщений, а длинные сообщения обрезаются. В группе /task, /goal и /schedule уходят ведущему, а /brain, /effort и /archive нужно писать в личном диалоге агента.
Групповые чаты есть в веб-интерфейсе, в приложении для компьютера и в приложении для iPhone. В Telegram они не дублируются: туда идёт только диалог основного агента.
В личном диалоге агента @ тоже работает: появится список коллег, и агент напишет тому, кого ты назвал, а потом расскажет ответ.