Skip to content

Гармоники — знания агента

Гармоника — структурированная единица знания, навыка, правила или поведения агента. В текущей реализации гармоника хранится как карточка с заголовком, содержанием и якорем (темой); пак — папка с гармониками.

Это знания и навыки вашего бизнеса, разобранные на атомы: правило, пункт прайса, типовой вопрос-ответ, инструкция. Из гармоник собирается всё, что агент знает и умеет. Состав знаний, попадающий в промпт, формируется динамически под каждый запрос — семантическим отбором, а не зашитым списком.

Виды знаний

ВидЧто этоКак попадает к агенту
Характер (soul)Системный промпт: кто агентВсегда целиком
Ядро (core)Главные принципы, без которых нельзяВсегда целиком
База (faq / profile)FAQ, знания организацииПо релевантности
Инструкции (instrument)Как и когда вызывать инструментыПри tool calling
Готовые паки (shared)Профессии из библиотекиПодключением пака

Два способа подачи:

  • Напрямую в роль — знания всегда в промпте. Для характера и ядра.
  • Через семантический отбор — из большой базы в промпт попадают только карточки, релевантные текущему вопросу. Так агент с тысячей FAQ не переполняется: отвечает по делу, опираясь на нужное.

Паки: свои и библиотека

Гармоники приходят из двух источников, и оба важны:

  1. Библиотека готовых наборов — паки профессий и навыков, собранные заранее: подключили пак — агент сразу владеет компетенцией. Не надо собирать с нуля.
  2. Свои паки — вы создаёте и наполняете их сами: вручную в кабинете или силами своего ИИ-агента через API. Так агент знает именно вашу компанию, а не «среднюю» профессию.

На практике работают вместе: готовый пак — база профессии, свои гармоники — специфика вашего бизнеса поверх неё. Библиотека растёт.

Правило хранения простое: гармоника сохраняется в выбранный вами пак. Хотите разделить знания клиента и компании — заводите разные паки.