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

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

• Человек из команды, чья роль позволяет предлагать, кнопкой Предложить у памятки или Предложить правку.
• Программа, подключённая по MCP, через talemo_propose_knowledge, от имени того, кто её подключил.
• Онлайн-администратор, только вопросы, на которые не нашёл ответа (см. Как онлайн-администратор пользуется знаниями).

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

Где очередь

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

Кто может только предлагать, видит в очереди только свои предложения. Кто принимает, видит очередь целиком. По 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.