Что такое карточка ИИ-персонажа: простыми словами
Карточка персонажа — это файл, который задаёт ИИ характер, манеру речи и первую сцену. Разбираем, что внутри, чем CCv1 и CCv2 отличаются от CCv3 и как карточка превращается в живой диалог.
- Автор
- Scenly
- Опубликовано
TL;DR
- Карточка персонажа — это текстовый файл, который описывает ИИ-персонажу, кем он является, как говорит и с чего начинается разговор.
- Внутри карточки лежат поля: имя, описание, характер, сценарий, первое сообщение, примеры диалогов и лорбук.
- Карточка хранится в файлах трёх видов: JSON — только текст, PNG — тот же текст, вложенный внутрь картинки, CHARX — архив с карточкой и её файлами.
- Scenly понимает все версии спецификации — CCv1, CCv2 и CCv3 — и сам повышает старую до новой при импорте.
- Карточка — это данные. Она начинает работать, когда вы открываете чат: перед каждым ответом платформа собирает из неё запрос к модели.
Что такое карточка персонажа
Представьте, что вы придумали героя: как он выглядит, как разговаривает, что скрывает, чего хочет. Если просто написать это в чат, модель забудет половину через десять сообщений. Карточка решает эту проблему: она хранит описание персонажа в одном файле и каждый раз подставляется в запрос к модели.
Грубо говоря, карточка — это долговременная память персонажа. Всё, что в ней написано, модель видит перед каждым ответом. Всё, чего в ней нет, модель придумает сама — и придумает заново в следующем сообщении.
В Scenly карточка — это не отдельная сущность, а сам персонаж. Когда вы создаёте персонажа, вы заполняете поля карточки. Когда начинаете чат, платформа берёт эти поля и собирает из них запрос к модели.
Что внутри карточки
Карточка — это один JSON-объект. Внутри него есть блок data, а уже в нём — все знакомые поля.
{
"spec": "chara_card_v3",
"spec_version": "3.0",
"data": {
"name": "Ася",
"description": "Кто этот персонаж и как он относится к собеседнику",
"personality": "Маска, страх, желание и правила поведения",
"scenario": "Где и когда происходит действие, что уже случилось",
"first_mes": "Стартовое сообщение нового чата",
"mes_example": "Короткие примеры реплик",
"system_prompt": "Стиль речи и правила, которые модель должна соблюдать",
"post_history_instructions": "Последние инструкции после истории чата",
"creator_notes": "Описание для людей на странице персонажа",
"tags": ["цундере", "драма"],
"alternate_greetings": [],
"character_book": {}
}
}
Смысл каждого поля — в следующем разделе. Пока важно одно: карточка — это текст, а не картинка. Картинка к ней может прилагаться, но живёт отдельно.
Разбор каждого поля с лимитами и примерами — в статье «Все поля карточки персонажа».
Два слоя: что видит ИИ, а что видят люди
Это главное, что стоит понять про карточку, и это отличает её от обычного описания товара или профиля.
Слой для модели. Описание, характер, сценарий, примеры диалогов, системный промпт, финальные инструкции и лорбук. Всё это уходит в модель перед каждым ответом. На странице персонажа этих текстов нет — их видит только ИИ.
Слой для людей. Имя, публичное описание «О персонаже», метки, обложка и первое сообщение. Это то, что видят посетители каталога, когда выбирают, с кем поговорить.
Из этого следует простое правило: не пишите в описании то, что хотите показать людям, и не пишите в публичном описании инструкции для модели. Модель не читает публичное описание, а люди не читают промпт.
| Поле | Кто видит |
|---|---|
| Имя, метки, обложка | Все |
| Публичное описание «О персонаже» | Все |
| Первое сообщение | Все |
| Описание, характер, сценарий | Только ИИ |
| Примеры диалогов | Только ИИ |
| Системный промпт, финальные инструкции | Только ИИ |
| Лорбук | Только ИИ |
CCv1, CCv2 и CCv3: в чём разница
Спецификация карточек развивалась, и сейчас в ходу три версии.
CCv1 (chara_card_v1) — самая старая. Плоский JSON без блока data: все поля лежат в корне файла. В ней есть только база — имя, описание, характер, сценарий, первое сообщение, примеры диалогов. Такие карточки до сих пор гуляют по старым коллекциям.
CCv2 (chara_card_v2) — то, что большинство людей видит в карточках и в большинстве гайдов. Поля переехали в блок data, добавились системный промпт, финальные инструкции, заметки автора, метки и расширения.
CCv3 (chara_card_v3) — текущая версия. Она добавляет:
- Псевдоним — отдельное имя, которое подставляется вместо имени персонажа в репликах. Удобно, когда имя длинное или когда хочется, чтобы в диалоге герой звучал иначе, чем в каталоге.
- Групповые приветствия — отдельный список стартовых сообщений.
- Даты создания и изменения карточки.
- Ассеты — файлы, привязанные к карточке: иконки, фоны и прочее. В формате CHARX они едут внутри архива.
- Мультиязычные заметки автора — описание для людей на разных языках.
- Источник — список площадок, откуда карточка пришла.
Практический вывод: писать карточку вручную проще в формате V2, а хранится и отдаётся она всё равно как V3. Scenly принимает все три версии и при импорте сам повышает старую до V3, добавляя недостающие поля пустыми. Вам не нужно ничего конвертировать руками.
Как перенести карточку из другого сервиса и чем JSON отличается от PNG и CHARX — в статье «Импорт и экспорт карточки».
Как карточка превращается в диалог
Это самая полезная часть для понимания, почему одни карточки работают, а другие нет.
Когда вы отправляете сообщение, платформа собирает запрос к модели примерно в таком порядке:
- Правила платформы. Как отвечать, в каком формате, на каком языке, что нельзя делать. Эти правила одинаковы для всех персонажей.
- Системный промпт карточки. Ваши инструкции высокого приоритета.
- Имя персонажа.
- Описание.
- Характер.
- Сценарий.
- Примеры диалогов.
- История чата — последние сообщения.
- Финальные инструкции — то, что модель видит последним перед ответом.
Два следствия из этого порядка.
Первое: начало важнее конца. Чем раньше в запросе стоит факт, тем сильнее он влияет на ответ. Поэтому описание и характер значат больше, чем финальные инструкции, — но финальные инструкции ближе к ответу и потому хорошо работают для правил формата.
Второе: контекст не бесконечный. Платформа ограничивает и количество сообщений в запросе, и общий объём текста. Когда чат становится длинным, из него вытесняются старые сообщения, а из карточки — необязательные блоки. Именно поэтому лорбук с мёртвыми ключами хуже, чем лорбук с живыми: бесполезные записи занимают место.
Подробный разбор — в статье «Сколько помнит контекст: почему персонаж забывает».
Где взять карточку
Есть три пути.
Создать с нуля. Самый долгий, но самый точный. Вы сами решаете, кем будет персонаж, и контролируете каждое поле.
Собрать в конструкторе. Промежуточный вариант: вы отвечаете на несколько вопросов — пол, возраст, роль, сеттинг, психотип, внешность, — а платформа собирает готовую карточку. Все поля можно оставить пустыми и положиться на случай. Получившуюся карточку можно дописать руками в обычной форме.
Импортировать готовую. Если у вас есть файл карточки в JSON, PNG или CHARX, его можно загрузить, а потом поправить поля под себя.
Как работает конструктор и какие психотипы в нём есть — в статье «Характер персонажа: маска, страх, желание и 12 психотипов».
Что происходит после создания карточки
Карточка сама по себе ничего не делает. Она начинает работать в трёх местах.
Страница персонажа. Здесь показываются имя, публичное описание, метки, обложка и первое сообщение. Здесь же можно начать чат.
Чат. Каждое сообщение собирает запрос из полей карточки и истории диалога. Модель отвечает в роли персонажа.
Экспорт. Карточку можно скачать в JSON, PNG или CHARX и перенести в другой сервис или поделиться ею.
Частые вопросы
Карточка — это то же самое, что персонаж? На практике да. В Scenly персонаж — это карточка плюс обложка, метки, доступ и настройки 18+.
Нужно ли уметь программировать, чтобы сделать карточку? Нет. Все поля заполняются в обычной форме, а файлы карточки нужны только для импорта и экспорта.
Можно ли обойтись без лорбука? Да, и большинство карточек обходится. Лорбук нужен, когда у персонажа много фактов, которые должны появляться только в подходящих сценах, а не в каждой реплике.
Карточка переносится в другие сервисы? Обычно да: формат открытый, и карточку в JSON или PNG понимают и другие площадки. Но набор поддерживаемых полей у всех разный, поэтому часть данных может не подхватиться.
Что будет, если оставить поле пустым? Ничего страшного. Модель просто не получит этой информации и придумает её сама. Обязательное поле только одно — имя персонажа.
Сколько карточек можно создать? Сейчас на аккаунте доступно до 200 персонажей. Лимиты на фото и на дневной объём обращений к моделям отдельные.
Что дальше
Если вы только начинаете, разумный порядок такой:
- Прочитать разбор всех полей карточки — понять, за что отвечает каждое поле.
- Написать описание персонажа — это основной текст, который модель читает чаще всего.
- Продумать характер — маску, страх, желание и то, что мешает герою получить желаемое.
- Написать первое сообщение — оно задаёт тон всему чату.
- Добавить примеры диалогов — самый быстрый способ повлиять на манеру речи.
- Проверить карточку по чеклисту типичных ошибок.
А если хочется быстрее — начните с конструктора персонажа: он соберёт карточку за вас, а вы допишете детали.
Когда карточка готова — начните чат: разберитесь, как устроен диалог с персонажем и что делать, если он «сломался». А чтобы задать себе имя и роль в разговоре — прочитайте про персоны.