Skip to main content

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.

​
Интерфейс Велеса для продвинутой работы

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

​
Подключение к серверу Велеса

Интерфейс подключается к серверу Велеса. Для подключения нужен адрес сервера и токен доступа. Сервер должен быть запущен: 
nanobot gateway
Если интерфейс не может получить статус сервера, проверьте:
  • gateway.host и gateway.port;
  • gateway.token;
  • доступность WebSocket;
  • что интерфейс и сервер используют правильную конфигурацию и рабочую область.

​
Каталог моделей

Интерфейс берёт список моделей из конфигурации Велеса: 
{
  "agents": {
    "defaults": {
      "model": "openrouter/openai/gpt-5.4",
      "models": [
        { "id": "openrouter/openai/gpt-5.4", "label": "GPT 5.4" },
        { "id": "openrouter/anthropic/claude-sonnet-4-6", "label": "Claude Sonnet" }
      ]
    }
  }
}
Переключение модели в интерфейсе влияет на текущую сессию. Чтобы поменять модель по умолчанию, измените config.json.

​
Сессии

Интерфейс показывает активные сессии и архивы. У сессии есть ключ, модель, состояние и история. Операции:
  • создать новую сессию;
  • переключиться на старую;
  • скрыть или удалить сессию;
  • открыть дочерние сессии и подспециалистов;
  • восстановить историю после переподключения.
Поведение удаления зависит от tools.sessionMemory.deleteBehavior.

​
Рабочая область

Рабочая область в интерфейсе работает как файловая панель. Если папка доступна серверу Велеса напрямую, файлы читаются локально. Если нет, операции с файлами идут через серверный слой доступа. Это важно для удалённых установок:
  • не полагайтесь на локальный путь браузера;
  • сервер Велеса остаётся источником правды для файлов ассистента;
  • скачивание и удаление должны идти через серверные операции рабочей области;
  • удаление файлов постоянное и не является перемещением в корзину.

​
Вложения

Вложения в веб-чате работают по схеме “сначала загрузить файл, потом отправить сообщение”:
  1. клиент загружает файл в рабочую область;
  2. сообщение отправляет ссылки на вложения;
  3. Велес привязывает файлы к сообщению;
  4. ассистент работает с файлами как с частью рабочей области.
Старый формат встроенных вложений в теле сообщения не поддерживается.

​
Секреты

Раздел секретов показывает только состояние: значение настроено или отсутствует. Интерфейс Велеса не получает сохранённые значения. Через панель можно:
  • увидеть отсутствующие значения;
  • сохранить локальный зашифрованный секрет;
  • подключить или отключить поддерживаемые OAuth-профили;
  • проверить, какие секреты нужны навыкам.
Мастер-ключ должен быть только у серверного процесса Велеса, не у браузера.

​
Навыки

Интерфейс показывает навыки из рабочей области и встроенного каталога. Описания могут переводиться по выбранному языку; кэш привязан к языку и версии содержимого. Если описание не переведено, это не означает, что навык недоступен. Важно наличие SKILL.md и ресурсов навыка.

​
Расписания

В интерфейсе можно видеть фоновые задания и их текущее состояние. Хранилище расписаний находится в рабочей области: 
<workspace>/cron/jobs.json
Автоматические ответы должны попадать в историю канала, иначе пользователь увидит результат в мессенджере, но потеряет его в интерфейсе Велеса.

​
Доска задач

Доска задач помогает вести работу как процесс:
  • отложено;
  • запланировано;
  • в работе;
  • на проверке;
  • готово.
Используйте задачи для длительной работы, где важно видеть состояние, а не только последний ответ в чате.

​
Голос

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

​
Переподключение и мобильное восстановление

На мобильных устройствах возврат приложения из фона может не показать все промежуточные состояния соединения. Интерфейс Велеса должен сверять историю чата и очищать локальное состояние генерации, если история уже содержит завершённый ответ. Если пользователь вернулся в приложение и видит “генерация идёт”, сначала обновите историю сессии. Не отправляйте тот же запрос повторно, пока не проверите, появился ли ответ.

​
Диагностика

Если интерфейс Велеса ведёт себя странно:
  • проверьте, что сервер запущен;
  • проверьте токен;
  • откройте список сессий и сравните session key;
  • проверьте, что нужная модель есть в agents.defaults.models;
  • проверьте путь рабочей области в конфигурации;
  • для удалённой рабочей области проверьте серверные файловые операции;
  • для секретов проверьте NANOBOT_SECRETS_MASTER_KEY.
Для полного списка панелей и менее очевидных функций смотрите Справочник возможностей интерфейса Велеса.