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. Для длительной работы заведите задачу на доске или попросите Велеса сделать это за вас.

​
Как писать хорошие запросы

Хороший запрос описывает не только действие, но и критерий готовности. Плохо: 
Посмотри документ.
Лучше: 
Прочитай прикреплённый договор и составь список рисков для меня как исполнителя.
Раздели ответ на "критично", "важно" и "можно уточнить".
Не переписывай весь договор, дай выводы простым языком.
Для рабочих задач полезно добавлять:
  • что именно нужно получить;
  • какой формат нужен на выходе;
  • что считать ошибкой или неприемлемым результатом;
  • можно ли Велесу менять файлы;
  • нужно ли задавать уточняющие вопросы перед началом.

​
Чат и сессии

Сессия — это отдельная история общения. Используйте новые сессии, когда меняется тема или проект. Так Велесу проще держать контекст, а вам проще возвращаться к прошлым обсуждениям. Практическое правило:
  • одна сессия для одной темы, клиента, документа или задачи;
  • новая сессия для нового направления работы;
  • старую сессию оставляйте, если важна история решений.
Подробнее: Сессии и Обмен сообщениями.

​
Файлы и рабочая область

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

​
Память

Память нужна для сведений, которые должны пережить одну сессию: ваши предпочтения, правила проекта, постоянные ограничения, важные решения, справочные факты. Не стоит сохранять в память всё подряд. Чем чище память, тем полезнее она в будущих задачах. Хорошие кандидаты для памяти:
  • “Всегда отвечай мне на русском”;
  • “В этом проекте не запускать тесты без отдельного разрешения”;
  • “Основной клиентский язык интерфейса — русский”;
  • “Для отчётов использовать структуру: вывод, детали, риски, следующий шаг”.
Плохие кандидаты:
  • одноразовые черновики;
  • временные ссылки;
  • большие фрагменты текста без обобщения;
  • секреты, токены и пароли.
Подробнее: Память Велеса и Долговременная память.

​
Задачи и напоминания

Для работы, которую нужно отслеживать, используйте доску задач. Она подходит для поручений с этапами: “запланировано”, “в работе”, “на проверке”, “готово”. Для действий по времени используйте фоновые задачи:
  • одноразовые напоминания;
  • регулярные проверки;
  • периодические сообщения;
  • задачи, которые должны выполняться без открытого чата.
Подробнее: Фоновые задачи.

​
Голос и мобильная работа

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

​
Секреты

Секреты — это API-ключи, токены и OAuth-подключения. В Велес их нужно настраивать через панель секретов, а не вставлять в чат. Никогда не отправляйте в сообщении:
  • API-ключи;
  • пароли;
  • refresh tokens;
  • приватные SSH-ключи;
  • одноразовые коды входа.
Если Велесу нужен доступ к внешнему сервису, настройте секрет в интерфейсе или попросите администратора сделать это. Подробнее: Секреты и токены.

​
Маршрут для первого дня

  1. Если Велес ещё не установлен, начните с установки и первого запуска.
  2. Прочитайте Интерфейс Велеса.
  3. Создайте отдельную сессию для первой реальной задачи.
  4. Попросите Велеса объяснить, какие файлы или данные ему нужны.
  5. Приложите документы или создайте файлы в рабочей области.
  6. После результата попросите Велеса кратко записать устойчивые правила в память.
  7. Если задача продолжается, перенесите её на доску задач.