Тема
Разборы встреч
Семейство reviews.
norm_meeting_reviews_list
Разборы встреч компании страницами, от свежих к старым по дню встречи. Разбор — вывод агента об одной встрече: факты, как их видел агент, и его оценка; итоги, человеко-часы и деньги по разборам считает платформа, сервер их не отдаёт. Фильтры: from и to — дни встречи включительно; meeting_ids — до 200 встреч: разбор есть в ответе — значит встреча уже разобрана; разборы объёмные и страница бывает короче запроса, поэтому неразобранной встречу считайте, только долистав ответ до конца. Ответ — по правам принципала: разборов встреч, которых вызывающий не видит, в нём нет. На странице не больше limit разборов, и она укладывается в предел размера ответа; total — сколько разборов подошло под фильтр до применения страницы. Для следующей страницы передайте page.next_cursor как cursor. Доменное состояние not_ready — хранение разборов у компании не настроено.
Доступ: чтение · Списковый: да · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
cursor | нет | string | Какую страницу прислать: next_cursor из прошлого ответа. Без него — первую. |
from | нет | string (date) | С какого дня встречи искать разборы, включительно. |
limit | нет | integer | Сколько записей прислать на одной странице. |
meeting_ids | нет | список string | Проверить разом, какие из этих встреч уже разобраны. |
to | нет | string (date) | По какой день встречи искать разборы, включительно. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
reviews | да | список MeetingReview | Разборы этой страницы, от свежих к старым. |
total | да | integer | Сколько разборов подошло под фильтр всего, на всех страницах. |
error | нет | DomainError | Почему данных нет: хранение разборов у компании не настроено. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-reviews:2026-09-07..2026-10-06",
"label": "Разборы встреч"
}
],
"freshness": {
"as_of": "2026-10-06T18:04:00.000Z",
"ttl_sec": 86400,
"stale": false
},
"page": {
"has_more": true,
"next_cursor": "eyJvIjoyfQ"
},
"data": {
"total": 41,
"reviews": [
{
"meeting_id": "01K9F2QH7T8ZRC4M0X5B2VNJ3D",
"title": "Планёрка отдела продаж",
"date": "2026-10-06",
"started_at": "2026-10-06T09:00:00+03:00",
"ended_at": "2026-10-06T09:47:00+03:00",
"duration_min": 47,
"organizer_email": "a.novikova@example.com",
"participant_emails": [
"a.novikova@example.com",
"m.petrov@example.com",
"s.ilina@example.com",
"d.orlov@example.com",
"k.zueva@example.com"
],
"speaker_emails": [
"a.novikova@example.com",
"m.petrov@example.com"
],
"status": "analyzed",
"type_id": "standup",
"silent_exempt": false,
"off_topic_share": 0.2,
"no_outcome": false,
"could_be_written": true,
"discussion_share": 0.4,
"note": "Статусы зачитывали по очереди — их можно было прислать письменно",
"reasons": [
"Две трети времени ушло на зачитывание статусов",
"Обсуждали один вопрос — закупку"
],
"agent_version": "1.2.0",
"reviewed_at": "2026-10-06T21:04:00+03:00"
},
{
"meeting_id": "01K9F0YB3M6QA8T2WD7E4RSKPN",
"title": "Разбор рекламации",
"date": "2026-10-05",
"duration_min": 35,
"organizer_email": "m.petrov@example.com",
"participant_emails": [
"m.petrov@example.com",
"buyer@partner.example"
],
"status": "no_content",
"agent_version": "1.2.0",
"reviewed_at": "2026-10-06T21:04:00+03:00"
}
]
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-reviews"
}
],
"freshness": {
"as_of": "2026-10-06T18:04:00.000Z",
"ttl_sec": 0,
"stale": false
},
"page": {
"has_more": false
},
"data": {
"error": {
"code": "not_ready",
"message": "Хранение разборов встреч у компании не настроено.",
"retryable": false
}
}
}norm_meeting_reviews_upsert
Записать разборы встреч пачкой — от 1 до 50 за вызов. Идемпотентно по meeting_id: повторная запись встречи заменяет прежний разбор целиком, даже если у встречи сменился день, — дубля по встрече не бывает. participant_emails — только пришедшие; speaker_emails — кто из них говорил, у status: analyzed он обязателен. Поля оценки передавайте только у analyzed, discussion_share — вместе с could_be_written: true. Тип встречи — type_id из norm_protocol_types; не подошёл ни один — не передавайте type_id, а название предложите в suggested_type: справочник типов компании агент не меняет. reviewed_at ставит сервер. Отказ одной записи не отменяет остальные: она придёт в rejected успешного ответа с ключом meeting_id и кодом — invalid_input (запись нарушает правила полей или встреча повторяется в пачке: записана первая), unknown_id (тип не из справочника; встреча неизвестна или не видна вызывающему — ответ одинаков, чтобы не выдать чужую встречу), record_rejected (хранилище не приняло запись, повтор даст то же). Запись идёт по правам принципала. Доменные состояния вызова: not_ready — хранение разборов не настроено; temporary и rate_limited — повторите позже.
Доступ: запись · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
reviews | да | список MeetingReview | Разборы для записи; каждая встреча — один раз. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
created | да | integer | Сколько разборов записано впервые. |
rejected | да | список RejectedRecord | Какие записи не приняты и почему; остальные записаны. |
updated | да | integer | Сколько прежних разборов заменено. |
error | нет | DomainError | Почему ничего не записано и можно ли повторить. |
note | нет | string | Пояснение сервера к записи. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-reviews",
"label": "Разборы встреч"
}
],
"freshness": {
"as_of": "2026-10-06T18:04:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"created": 2,
"updated": 1,
"rejected": [
{
"key": "01K9DZ4W8N2PQ6R0T3V5X7Z9B1",
"code": "unknown_id",
"message": "тип встречи «sync» не из справочника norm_protocol_types"
},
{
"key": "01K9F2QH7T8ZRC4M0X5B2VNJ3D",
"code": "invalid_input",
"message": "встреча уже есть в этом вызове — повтор не записан"
}
]
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-reviews"
}
],
"freshness": {
"as_of": "2026-10-06T18:04:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"error": {
"code": "not_ready",
"message": "Хранение разборов встреч у компании не настроено.",
"retryable": false
}
}
}norm_meeting_advice_get
Последний набор рекомендаций агента по встречам компании за период: до пяти шагов «что изменить» с эффектом в человеко-минутах. period — окно набора: 14d, 30d или 3m по день as_of включительно; на каждый период хранится только последний набор. Набор собран по всем встречам компании, поэтому реализация вправе отдавать его только владельцу и администратору компании и отвечать остальным unauthorized_scope. Доменные состояния: no_data — набора за этот период ещё нет, агент его не записывал; not_ready — хранение разборов у компании не настроено.
Доступ: чтение · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
period | да | MeetingAdvicePeriod | За какой период нужен набор. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
advice | да | MeetingAdvice | Набор рекомендаций за период целиком. |
error | нет | DomainError | Почему набора нет: агент его ещё не записал или хранение не настроено. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-advice:30d",
"label": "Рекомендации по встречам"
}
],
"freshness": {
"as_of": "2026-10-06T18:10:00.000Z",
"ttl_sec": 86400,
"stale": false
},
"data": {
"advice": {
"period": "30d",
"as_of": "2026-10-06",
"steps": [
{
"title": "Статусы планёрок — письменно",
"how": "Каждый пишет статус в общий чат до планёрки; на встрече обсуждают только то, что мешает работе.",
"basis": "12 планёрок за 30 дней, две трети времени — зачитывание статусов",
"impact": "high",
"effect_person_min": 1800
},
{
"title": "Итог в конце каждой встречи",
"how": "Последние пять минут — решение, ответственный и срок; без них встречу не закрывают.",
"basis": "9 встреч закончились без решения и следующего шага",
"impact": "medium",
"effect_person_min": 900
}
],
"combined_effect_person_min": 2400,
"overlap_note": "Часть планёрок без итога попадает и в первый шаг, поэтому общий эффект меньше суммы."
}
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-advice:3m"
}
],
"freshness": {
"as_of": "2026-10-06T18:10:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"error": {
"code": "no_data",
"message": "Набора рекомендаций за 3m ещё нет: агент его не записывал.",
"retryable": false
}
}
}norm_meeting_advice_upsert
Записать набор рекомендаций агента за период. Идемпотентно по period: новый набор заменяет прежний целиком. steps — до пяти шагов; пустой список — советовать нечего. combined_effect_person_min — общий эффект шагов с учётом того, что они пересекаются: не больше суммы effect_person_min; почему меньше — в overlap_note. Набор собран по всем встречам компании, поэтому реализация вправе принимать его только от владельца и администратора компании и отвечать остальным unauthorized_scope. Доменные состояния: not_ready — хранение разборов не настроено; temporary и rate_limited — повторите позже.
Доступ: запись · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
as_of | да | string (date) | По какой день включительно собран набор: показать, на какую дату советы. |
combined_effect_person_min | да | integer | Общий эффект шагов в человеко-минутах с учётом пересечений: не больше суммы эффектов шагов. |
period | да | MeetingAdvicePeriod | За какое окно собран набор; по нему набор ищут и перезаписывают. |
steps | да | список MeetingAdviceStep | Шаги, до пяти; пустой список — советовать нечего. |
overlap_note | нет | string | Почему общий эффект меньше суммы эффектов шагов. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
created | да | boolean | Создан ли набор впервые; false — заменён прежний. |
error | нет | DomainError | Почему набор не записан и можно ли повторить. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-advice:30d",
"label": "Рекомендации по встречам"
}
],
"freshness": {
"as_of": "2026-10-06T18:10:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"created": false
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting-advice:30d"
}
],
"freshness": {
"as_of": "2026-10-06T18:10:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"error": {
"code": "not_ready",
"message": "Хранение разборов встреч у компании не настроено.",
"retryable": false
}
}
}Объекты семейства
Объекты, из которых состоят аргументы и ответы инструментов этого семейства.
MeetingReview
Разбор встречи. Вывод агента об одной встрече: факты, как их видел агент, и оценка. meeting_id — встреча из norm_meetings_list и ключ записи. participant_emails — только пришедшие, speaker_emails — кто из них говорил; молчавшие — пришедшие, которых нет среди говоривших. Поля оценки (type_id или suggested_type, silent_exempt, off_topic_share, no_outcome, could_be_written, discussion_share, note, reasons) есть только у status: analyzed. Итогов, человеко-часов и денег в разборе нет: их считает платформа.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
date | да | string (date) | День встречи: по нему разборы отбирают за период. |
duration_min | да | integer | Сколько минут шла встреча: из неё считают человеко-часы. |
meeting_id | да | string | Какую встречу разобрали: id из norm_meetings_list; по нему разбор ищут и перезаписывают. |
participant_emails | да | список string | Почты пришедших: по ним находят сотрудников и их подразделения; не пришедших не включают. |
status | да | MeetingReviewStatus | Разобрана ли встреча или материала для разбора нет. |
title | да | string | Название встречи: показать её в таблице, не открывая карточку. |
agent_version | нет | string | Какая версия агента сделала разбор: чтобы после обновления агента разобрать встречи заново. |
could_be_written | нет | boolean | Встречу можно было заменить письмом или сообщением. |
discussion_share | нет | number | Какая доля встречи ушла на обсуждение, которое письмом не заменить, от 0 до 1; нужна при could_be_written: true. |
ended_at | нет | string (date-time) | Когда встреча закончилась, если агент это знал. |
no_outcome | нет | boolean | Встреча закончилась без решения и следующего шага. |
note | нет | string | В чём дело, одной фразой: её показывают рядом со встречей. |
off_topic_share | нет | number | Какая доля встречи ушла не по теме, от 0 до 1. |
organizer_email | нет | string | Почта организатора: по ней встречи разбивают по организаторам. |
reasons | нет | список string | Почему агент так решил: до пяти доводов для человека. |
reviewed_at | нет | string (date-time) | Когда разбор записан: ставит сервер, во входе не нужен. |
silent_exempt | нет | boolean | Молчать на такой встрече нормально — лекция, демонстрация: молчавших в потери не считают. |
speaker_emails | нет | список string | Кто из пришедших говорил: остальные пришедшие — молчавшие. У разобранной встречи обязателен. |
started_at | нет | string (date-time) | Когда встреча началась, если агент это знал. |
suggested_type | нет | string | Название типа, если ни один тип компании не подошёл; передаётся вместо type_id. |
type_id | нет | string | Тип встречи: id из norm_protocol_types. |
MeetingReviewStatus
Состояние разбора. analyzed — встреча разобрана по расшифровке; no_content — материала нет: разбор несёт только факты, встреча идёт в часы без оценки.
Значения: analyzed, no_content.
RejectedRecord
Непринятая запись. Запись пачки, которую сервер не принял: ключ записи, код из общего словаря и пояснение. Остальные записи пачки при этом записаны.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
code | да | ErrorCode | Почему запись не принята: код из общего словаря, по нему видна сторона. |
key | да | string | Какая запись пачки не принята: её ключ, у разбора встречи — meeting_id. |
message | нет | string | Пояснение для разработчика. |
MeetingAdvicePeriod
Период рекомендаций. 14d — последние 14 дней, 30d — 30 дней, 3m — три календарных месяца, по день as_of включительно. На каждый период хранится только последний набор.
Значения: 14d, 30d, 3m.
MeetingAdvice
Набор рекомендаций. Рекомендации агента по встречам компании за период: до пяти шагов и общий эффект. Шаги пересекаются, поэтому общий эффект не больше суммы эффектов шагов; почему меньше — overlap_note.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
as_of | да | string (date) | По какой день включительно собран набор: показать, на какую дату советы. |
combined_effect_person_min | да | integer | Общий эффект шагов в человеко-минутах с учётом пересечений: не больше суммы эффектов шагов. |
period | да | MeetingAdvicePeriod | За какое окно собран набор; по нему набор ищут и перезаписывают. |
steps | да | список MeetingAdviceStep | Шаги, до пяти; пустой список — советовать нечего. |
overlap_note | нет | string | Почему общий эффект меньше суммы эффектов шагов. |
MeetingAdviceStep
Шаг рекомендаций. Что изменить во встречах компании, как это сделать, на чём основан совет, насколько он повлияет и сколько человеко-минут сбережёт за период.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
effect_person_min | да | integer | Сколько человеко-минут шаг сбережёт за период. |
how | да | string | Как это сделать: шаг, который можно выполнить. |
impact | да | high | medium | low | Насколько сильно шаг повлияет: high, medium или low. |
title | да | string | Что изменить во встречах: заголовок шага. |
basis | нет | string | На чём основан совет: какие встречи и цифры за ним стоят. |