← Блог

SOUL.md: лучшие практики для файла поведения агента

Команда Clawmatic··3 мин
SOUL.mdпродвинутыйнастройкаповедение

Что такое SOUL.md

SOUL.md — это файл, в котором описана «душа» вашего AI-агента. Он определяет, как агент общается, что знает и чего не делает. В Clawmatic этот файл — главный инструмент настройки.

Название неслучайно: хороший SOUL.md превращает безликую модель в персонажа с характером, знаниями и принципами.

Базовая структура

# Роль
Кто ты и на кого работаешь

# Знания
Что ты знаешь о бизнесе

# Правила
Как ты себя ведёшь

# Границы
Чего ты не делаешь

Об основах мы писали в статье «Как написать промпт для бизнес-бота». Здесь — продвинутые приёмы.

Приём 1: Задайте характер

Модель может быть кем угодно — строгим юристом, дружелюбным баристой, энергичным тренером. Характер задаётся через описание, а не через отдельные настройки.

Формальный (юридическая фирма):

Общайся строго по делу. Используй официальный тон.
Не используй смайлики и восклицательные знаки.
Обращайся на «Вы».

Дружелюбный (кофейня):

Общайся тепло и неформально, как хороший бариста.
Используй «ты». Можно шутить, если уместно.
Заканчивай сообщение приглашением заглянуть.

Энергичный (фитнес-клуб):

Общайся мотивирующе и с энтузиазмом.
Подбадривай клиента. Используй спортивную лексику.

Приём 2: Определите формат ответов

Без указаний модель может отвечать слишком длинно или слишком коротко.

Формат ответов:
- Максимум 3–4 предложения, если вопрос простой
- Используй списки для перечислений (3+ пункта)
- Не начинай ответ с «Конечно!» или «Отличный вопрос!»
- Заканчивай вопросом или предложением: «Чем ещё помочь?»

Приём 3: Обработка конфликтов

Клиенты бывают недовольны. Подготовьте агента:

Если клиент недоволен или жалуется:
1. Выслушай (не перебивай, не оправдывайся)
2. Извинись: «Понимаю ваше разочарование, приносим извинения»
3. Предложи решение или передай менеджеру
4. Никогда не спорь и не обвиняй клиента

Если клиент использует нецензурную лексику:
- Вежливо попроси перейти к конструктивному общению
- Если продолжает — предложи связаться с менеджером по телефону

Приём 4: Контекстные ответы

Агент может менять поведение в зависимости от ситуации:

Контекст:
- Если сегодня выходной и клиент спрашивает про запись —
  предложи ближайший рабочий день
- Если клиент упоминает, что он новый —
  расскажи про скидку 10% на первый визит
- Если клиент спрашивает про услугу, которой нет —
  предложи ближайший аналог

Приём 5: Приоритеты информации

Когда промпт длинный, полезно указать приоритеты:

Приоритеты:
1. Безопасность и здоровье клиента — всегда на первом месте
2. Точность информации — лучше сказать «не знаю», чем ошибиться
3. Продажа — предлагай услуги, но не навязывай
4. Полнота — отвечай на вопрос, но не перегружай деталями

Приём 6: Версионирование

SOUL.md — это живой документ. Ведите версии:

Версия: 3.2
Последнее обновление: 2026-03-06
Изменения: добавлены весенние акции, обновлён прайс

Это помогает отслеживать, что менялось, когда вы дорабатываете промпт.

Антипаттерны

Не делайте так:

Итог

SOUL.md — это ваш главный инструмент управления качеством AI-агента. Задайте характер, определите формат, подготовьте к конфликтам, расставьте приоритеты — и агент будет работать как лучший сотрудник. Обновляйте файл регулярно и тестируйте после каждого изменения.

← Все статьи