---
title: Предложения к знаниям
summary: Кто не может менять знания сам, предлагает новую памятку, правку или «убрать». Пока человек с правом не примет, не поправит или не отклонит предложение, ничего не меняется.
tools: [talemo_propose_knowledge, talemo_list_knowledge_proposals]
related: [knowledge-entry, versions-and-removed, knowledge-search, online-admin-and-knowledge]
search: [предложить правку, одобрить изменение]
---

# Предложения к знаниям

## Кто предлагает и что

- Человек из команды, чья роль позволяет предлагать, кнопкой **Предложить** у
  памятки или **Предложить правку**.
- Программа, подключённая по MCP, через `talemo_propose_knowledge`, от имени
  того, кто её подключил.
- Онлайн-администратор, только вопросы, на которые не нашёл ответа (см. [Как
  онлайн-администратор пользуется знаниями](online-admin-and-knowledge.md)).

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

## Где очередь

- Веб-версия: **Знания → Предложения**. Число также видно в **Сегодня**. Фильтры:
  Ждут, Все предложения, Решённые, Мои предложения и кто предложил (человек,
  программа, онлайн-администратор).
- Приложение: **Ждёт вас**, строка с предложениями к знаниям, дальше лист на
  каждое предложение с кнопками **Принять**, **Отклонить** и **Принять разом**.
  Текст правят в веб-версии, а вопрос без ответа в приложении можно только отклонить.

Кто может только предлагать, видит в очереди только свои предложения. Кто
принимает, видит очередь целиком. По MCP очередь — `talemo_list_knowledge_proposals`.

## Решение

- **Принять** вносит правку новой версией памятки. В истории названы тот, кто
  предложил, и тот, кто принял.
- **Поправить и принять** даёт принимающему сначала исправить текст. В истории
  будет «поправлено и принято».
- **Отклонить** оставляет знания как есть. Причина необязательна, и тот, кто
  предложил, её увидит.

Первое решение закрывает предложение у всех. Второму человеку, который его
откроет, скажут, что по нему уже решили.

## Принять разом

Частые ответы из трёх и больше чатов и памятки без цифр можно принять вместе.
Голос, правила, оплата и правки решаются по одному. Предложение, похожее на
памятку, которая уже есть в знаниях, тоже идёт отдельно: в очереди написано
«Похоже на памятку ...» со ссылкой, и человек решает, нужна ли вторая. Если в
пачке есть то, что решается по одному, не принимается ничего.

## Повторы и правки между делом

- То же предложение, сделанное снова, пока первое ждёт, второй раз не
  появляется. Новые чаты, из которых оно взято, дописываются к первому.
- Тот же текст, который уже отклоняли, отказывает, пока текст не изменят или его
  не подтвердит новый чат.
- Если памятку изменили, пока предложение ждало, принять его как есть нельзя.
  В очереди пометка «памятку изменили», и правку придётся сделать заново.

## Чаты, из которых взято предложение

Чат-источник в очереди показан каналом и именем только тому, кто этот чат видит.
Остальные чаты только считаются, например «ещё 2 чата». Когда чат игнорируют, ещё не
принятые предложения из него отзываются. Принятые остаются, но без ссылки на чат.

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

- `talemo_propose_knowledge` предлагает правку: `action` — `create` (новая памятка), `edit` (памятка целиком) или `archive` (убрать). Пока человек с правом не одобрит её в Talemo, ничего не меняется, и онлайн-администратор отвечает по-старому. `note` говорит зачем, до 500 знаков.
- Новая памятка принимает `kind` (`article` или ответ на частый вопрос), `topic` и текст; правка и удаление принимают `document_id` и `version`, от которой они идут. Более новая версия отклоняется с `knowledge.version_conflict` и `params.version`: прочтите памятку заново через `talemo_get_knowledge`.
- В `conversations` назовите каждый чат, который предложение пересказывает (их находит `talemo_list_conversations`). Если чат игнорировать, всё, что взято из неё, отзывается.
- На такое же предложение, которое уже ждёт, отвечают им самим, а новые чаты к нему добавляются. Тот же текст, отклонённый раньше, возвращается только с чатом, которого у него не было, иначе — отказ `knowledge.proposal_rejected`.
- Новая памятка, близкая по смыслу к живой, приходит с `similar`: нужна ли вторая, решает человек. С `dry_run` `similar` нет, потому что сравнение стоит денег.
- `talemo_list_knowledge_proposals` показывает очередь, сначала новые: что получится из памятки, кто предложил, менялась ли памятка с тех пор, `similar` и решение. Роль, которая держит только своё, видит только свои предложения. Вопрос без ответа приходит от онлайн-администратора: текста у него нет, а `asked_again` считает клиентов, которые спросили то же после отказа.
- Решение — дело человека. Программе, которая одобряет или отклоняет, отвечают `auth.required`: человек делает это в Talemo.