> ## 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.

# Обмен сообщениями

> Как устроено общение с Велес.

# Обмен сообщениями: простое объяснение

Общение с Велес происходит через обмен сообщениями, так же, как и в любом мессенджере.

## Форматы сообщений

Велес понимает разные форматы (если в `config.json` настроены соответствующие провайдеры):

1. **Текст**: Обычные текстовые запросы, просьбы и инструкции.
2. **Голосовые сообщения**: Велес может переводить голос в текст, понимать суть и выполнять вашу задачу.
3. **Файлы и изображения**: Вы можете прикрепить документ или картинку к сообщению, и Велес проанализирует её содержимое.

## Как Велес обрабатывает сообщения

Когда вы отправляете запрос:

1. Велес читает ваше сообщение.
2. Он оценивает контекст текущей сессии и свои долгосрочные знания (память).
3. При необходимости он использует *Инструменты* (например, для поиска в интернете или чтения файлов проекта).
4. После того как все внутренние шаги выполнены, он формирует и отправляет вам ответ.

```mermaid theme={null}
sequenceDiagram
    participant User as Пользователь
    participant Велес as Велес Агент
    participant Tool as Инструменты/Навыки
    participant Memory as Долгосрочная память

    User->>Велес: Отправка сообщения
    Велес->>Memory: Загрузка ограниченной копии USER.md и memory/MEMORY.md
    Memory-->>Велес: Контекст загружен
    
    alt Нужны инструменты?
        Велес->>Tool: Вызов инструмента/навыка
        Tool-->>Велес: Результат работы
    end
    
    Велес->>User: Ответ на сообщение
```

## Советы по написанию сообщений

* **Будьте конкретны**: Чем точнее вы опишете задачу, тем меньше уточняющих вопросов задаст Велес.
* **Используйте форматирование**: Если вы просите Велеса написать код, вы можете использовать Markdown или чётко указать границы.
* **Один запрос — одна задача**: Старайтесь не смешивать множество не связанных друг с другом задач в одно сообщение. Это повысит качество и скорость ответа.