Documentation Index
Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
Use this file to discover all available pages before exploring further.
Справочник возможностей интерфейса Велеса
Эта страница описывает расширенные функции графического интерфейса Велеса: поиск по чату, экспорт, файловый браузер, доску задач, предложения ассистента, настройки речи, лимиты, служебные события и используемые HTTP-маршруты.
Панели интерфейса
| Панель | Что делает |
|---|
| Чат | Сообщения, потоковый ответ, ход выполнения инструментов, вложения, поиск, экспорт |
| Сессии | История диалогов, подспециалисты, переименование, удаление, остановка ответа |
| Рабочая область | Агенты, память, расписания, доска задач, навыки, секреты |
| Файлы | Дерево файлов, редактор, вкладки, скачивание, удаление, переименование, перемещение |
| Настройки | Внешний вид, подключение, звук, голосовые фразы |
| Статус и лимиты | Состояние сервера, расход токенов, лимиты моделей, уведомление об обновлении |
Чат
Панель чата поддерживает:
- потоковый ответ ассистента;
- группировку вызовов инструментов и их результатов;
- сворачивание длинных технических блоков;
- журнал действий и индикатор обработки;
- подгрузку старой истории при прокрутке;
- кнопку остановки ответа;
- создание нового диалога;
- открытие путей рабочей области из сообщений;
- предпросмотр изображений и файловых вложений.
Глобальный поиск по чату открывается из интерфейса или палитры команд и использует текущую историю сообщений. При переходе к найденному сообщению интерфейс разворачивает его, если оно было скрыто.
Экспорт DOCX
Интерфейс Велеса умеет экспортировать разговор в DOCX на стороне браузера.
| Настройка | Смысл |
|---|
mode | Чистый экспорт или экспорт с техническими данными |
includeTools | Включать сообщения инструментов, системы и событий |
formatMarkdown | Преобразовывать Markdown в форматирование Word |
includeUserQuestions | Включать пользовательские сообщения |
includeTechnicalHeader | Добавлять технический заголовок |
word/numbering.xml, поэтому списки сохраняются как настоящие списки, а не как обычный текст.
Вложения и медиа
Интерфейс использует схему «сначала загрузить файл, потом отправить сообщение»:
- файл загружается через
/api/gateway/attachments;
- сообщение отправляет ссылки на загруженные файлы;
- Велес приводит медиа к единому виду в
message.attachments;
- браузер строит ссылки предпросмотра и скачивания через файловые маршруты рабочей области.
Поддерживаются изображения, документы и аудио. Для изображений есть полноэкранный просмотр и сжатие перед отправкой, если оно включено на стороне клиента.
Файловый браузер
Файловый браузер использует такие маршруты:
| Маршрут | Назначение |
|---|
GET /api/files/tree | Дерево файлов |
GET /api/files/read | Чтение файла |
PUT /api/files/write | Запись файла |
GET /api/files/download | Скачивание |
POST /api/files/delete | Удаление |
POST /api/files/rename | Переименование |
POST /api/files/move | Перемещение |
GET /api/files/raw | Необработанное содержимое для предпросмотра |
Память
Панель памяти работает с /api/memories и /api/memories/section. Она показывает разобранные записи памяти, категории и секции файлов памяти.
Типичные действия:
- добавить запись памяти;
- отредактировать запись;
- удалить запись;
- открыть секцию файла памяти;
- дождаться служебного события
memory.changed после изменений.
Память не предназначена для секретов и больших одноразовых фрагментов.
Сессии и подспециалисты
Панель сессий использует внутренние вызовы Велеса:
sessions.history;sessions.list;sessions.activate;sessions.patch;chat.abort;chat.send для создания подВелеса.
Интерфейс поддерживает:
- дерево корневых и дочерних сессий;
- подспециалистов;
- переименование;
- скрытые сессии;
- признак непрочитанных сообщений;
- стартовую инструкцию для новых подспециалистов;
- сведения о модели сессии.
ПодВелес создаётся через обычное сообщение в чат: интерфейс формирует инструкцию на создание подВелеса и ждёт появления дочерней сессии в списке.
Доска задач и предложения
Панель задач покрывает:
- создание задач;
- колонки статусов;
- быстрый просмотр;
- боковую панель с деталями;
- приоритеты и метки;
- входящие предложения ассистента.
Входящие предложения показывают, что Велес предлагает создать или обновить задачу. Пользователь может принять или отклонить предложение. Это полезно для рабочих процессов, где ассистент не должен менять доску без подтверждения.
Расписания
Панель расписаний работает с:
GET /api/crons;POST /api/crons;DELETE /api/crons/:id;POST /api/crons/:id/toggle;POST /api/crons/:id/run;GET /api/crons/:id/runs.
Через интерфейс можно создать задание, отключить его, запустить вручную и посмотреть прошлые запуски. Хранилище привязано к рабочей области: <workspace>/cron/jobs.json.
Навыки
Панель навыков читает /api/skills. Каталог объединяет навыки рабочей области и встроенные навыки; версия из рабочей области имеет приоритет при совпадении имени.
Описание навыка может переводиться по targetLanguage; кэш зависит от языка перевода и contentHash.
Секреты
Панель секретов работает поверх внутренних вызовов Велеса secrets.*:
GET /api/secrets — каталог целей с замаскированными значениями;POST /api/secrets/refresh — обновить статус.
OAuth-потоки вроде Codex возвращают браузеру только ссылку и статус. Токены доступа и обновления остаются внутри зашифрованного хранилища Велеса.
Настройки речи
Интерфейс разделяет:
- режим распознавания речи: браузер, локальный обработчик или гибридный режим;
- запись голосового ввода;
- поддержку фразы пробуждения;
- голосовые фразы;
- настройки озвучивания ответов.
Основные маршруты:
| Маршрут | Назначение |
|---|
GET /api/tts/config | Текущие настройки озвучивания |
PUT /api/tts/config | Сохранить настройки озвучивания |
GET /api/voice-phrases | Фразы управления |
GET /api/voice-phrases/status | Статус фраз |
GET /api/voice-phrases/:lang | Фразы для языка |
PUT /api/voice-phrases/:lang | Обновить фразы |
[voice], чтобы внутренняя логика могла отличить голосовой ввод и при необходимости запустить озвучивание ответа.
Настройки интерфейса
Настройки внешнего вида управляют:
- языком интерфейса;
- темой;
- шрифтом;
- размером шрифта;
- показом служебных событий и журнала действий.
Настройки подключения управляют адресом сервера Велеса, токеном и поведением при переподключении. Проверка входа использует /api/auth/status; вход и выход идут через /api/auth/login и /api/auth/logout.
Лимиты и статус
Интерфейс показывает служебную информацию:
| Маршрут | Назначение |
|---|
/api/tokens | Расход токенов |
/api/claude-code-limits | Лимиты Claude Code |
/api/codex-limits | Лимиты Codex |
/api/version | Версия интерфейса |
/api/version/check | Проверка обновления |
/api/server-info | Информация о сервере |
/health | Проверка доступности |
Графики и Markdown
Отрисовщик сообщений поддерживает:
- Markdown;
- действия для блоков кода;
- извлечение встроенных графиков;
- Lightweight Charts;
- виджет TradingView;
- блоки изменений и содержимого файлов.
Если Велес возвращает структурированный блок графика, интерфейс может показать его как интерактивный график, а не как простой текст.
Палитра команд и горячие клавиши
Палитра команд собирает быстрые действия: поиск, создание сессии, фокус ввода, переключение панелей и другие команды интерфейса.
Горячие клавиши завязаны на useKeyboardShortcuts, useInputHistory и useTabCompletion: ввод поддерживает историю сообщений и автодополнение по сессиям.
Служебные события
Интерфейс слушает события WebSocket и server-sent events:
- поток чата;
- ход выполнения инструментов;
- состояние ассистента;
- события расписаний;
- изменение памяти;
- ошибки;
- переподключение и восстановление.
При восстановлении мобильной вкладки интерфейс не должен полагаться только на переход состояния WebSocket. Надёжный путь — сверить chat.history и локальное состояние ответа.