Свои шаблоны саммари

Шаблон саммари определяет, в каком виде CogniCo оформит итог записи: протокол встречи, карточка звонка, конспект лекции и т. д. Кроме встроенных шаблонов, вы можете создать собственные под задачи вашей команды, например ретроспективу, разбор инцидента или онбординг-звонок.

Встроенные шаблоны

Шаблон	Что получится
Общее саммари	Автоматически подберёт формат под содержание
Протокол встречи	Участники, решения, задачи с ответственными и сроками
CRM-карточка звонка	Компания, контакт, результат, следующий шаг
CustDev-отчёт	Боли респондента, цитаты, инсайты для продукта
Заметки терапевта	Темы сессии, инсайты, домашнее задание
Конспект лекции	Тезисы, определения, примеры, вопросы для самопроверки
HR-интервью	Вердикт, мотивация, soft skills, зарплатные ожидания
Таймкоды и анонс	Анонс выпуска и главы с таймкодами для описания видео на YouTube
Action Points	Только задачи и поручения из записи

Выбрать шаблон можно в меню ИИ на записи, пункт «Саммари».

Где хранятся свои шаблоны

Свой шаблон это YAML-файл в служебной папке .cognico/summary:

в разделе «Мои файлы» — личный шаблон, виден только вам;
в корпоративном пространстве — шаблон для всей организации.

Рекомендуем расширение .yaml. Имя файла без расширения является идентификатором шаблона: retro.yaml создаёт шаблон retro. Личный шаблон с тем же идентификатором, что у корпоративного, не применяется: действует корпоративный, поэтому выберите другой идентификатор.

Встроенные шаблоны переопределить нельзя: файл с идентификатором встроенного шаблона (GENERAL, WORK_MEETING, SALES_CALL, CUSTDEV_INTERVIEW, THERAPY_SESSION, LECTURE, HR_INTERVIEW, TIMECODES, ACTION_POINTS) с содержимым считается ошибкой, а встроенный шаблон остаётся как есть. Название (name) встроенного шаблона тоже занято: свой шаблон с таким же названием (без учёта регистра и эмодзи) будет отклонён, даже если встроенный скрыт.

Можно скрыть ненужный встроенный шаблон и создать свой с другим идентификатором и названием. Чтобы скрыть, положите файл <ID>.yaml, в котором только одна строка tombstone: true. Личный такой файл скрывает шаблон только у вас, корпоративный — у всей организации. GENERAL тоже можно скрыть — он пропадёт из меню, но останется всегда как запасной шаблон (выбирается автоматически, если запись ни под что не подошла).

Например, чтобы заменить протокол встречи своим, создайте WORK_MEETING.yaml:

tombstone: true

и рядом team-protocol.yaml с вашим шаблоном (формат ниже) под новым названием, например «Протокол команды».

Добавленный шаблон появляется в меню ИИ, в пункте «Саммари», рядом со встроенными.

Самый простой способ: попросить ИИ

Не нужно писать YAML вручную. Опишите словами, какое саммари вам нужно, и попросите ИИ-агента создать шаблон:

в чате CogniCo;
в любом MCP-клиенте (Claude Code, Claude Desktop и др.), подключённом к CogniCo, см. MCP. У MCP-сервера есть встроенный гайд по шаблонам саммари: агент сам соберёт файл в нужном формате, проверит его и положит в нужную папку.

Пример запроса: «Создай шаблон саммари для ретроспектив спринта: что получилось, что нет, договорённости. Сделай его общим для организации».

Формат файла

version: 1
name: Ретроспектива
description: Что получилось, что нет, договорённости
icon: rotate-ccw
order: 100
classifier:
  description: A team retrospective about the last iteration.
  rules:
    - "When unsure between RETRO and WORK_MEETING: if the meeting looks back at a finished iteration, choose RETRO."
pipeline: text
document:
  role: summary
  name: Ретро
prompt: |
  Составь саммари ретроспективы в разделах: ...

Поле	Описание
`version`	Всегда `1`
`name`	Название в меню. Если не указано, берётся идентификатор
`description`	Подпись рядом с названием
`icon`	Иконка рядом с названием в меню ИИ: имя иконки из набора lucide (бесплатная библиотека простых значков) в kebab-case, то есть слова через дефис, как в адресе страницы иконки (`handshake`, `list-checks`). Только латиница в нижнем регистре, цифры и дефисы. Эмодзи в `name` не ставьте, для картинки есть `icon`. Неизвестное имя покажется иконкой по умолчанию
`order`	Место в списке (по возрастанию). Встроенные занимают 10–80, по умолчанию 1000, то есть после встроенных
`classifier`	Если есть, шаблон участвует в автовыборе. Допустим только для шаблонов с ролью `summary`
`classifier.description`	Обязательное в блоке: для каких записей подходит шаблон
`classifier.rules`	Необязательно: правила выбора между похожими шаблонами
`pipeline`	`text` (по умолчанию), `delta` или `action_points`
`document.role`	`summary` или `action_points`; по умолчанию определяется пайплайном
`document.name`	Имя документа у записи; по умолчанию название шаблона
`prompt`	Инструкция для ИИ. Обязательна для `text` и `action_points`
`html_prompt`	Необязательно, только для `text`: инструкция для HTML-вида, иначе используется `prompt`

Если в файле есть неизвестное поле или ошибка формата, шаблон не будет принят, а причина будет указана в сообщении.

Пайплайны

Пайплайн определяет, как ИИ собирает саммари. Если не уверены, оставляйте text: это значение по умолчанию, и его достаточно в большинстве случаев.

text — обычное саммари по вашей инструкции. В prompt перечислите разделы документа и что должно быть в каждом, добавьте «Skip sections that have no data» (пропускать разделы без данных) и «Use the same language as the meeting» (отвечать на языке записи). Оформление markdown (заголовки, таблицы) сервер добавляет сам.
action_points — только задачи и поручения. prompt передаётся модели как есть, документ получает роль action_points. Пример: встроенный шаблон Action Points.
delta — для длинных встреч, см. ниже.

Для продвинутых: пайплайн `delta`

Модель читает запись фрагментами и по ходу правит протокол встречи, поэтому лучше справляется с длинными встречами. Структура документа фиксированная: шапка, обсуждённые темы, задачи, открытые вопросы, итог. Настраивается через секцию delta, все поля необязательны:

pipeline: delta
prompt: |
  Каждый риск из обсуждения выноси в открытые вопросы.
delta:
  role: You are keeping the minutes of a sales team weekly.
  heading: true          # шапка документа
  outcome: true          # раздел «Итог»
  sections:              # заголовки разделов
    topics: Обсуждённые темы
    tasks: Задачи
    questions: Открытые вопросы
    outcome: Итог

Здесь prompt задаёт дополнительные инструкции (не длиннее 4000 символов, они уходят в модель на каждом фрагменте), role — роль модели, sections — заголовки разделов. Для delta HTML-вид не поддерживается.

Автовыбор шаблона

После распознавания запись может быть классифицирована автоматически: ИИ видит фрагменты транскрипта и список шаблонов с блоком classifier и выбирает подходящий. Если уверенности недостаточно или запись короткая, выбирается «Общее саммари». Выбранный шаблон становится шаблоном записи, по нему делается авто-саммари.

Пишите classifier.description по-английски как критерий отбора: кто участвует, какая цель разговора, чем этот тип записи не является.
Шаблон без classifier в автовыборе не участвует, его выбирают только вручную.
Скрытый встроенный шаблон в автовыборе не участвует.
При автоматическом выборе шаблона (запуск саммари без явного выбора) может быть использован личный шаблон автора записи, даже если у вас самого его нет.

Ограничения

в папке .cognico/summary учитываются до 50 файлов, размер одного файла не более 128 КБ;
name не длиннее 120 символов, description не длиннее 1000;
classifier.description не длиннее 2000 символов, в classifier.rules не больше 10 правил; каждое правило не длиннее 500 символов. Все шаблоны аккаунта, которые участвуют в автовыборе, должны укладываться в общий бюджет классификатора: если своих шаблонов с классификатором слишком много, часть из них не будет участвовать в автоматическом выборе (в первую очередь остаются встроенные, затем свои по classifier.order);
prompt и html_prompt не длиннее 32 000 символов; для пайплайна delta prompt не длиннее 4000;
html_prompt не может быть пустым: если отдельная инструкция для HTML-вида не нужна, уберите поле;
файл в другой папке не считается шаблоном;
содержимое папки .cognico не попадает в поиск и в контекст ИИ-чата.

Пример шаблона целиком

Файл .cognico/summary/retro.yaml:

version: 1
name: Ретроспектива
description: Что получилось, что нет, договорённости
icon: rotate-ccw
order: 100
classifier:
  description: >-
    A team retrospective: participants look back at the last iteration,
    discuss what went well and badly and agree on improvements.
    NOT a regular planning meeting.
pipeline: text
document:
  role: summary
  name: Ретро
prompt: |
  Составь саммари ретроспективы спринта.
  Выведи только разделы ниже, пропускай разделы без данных. Отвечай на языке записи.

  Разделы:
  - Что получилось: удачные решения и достижения.
  - Что не получилось: проблемы и их причины.
  - Договорённости: таблица со столбцами Что, Кто, Срок.

  Не добавляй сведений, которых не было в записи.

Встроенные шаблоны​

Где хранятся свои шаблоны​

Самый простой способ: попросить ИИ​

Формат файла​

Пайплайны​

Для продвинутых: пайплайн delta​

Автовыбор шаблона​

Ограничения​

Пример шаблона целиком​