Настройки и переменные окружения

Почти всё в Piomio настраивается в чате: говоришь, что нужно, а ассистент меняет это сам или показывает карточку с кнопками. Панель Настройки — второй путь к тому же самому, плюс несколько вещей, которые можешь менять только ты. Переменные окружения нужны для того, что хаб должен знать ещё до запуска: адреса, порты, папки и стены безопасности.

Настройки в чате#

Просто скажи: «включи тихие часы с 22:00», «мой часовой пояс — Europe/Moscow», «присылай сводку в 8:30 и 18:00», «отвечай по-английски». Ассистент может поменять:

• часовой пояс, язык хаба и агента по умолчанию;
• тихие часы, время сводок и число уведомлений в час;
• число параллельных сессий на интеллект;
• уходят ли ответы агента по умолчанию на то, что ты пишешь в веб-интерфейсе, ещё и в Telegram;
• автоматический режим или вопрос тебе каждый раз (включение автоматического режима сначала покажет карточку, смотри Подтверждения и автоматический режим).

Ещё он подключает плагины и сервисы, меняет их настройки и создаёт агентов. Остальное на странице Общие меняешь только ты: списки разрешённых хостов, сроки подтверждений, детали в Telegram и расшифровку речи. Если попросишь об этом ассистента, он отправит тебя в панель.

Панель настроек#

Настройки внизу боковой панели открывают панель рядом с чатом (на телефоне — на весь экран). Её разделы:

Общие#

Собственные настройки хаба. Поменяй нужное и нажми Сохранить (кнопка есть вверху и внизу). Они действуют на весь хаб, а страница подхватывает то, что ассистент тем временем поменял в чате.

Часовой пояс и агент по умолчанию#

• Часовой пояс: для расписаний, тихих часов и сводок. Сначала это часовой пояс компьютера (TZ).
• Агент по умолчанию: открывается первым, отвечает в Telegram и берёт новые задачи. Агент из архива быть им не может.

Язык#

• Язык интерфейса в этом браузере: хранится только в этом браузере; после смены страница перезагрузится.
• Язык хаба: на нём приходят уведомления, сообщения в Telegram, карточки подтверждений и ответы агентов, и на нём же показывается интерфейс в браузерах, где язык не выбран. Он берётся из браузера первого пользователя при настройке, если его не закрепил PIOMIO_LANG.

Уведомления#

• Тихие часы (включены, с 23:00 до 08:00): уведомления приходят без звука, а неважное копится до утра.
• Время сводок (09:00 и 19:00): введи ЧЧ:ММ и нажми Enter, чтобы добавить.
• Уведомлений в час (4, от 0 до 100): лимит срочных уведомлений на один триггер.

Смотри про задачи, расписания и входящие.

Подтверждения#

• Ждать ответа в ходе, сек (45, от 0 до 600): сколько агент ждёт твоего решения, прежде чем отложить действие.
• Срок подтверждения, ч (24, от 1 до 720): после этого запрос отменяется.
• Показывать детали в Telegram (выключено): полные параметры действия в сообщении Telegram. Если выключено — только краткое описание и ссылка на пульт.

Смотри Подтверждения и автоматический режим.

Интеллект#

• Параллельных сессий на интеллект (2, от 1 до 16): сколько задач и переписок агентов идёт одновременно на одном интеллекте одного компьютера. Остальные ждут в очереди, а разговоры с тобой не ждут никогда.
• Дополнительные разрешённые хосты: куда интеллекту можно ходить в сеть помимо стандартного списка (Anthropic, OpenAI, Kimi, GitHub, npm и похожие). Работают маски вида *.example.com.

Голосовые сообщения#

Голосовые и аудиофайлы превращаются в текст до ответа агента.

• Расшифровка речи: Автоматически: OpenAI или Groq, чей ключ есть в хранилище (по умолчанию), Groq (есть бесплатный тариф), OpenAI, Свой сервер (OpenAI-совместимый) или Выключено. Ключи — groq_api_key и openai_api_key в хранилище; ассистент сам попросит ключ в чате, когда он понадобится.
• Модель: пусто — модель сервиса по умолчанию.
• Адрес сервера и Ключ в хранилище: для своего сервера, например локального Whisper. Адрес — до /audio/transcriptions, например http://127.0.0.1:8000/v1.

Под выбором видно, что работает сейчас, или что ничего не настроено и голосовые доходят до агента аудиофайлами.

Карточки плагинов#

У каждого плагина с настройками здесь своя карточка: его ключи, которые вводятся прямо в хранилище, и его собственные параметры. Смотри про плагины и интеграции.

Безопасность#

Открыть пульт открывает пульт безопасности: там пароль, ключи доступа (passkeys), хранилище, правила и журнал аудита. Выйти завершает сессию в этом браузере.

Это приложение#

Только в приложении для компьютера: Выйти из Piomio выключает его до следующего запуска, а Сбросить Piomio… удаляет всё, что он хранит на этом компьютере, после вопроса. Смотри Установка на Mac или ПК.

Настройки без поля#

egressPrivateAllow — хосты в твоей локальной сети, к которым можно плагинам и интеллекту, например searxng или nas.local: иначе фильтр исходящих соединений частные адреса не пускает. Чтобы задать список, открой чат в браузере, открой на этой вкладке консоль разработчика и выполни:

const { csrf } = await (await fetch("/api/bootstrap")).json();
await (await fetch("/api/settings", { method: "PATCH", headers: { "content-type": "application/json", "x-csrf": csrf }, body: JSON.stringify({ egressPrivateAllow: ["searxng", "nas.local"] }) })).json();

Новый список целиком заменяет старый и действует сразу.

Переменные окружения#

Куда их писать#

desktop.json выглядит так: {"port": 19000}. Пульт тогда займёт следующий порт, а прокси исходящих соединений — порт + 9, если consolePort и egressPort не говорят иначе.

Адреса и порты#

Телефоны, доступ из любого места и другие машины#

Данные, язык и время#

Интеллект и безопасность#

Интеграции, карты и браузер#

Обновления#

Установщики#

Для разработки#

PIOMIO_APP_ROOT (папка приложения), PIOMIO_PLUGINS (all, none или список встроенных плагинов для запуска), PIOMIO_DEBUG (все строки журналов плагинов в журнале хаба, а не только ошибки), PIOMIO_DEV_ORIGIN и PIOMIO_CONSOLE_DEV_ORIGIN (dev-серверы интерфейсов), а ещё PIOMIO_GOOGLE_AUTH_URL, PIOMIO_GOOGLE_TOKEN_URL, PIOMIO_GOOGLE_REVOKE_URL, PIOMIO_GOOGLE_USERINFO_URL. PIOMIO_DESKTOP, PIOMIO_DESKTOP_APP и PIOMIO_DESKTOP_PORT приложение для компьютера задаёт само.

Порты#

Чат и пульт слушают на 127.0.0.1, если PIOMIO_HOST не говорит иначе; прокси — всегда там. Порт для телефонов слушает на всех адресах, чтобы до него доставали телефоны дома.

Файлы и папки#

Установка тех времён, когда Piomio назывался Owlbot, сохраняет свою папку Owlbot. В папке данных: piomio.db (чаты, агенты, задачи, настройки), vault.db (хранилище, зашифрованное), workspaces (рабочие папки агентов), plugins и plugins-data (установленные плагины и их данные, включая память), agents, skills, commands, pages, tailnet (узел доступа из любого места), devices (сертификат для телефонов), tools (CLI, поставленные из чата) и backups.