Карточки персонажей7 минут чтения

Что такое карточка ИИ-персонажа: простыми словами

Карточка персонажа — это файл, который задаёт ИИ характер, манеру речи и первую сцену. Разбираем, что внутри, чем 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 — в статье «Импорт и экспорт карточки».


Как карточка превращается в диалог

Это самая полезная часть для понимания, почему одни карточки работают, а другие нет.

Когда вы отправляете сообщение, платформа собирает запрос к модели примерно в таком порядке:

  1. Правила платформы. Как отвечать, в каком формате, на каком языке, что нельзя делать. Эти правила одинаковы для всех персонажей.
  2. Системный промпт карточки. Ваши инструкции высокого приоритета.
  3. Имя персонажа.
  4. Описание.
  5. Характер.
  6. Сценарий.
  7. Примеры диалогов.
  8. История чата — последние сообщения.
  9. Финальные инструкции — то, что модель видит последним перед ответом.

Два следствия из этого порядка.

Первое: начало важнее конца. Чем раньше в запросе стоит факт, тем сильнее он влияет на ответ. Поэтому описание и характер значат больше, чем финальные инструкции, — но финальные инструкции ближе к ответу и потому хорошо работают для правил формата.

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

Подробный разбор — в статье «Сколько помнит контекст: почему персонаж забывает».


Где взять карточку

Есть три пути.

Создать с нуля. Самый долгий, но самый точный. Вы сами решаете, кем будет персонаж, и контролируете каждое поле.

Собрать в конструкторе. Промежуточный вариант: вы отвечаете на несколько вопросов — пол, возраст, роль, сеттинг, психотип, внешность, — а платформа собирает готовую карточку. Все поля можно оставить пустыми и положиться на случай. Получившуюся карточку можно дописать руками в обычной форме.

Импортировать готовую. Если у вас есть файл карточки в JSON, PNG или CHARX, его можно загрузить, а потом поправить поля под себя.

Как работает конструктор и какие психотипы в нём есть — в статье «Характер персонажа: маска, страх, желание и 12 психотипов».


Что происходит после создания карточки

Карточка сама по себе ничего не делает. Она начинает работать в трёх местах.

Страница персонажа. Здесь показываются имя, публичное описание, метки, обложка и первое сообщение. Здесь же можно начать чат.

Чат. Каждое сообщение собирает запрос из полей карточки и истории диалога. Модель отвечает в роли персонажа.

Экспорт. Карточку можно скачать в JSON, PNG или CHARX и перенести в другой сервис или поделиться ею.


Частые вопросы

Карточка — это то же самое, что персонаж? На практике да. В Scenly персонаж — это карточка плюс обложка, метки, доступ и настройки 18+.

Нужно ли уметь программировать, чтобы сделать карточку? Нет. Все поля заполняются в обычной форме, а файлы карточки нужны только для импорта и экспорта.

Можно ли обойтись без лорбука? Да, и большинство карточек обходится. Лорбук нужен, когда у персонажа много фактов, которые должны появляться только в подходящих сценах, а не в каждой реплике.

Карточка переносится в другие сервисы? Обычно да: формат открытый, и карточку в JSON или PNG понимают и другие площадки. Но набор поддерживаемых полей у всех разный, поэтому часть данных может не подхватиться.

Что будет, если оставить поле пустым? Ничего страшного. Модель просто не получит этой информации и придумает её сама. Обязательное поле только одно — имя персонажа.

Сколько карточек можно создать? Сейчас на аккаунте доступно до 200 персонажей. Лимиты на фото и на дневной объём обращений к моделям отдельные.


Что дальше

Если вы только начинаете, разумный порядок такой:

  1. Прочитать разбор всех полей карточки — понять, за что отвечает каждое поле.
  2. Написать описание персонажа — это основной текст, который модель читает чаще всего.
  3. Продумать характер — маску, страх, желание и то, что мешает герою получить желаемое.
  4. Написать первое сообщение — оно задаёт тон всему чату.
  5. Добавить примеры диалогов — самый быстрый способ повлиять на манеру речи.
  6. Проверить карточку по чеклисту типичных ошибок.

А если хочется быстрее — начните с конструктора персонажа: он соберёт карточку за вас, а вы допишете детали.

Когда карточка готова — начните чат: разберитесь, как устроен диалог с персонажем и что делать, если он «сломался». А чтобы задать себе имя и роль в разговоре — прочитайте про персоны.