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.

Как устроен Велес

Эта страница объясняет Велес как единый продукт. Внутренние названия компонентов здесь не важны: пользователь работает с Велесом, а Велес уже сам связывает чат, модели, инструменты, файлы, память и фоновые задачи.

Общая схема

Поток сообщения

  1. Пользователь отправляет сообщение в Велес.
  2. Велес определяет текущую сессию и загружает нужный контекст.
  3. Модель анализирует задачу.
  4. Если нужны действия, Велес использует инструменты: читает файлы, ищет информацию, обращается к памяти, создаёт задачу или запускает внешний сервис.
  5. Результаты инструментов возвращаются в модель.
  6. Велес сохраняет историю и показывает ответ пользователю.

Основные части

ЧастьДля чего нужна
ЧатОсновное общение с Велесом
СессииРазделение диалогов по темам и задачам
Рабочая областьФайлы, документы, память и результаты работы
ПамятьДолгосрочный контекст, который нужен в будущих сессиях
ИнструментыДействия за пределами обычного ответа текстом
НавыкиГотовые сценарии работы для целых классов задач
КаналыСпособы общаться с Велесом: веб-чат, Telegram и другие интеграции
Фоновые задачиНапоминания, регулярные проверки и автоматические действия

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

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

Память и история

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

Инструменты

Инструменты позволяют Велесу выполнять практические действия:
  • читать и редактировать файлы;
  • искать информацию;
  • разбирать документы;
  • обращаться к внешним сервисам;
  • создавать фоновые задачи;
  • работать с долговременной памятью.
Набор инструментов зависит от конфигурации конкретной установки.

Секреты

API-ключи, токены и OAuth-подключения не должны попадать в чат. Велес хранит и использует секреты отдельно, а в интерфейсе показывает только состояние: настроен секрет или нет.

Что читать дальше