---
title: Памятка в знаниях
summary: Памятка — статья или ответ на частый вопрос, который онлайн-администратор рассказывает клиентам словами. Одна памятка — голос бизнеса.
tools: [talemo_find_knowledge, talemo_get_knowledge, talemo_create_knowledge, talemo_update_knowledge, talemo_archive_knowledge, talemo_restore_knowledge]
related: [versions-and-removed, suggestions, knowledge-search, online-admin-and-knowledge]
search: [FAQ, статья, ответы клиентам, тон бизнеса]
---

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

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

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

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

## Тема

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

## Голос

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

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

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

## Цены и время

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

## Кто что может

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

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

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

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

- Знания — то, что помощник и ответы клиентам говорят словами: статьи, ответы на частые вопросы и голос бизнеса, одна статья с местом `voice` о том, как бизнес общается с клиентами. Цены, длительность, график и скидки знаниями не являются: они лежат в прайсе и графиках (`talemo_list_services`, `talemo_get_schedule`).
- `talemo_find_knowledge` перечисляет памятки: сначала голос, потом по теме и названию, без текста. Сужают список `topic` (`about`, `directions`, `services`, `rules`, `payment`, `faq`, `communication`), `service` и `archived`; рядом приходят числа живых памяток по темам. Чтобы получить ещё, `next` передают как `after`. С `q` он ищет (см. [Поиск по знаниям](knowledge-search.md)).
- `talemo_get_knowledge` показывает одну памятку по `document_id`: текст, другие формулировки вопроса, филиалы и услуги, о которых она (если их нет, то обо всём бизнесе), её `version`, кто написал и кто одобрил. `talemo_get_knowledge_history` показывает каждую версию целиком, сначала новые; за более старыми — `next` как `before`.
- Сначала посмотрите, потом пишите: памятку, которая есть, меняют, а не пишут второй раз.
- Через ключ бизнеса или подключение Claude и ChatGPT знания только читают и предлагают к ним правки (см. [Предложения к знаниям](suggestions.md)). Прямая правка из программы отклоняется со статусом 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`.