Памятка в знаниях

Знания — то, что бизнес рассказывает о себе словами: как добраться, правила, как проходит услуга. По ним отвечает клиентам онлайн-администратор, а помощник читает их, когда помогает команде. В веб-версии раздел называется Знания.

Два вида памяток

• Статья: заголовок и текст.
• Ответ на частый вопрос: заголовок, текст и другие формулировки вопроса, по одной в строке (Ещё спрашивают так). Поиск находит ответ по любой из них. Такие формулировки бывают только у ответа.

Тема

У каждой памятки есть тема: О нас; Услуги и как они проходят; Как добраться; Правила: запись, опоздания, отмена; Оплата; Частые вопросы. Тема Как мы общаемся с клиентами занята голосом, и ничего другого в ней нет.

Голос

Голос — одна памятка о том, как бизнес общается с клиентами: на «вы» или на «ты», как здоровается, эмодзи, слова, которые говорит и никогда не говорит. У неё нет заголовка и филиалов, и у бизнеса она одна. Вторую написать нельзя, пока первую не изменили или не убрали. Обычную вежливость записывать не нужно: онлайн-администратор её и так знает.

Где памятка действует

Памятка может быть о выбранных филиалах и о выбранных услугах филиала. Если ничего не отмечено, она обо всём бизнесе. Памятка об услуге видна и на странице услуги в настройках, в блоке Памятки об этой услуге. Знания принадлежат бизнесу целиком.

Цены и время

Цены, длительность, график и скидки знаниями не являются. Онлайн-администратор берёт их из прайса и графиков, а текст памятки нужен для слов вокруг них.

Кто что может

Роли можно выдать три права по отдельности:

• смотреть знания и их историю;
• предлагать правки, которые ждут одобрения (см. Предложения к знаниям);
• писать, менять, убирать и возвращать. Каждое сохранение и есть одобрение.

Готовая роль «Бухгалтер» знаний не видит совсем. Программа, подключённая по MCP, читает памятки и предлагает правки, менять их она не может. Помощник меняет памятки по просьбе человека и всегда спрашивает заранее (см. Версии, история и убранные памятки).

Инструменты и отказы

• Знания — то, что помощник и ответы клиентам говорят словами: статьи, ответы на частые вопросы и голос бизнеса, одна статья с местом voice о том, как бизнес общается с клиентами. Цены, длительность, график и скидки знаниями не являются: они лежат в прайсе и графиках (talemo_list_services, talemo_get_schedule).
• talemo_find_knowledge перечисляет памятки: сначала голос, потом по теме и названию, без текста. Сужают список topic (about, directions, services, rules, payment, faq, communication), service и archived; рядом приходят числа живых памяток по темам. Чтобы получить ещё, next передают как after. С q он ищет (см. Поиск по знаниям).
• talemo_get_knowledge показывает одну памятку по document_id: текст, другие формулировки вопроса, филиалы и услуги, о которых она (если их нет, то обо всём бизнесе), её version, кто написал и кто одобрил. talemo_get_knowledge_history показывает каждую версию целиком, сначала новые; за более старыми — next как before.
• Сначала посмотрите, потом пишите: памятку, которая есть, меняют, а не пишут второй раз.
• Через ключ бизнеса или подключение Claude и ChatGPT знания только читают и предлагают к ним правки (см. Предложения к знаниям). Прямая правка из программы отклоняется со статусом 401 и кодом auth.required, и здесь это значит «человек делает это в Talemo», а не поломку подключения. talemo_create_knowledge, talemo_update_knowledge, talemo_archive_knowledge и talemo_restore_knowledge есть только у помощника команды, и каждая правка ждёт одобрения человека на карточке в разговоре: не просите его печатать «да», а когда инструмент вернул памятку, человек разрешил её и она сохранена.
• talemo_create_knowledge принимает kind (article или answer), topic и body; голос — это place voice, он один на бизнес, и второй отклоняется со статусом 409 и кодом knowledge.voice_taken. В теме communication лежит только голос: всё остальное отклоняется с request.body_invalid и params.field topic. Смысл человека сохраняйте его словами и не добавляйте факт, которого он не говорил.
• talemo_update_knowledge принимает version из talemo_get_knowledge: если памятку сохраняли после, вызов отклоняется с knowledge.version_conflict и params.version. Прочтите памятку заново и сделайте правку ещё раз. Текст, формулировки, филиалы и услуги задают целиком, такими, какими они станут; чего нет в запросе, остаётся. Убранную памятку сначала возвращают (knowledge.archived).
• talemo_archive_knowledge убирает памятку из того, что говорит помощник; ничего не теряется, а talemo_restore_knowledge возвращает её с тем текстом, какой был. Голос не вернуть, пока жив другой голос: статус 409, код knowledge.voice_taken.