Skip to content

Разборы встреч ​

Семейство 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На чём основан совет: какие встречи и цифры за ним стоят.