Тема
Оценки Align
Семейство align.
norm_align_assessments_list
Оценки встреч компании по ядру модуля Align страницами, от свежих к старым по дню встречи. Оценка — вывод агента об одной встрече: вид встречи по стандарту, исход и уровни норм с обоснованием и цитатами; баллов в ней нет. Фильтры, все необязательные: from и to — дни встречи включительно; meeting_ids — до 200 встреч: оценка есть в ответе — значит, встреча уже разобрана; кроме исхода no_content: такую встречу оценивают снова, когда появится расшифровка. brief: true — краткий ответ: у норм только code, dimension, level и confidence, без обоснований, цитат и missing_signals; так агент собирает сводку периода, и страница вмещает больше оценок. Без brief ответ полный. Оценки объёмные, и страница бывает короче limit: неоценённой встречу считайте, только долистав ответ до конца. На странице не больше limit оценок, и она укладывается в предел размера ответа; total — сколько оценок подошло под фильтр до применения страницы. Для следующей страницы передайте page.next_cursor как cursor с теми же фильтрами. Оценки про всю компанию и несут цитаты встреч: читать и писать их вправе только владелец и администратор компании, остальным реализация отвечает unauthorized_scope. Доменное состояние not_ready — хранение оценок у компании не настроено.
Доступ: чтение · Списковый: да · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
brief | нет | boolean | Краткий ответ: у норм только код, измерение, уровень и уверенность. Без поля — полный ответ. |
cursor | нет | string | Какую страницу прислать: next_cursor из прошлого ответа. Без него — первую. |
from | нет | string (date) | С какого дня встречи искать оценки, включительно. |
limit | нет | integer | Сколько записей прислать на одной странице. |
meeting_ids | нет | список string | Проверить разом, какие из этих встреч уже оценены. |
to | нет | string (date) | По какой день встречи искать оценки, включительно. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
assessments | да | список AlignAssessment | Оценки этой страницы, от свежих к старым по дню встречи. |
total | да | integer | Сколько оценок подошло под фильтр всего, на всех страницах. |
error | нет | DomainError | Почему данных нет: хранение оценок у компании не настроено. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-assessments:2026-09-24..2026-10-23",
"label": "Оценки Align"
}
],
"freshness": {
"as_of": "2026-10-23T18:30:00.000Z",
"ttl_sec": 0,
"stale": false
},
"page": {
"has_more": true,
"next_cursor": "eyJvIjozfQ"
},
"data": {
"total": 19,
"assessments": [
{
"meeting_id": "01K9H3T0QW6Z8B1D3F5H7K9M2P",
"date": "2026-10-22",
"title": "Планирование спринта отдела продаж",
"outcome": "assessed",
"genres": [
{
"code": "GENRE.MEETING.PLANNING",
"confidence": 0.91
},
{
"code": "GENRE.MEETING.STATUS",
"confidence": 0.42
}
],
"seen_share": 1,
"norms": [
{
"code": "ALIGN.DECISION.N1",
"dimension": "decisions",
"level": "partial",
"confidence": 0.8,
"rationale": "Решение о переносе запуска принято вслух, и его поддержали все трое руководителей. Но кто ведёт перенос и к какому дню, не названо: решение есть, владельца и срока нет.",
"quotes": [
{
"text": "Хорошо, запуск сдвигаем на две недели, все согласны",
"person_id": "01K9H2A4B6C8D0E2F4G6H8J0K2"
},
{
"text": "А кто тогда предупредит партнёров?"
}
],
"missing_signals": [
"Ответственный за решение",
"Срок исполнения"
]
},
{
"code": "ALIGN.CONFLICT.N1",
"dimension": "conflicts",
"level": "absent",
"confidence": 0.7,
"rationale": "Разногласие о бюджете названо, но обсуждение свернули до того, как стороны высказали позиции: спора на встрече не видно.",
"quotes": [
{
"text": "Про бюджет давайте не сейчас",
"person_id": "01K9H2A4B6C8D0E2F4G6H8J0K2"
}
],
"missing_signals": [
"Позиции обеих сторон",
"Чем закончился спор"
]
}
],
"snapshot_version": "0.1.0+3f4ce9cfe997",
"kit_version": "kit-v8",
"assessed_on": "2026-10-23",
"agent_version": "1.0.0",
"recorded_at": "2026-10-23T02:14:09.000+03:00"
},
{
"meeting_id": "01K9H1M8P0R2T4V6X8Z0B2D4F6",
"date": "2026-10-21",
"title": "Лекция о новом регламенте закупок",
"outcome": "intake_failed",
"note": "Лекция без обсуждения: спора на встрече нет, нормы не оценивались",
"genres": [
{
"code": "GENRE.KNOWLEDGE.TRAINING",
"confidence": 0.88
}
],
"seen_share": 1,
"norms": [],
"snapshot_version": "0.1.0+3f4ce9cfe997",
"kit_version": "kit-v8",
"assessed_on": "2026-10-23",
"agent_version": "1.0.0",
"recorded_at": "2026-10-23T02:14:09.000+03:00"
},
{
"meeting_id": "01K9GZ5C7E9G1J3L5N7Q9S1U3W",
"date": "2026-10-21",
"title": "Встреча один на один: Орлов — Зуева",
"outcome": "excluded",
"note": "Встреча вдвоём: такие агент не оценивает",
"genres": [],
"norms": [],
"assessed_on": "2026-10-23",
"agent_version": "1.0.0",
"recorded_at": "2026-10-23T02:14:09.000+03:00"
}
]
}
}Пример: случай «brief»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-assessments:2026-09-24..2026-10-23",
"label": "Оценки Align"
}
],
"freshness": {
"as_of": "2026-10-23T18:30:00.000Z",
"ttl_sec": 0,
"stale": false
},
"page": {
"has_more": false
},
"data": {
"total": 1,
"assessments": [
{
"meeting_id": "01K9H3T0QW6Z8B1D3F5H7K9M2P",
"date": "2026-10-22",
"title": "Планирование спринта отдела продаж",
"outcome": "assessed",
"genres": [
{
"code": "GENRE.MEETING.PLANNING",
"confidence": 0.91
}
],
"seen_share": 1,
"norms": [
{
"code": "ALIGN.DECISION.N1",
"dimension": "decisions",
"level": "partial",
"confidence": 0.8
},
{
"code": "ALIGN.CONFLICT.N1",
"dimension": "conflicts",
"level": "absent",
"confidence": 0.7
}
],
"snapshot_version": "0.1.0+3f4ce9cfe997",
"kit_version": "kit-v8",
"assessed_on": "2026-10-23",
"agent_version": "1.0.0",
"recorded_at": "2026-10-23T02:14:09.000+03:00"
}
]
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-assessments"
}
],
"freshness": {
"as_of": "2026-10-23T18:30:00.000Z",
"ttl_sec": 0,
"stale": false
},
"page": {
"has_more": false
},
"data": {
"error": {
"code": "not_ready",
"message": "Хранение оценок Align у компании не настроено.",
"retryable": false
}
}
}norm_align_assessments_upsert
Записать оценки встреч пачкой — от 1 до 50 за вызов. Идемпотентно по meeting_id: повторная запись встречи заменяет прежнюю оценку целиком, даже если у встречи сменился день, — дубля по встрече не бывает. Записывайте встречу с любым исходом: assessed — оценена по нормам; intake_failed — не прошла проверку на входе; excluded — исключена правилом агента, например встреча один на один или вдвоём; no_content — расшифровки пока нет. Встречу с no_content оцените снова, когда расшифровка появится: retryable: true у norm_meeting_get и norm_meeting_transcript значит, что она ещё может появиться; новая запись заменит прежнюю. Нормы — только у assessed, каждая норма один раз, у каждой — rationale; неприменимую норму не записывайте. Оценку длиннее 30 000 знаков в JSON сервер не принимает. Длина — число знаков JSON записи без recorded_at, как у предела ответа: буквы не экранируются, буква кириллицы — один знак. Тексты пишите одной строкой, кавычки — «ёлочками»: прямая кавычка и перевод строки занимают по два знака. recorded_at ставит сервер. Пачку, где запись не проходит схему входа, сервер вправе отклонить целиком: пределы и форматы проверяйте до отправки. Отказ записи по остальным причинам не отменяет другие: она придёт в rejected с ключом meeting_id и кодом — invalid_input (нормы у исхода не assessed, норма без rationale или повторяется, оценка длиннее предела в JSON, встреча повторяется в пачке: записана первая), unknown_id (встречи с таким meeting_id у компании нет), record_rejected (хранилище не приняло запись, повтор даст то же), temporary и rate_limited (временный сбой). Повторить пачку безопасно: повтор не задвоит. Оценки про всю компанию и несут цитаты встреч: читать и писать их вправе только владелец и администратор компании, остальным реализация отвечает unauthorized_scope. Доменные состояния вызова: not_ready — хранение оценок не настроено; temporary и rate_limited — повторите позже.
Доступ: запись · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
assessments | да | список AlignAssessment | Оценки для записи; каждая встреча — один раз. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
created | да | integer | Сколько оценок записано впервые. |
rejected | да | список RejectedRecord | Какие записи не приняты и почему; остальные записаны. |
updated | да | integer | Сколько прежних оценок заменено. |
error | нет | DomainError | Почему ничего не записано и можно ли повторить. |
note | нет | string | Пояснение сервера к записи. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-assessments",
"label": "Оценки Align"
}
],
"freshness": {
"as_of": "2026-10-23T02:14:09.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"created": 4,
"updated": 0,
"rejected": [
{
"key": "01K9GX2D4F6H8K0M2P4R6T8V0X",
"code": "unknown_id",
"message": "встречи с таким meeting_id у компании нет"
},
{
"key": "01K9GZ5C7E9G1J3L5N7Q9S1U3W",
"code": "invalid_input",
"message": "у исхода excluded не бывает норм — запись не принята"
}
]
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-assessments"
}
],
"freshness": {
"as_of": "2026-10-23T02:14:09.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"error": {
"code": "not_ready",
"message": "Хранение оценок Align у компании не настроено.",
"retryable": false
}
}
}norm_align_summary_get
Последняя сводка Align за период для экрана «Обзор»: покрытие, семь измерений, вердикт по команде, опоры и причины с панелью «На чём основано». period — 14d, 30d или 3m по день to включительно; на каждый период хранится только последняя сводка. Баллы и вердикт посчитал агент. Измерение без балла — «нет данных», причина в его note; вердикта нет — причина в no_verdict_reason. Люди в сводке — только кто вовлечён: id и имя, без баллов и характеристик. Оценки про всю компанию и несут цитаты встреч: читать и писать их вправе только владелец и администратор компании, остальным реализация отвечает unauthorized_scope. Доменные состояния: no_data — сводки за этот период ещё нет, агент её не записывал; not_ready — хранение оценок у компании не настроено.
Доступ: чтение · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
period | да | AlignPeriod | За какой период нужна сводка. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
summary | да | AlignSummary | Сводка за период целиком. |
error | нет | DomainError | Почему сводки нет: агент её ещё не записал или хранение не настроено. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-summary:3m",
"label": "Сводка Align"
}
],
"freshness": {
"as_of": "2026-10-23T19:05:00.000Z",
"ttl_sec": 86400,
"stale": false
},
"data": {
"summary": {
"period": "3m",
"from": "2026-07-24",
"to": "2026-10-23",
"coverage": {
"meetings_total": 150,
"meetings_checked": 131,
"meetings_passed_intake": 118,
"hours": 212,
"people": 52,
"breakdown": {
"meetings_recorded": 144,
"parts": {
"assessed": 118,
"intake_failed": 13,
"excluded_one_on_one": 7,
"excluded_other": 2,
"awaiting_transcript": 3,
"unrecorded": 6,
"awaiting_agent": 1
}
}
},
"dimensions": [
{
"id": "trust",
"score": 71,
"delta": 3,
"note": "О проблемах говорят вслух на 8 встречах из 10. Тему денег и вилок обходят.",
"meetings_seen": 104
},
{
"id": "conflicts",
"score": 44,
"delta": -11,
"note": "Спор о вилках компенсаций идёт третий месяц: обе стороны поднимали вопрос, решения нет.",
"meetings_seen": 97
},
{
"id": "decisions",
"score": 52,
"delta": -4,
"note": "У четырёх решений из десяти нет владельца и срока.",
"meetings_seen": 18
},
{
"id": "commitments",
"score": 61,
"delta": -2,
"note": "Семь обещаний из десяти выполняются в срок, остальные переносят молча.",
"meetings_seen": 109
},
{
"id": "accountability",
"score": 38,
"delta": -7,
"note": "Работа ждёт одного человека: на 6 встречах вопрос отложили до его возвращения.",
"meetings_seen": 101
},
{
"id": "results",
"score": 66,
"delta": 1,
"note": "Три приоритета из пяти двигаются, два почти не звучат на встречах.",
"meetings_seen": 112
},
{
"id": "culture",
"note": "Нет данных: за период не было общих собраний, комитетов и кризисных встреч.",
"meetings_seen": 0
}
],
"dimensions_summary": "Доверие держит команду. Проседает всё, что идёт после согласия: спор не закрывается решением, решение не получает владельца и срока.",
"verdict": {
"score": 55,
"zone": "unstable",
"delta": -3,
"title": "Компания держится на людях, а не на договорённостях",
"text": "Люди доверяют друг другу и вытягивают работу на себе. Но спорные вопросы месяцами не закрываются, а решения на встречах остаются без владельца и срока.",
"explanation": {
"meaning": "Команда согласна друг с другом, но не доводит согласие до обязательства. На встречах открыто называют проблемы — это сильная сторона. Дальше цепочка рвётся: спор не заканчивается решением, решение не получает владельца, а без владельца за результат не отвечает никто.",
"points": [
"Компания предсказуема, пока несколько человек на месте: отпуск любого из них останавливает процесс.",
"Одни и те же вопросы возвращаются на встречи по три-четыре раза."
],
"calc": {
"composition": "Шесть измерений с равным весом: у культуры нет данных",
"sources": "118 оценённых встреч за три месяца, 212 часов",
"scale": "0–49 — риск · 50–69 — неустойчиво · 70–100 — норма",
"subject": "О команде и устройстве работы. Людям баллы не ставятся"
},
"changes": [
{
"dimension": "conflicts",
"delta": -11,
"text": "Спор о вилках перешёл в затяжной: четыре встречи без решения"
},
{
"dimension": "accountability",
"delta": -7,
"text": "Чаще стали откладывать вопросы до возвращения одного человека"
}
],
"blind_spot": "Переписку, задачи в трекере и работу вне встреч. Если вопрос решили в чате, для агента решения нет."
}
},
"supports": [
{
"title": "О сложных темах говорят на общей встрече, а не в кулуарах",
"text": "Спор о вилках, нагрузка, ошибки в доставке — всё это поднимается при всех. За квартал таких разговоров стало больше.",
"metric": "8 встреч из 10",
"dimensions": [
"trust"
],
"details": {
"why": "Проблемы, названные вслух при всех, решаются быстрее, чем те, что ходят по личным разговорам.",
"facts_total": 4,
"meetings_total": 10,
"facts": [
{
"source": {
"kind": "meeting",
"label": "Встречи · 10"
},
"text": "На 8 встречах из 10 спорный вопрос назван при обеих сторонах."
}
],
"meetings": [
{
"meeting_id": "01K8Y4N6Q8S0U2W4Y6A8C0E2G4",
"date": "2026-09-18",
"title": "Планёрка управления персоналом",
"quote": "Вилку по разработчикам снова вернули на пересчёт, третий раз"
}
],
"reasoning": "Опора фиксируется, если спорные темы чаще звучат на общих встречах, чем упоминаются как «обсудили отдельно».",
"blind_spot": "Личные разговоры агент не видит: часть обходных обсуждений могла остаться вне встреч.",
"people": [
{
"person_id": "01K8X0A2C4E6G8J0L2N4Q6S8U0",
"name": "Татьяна Тихомирова"
},
{
"person_id": "01K8X0B3D5F7H9K1M3P5R7T9V1",
"name": "Максим Галантэ"
}
]
}
}
],
"supports_summary": "Опоры держатся на инициативе конкретных людей: если эти люди уйдут, опора исчезнет вместе с ними.",
"causes": [
{
"title": "Спор о вилках компенсаций третий месяц без решения",
"text": "Тихомирова и Галантэ поднимали вопрос на четырёх встречах. Решения выше уровня двух отделов нет — каждая вилка снова проходит через спор.",
"metric": "4 встречи, 0 решений",
"dimensions": [
"conflicts",
"decisions"
],
"step": {
"priority": "now",
"title": "Закрыть спор о вилках решением генерального директора",
"text": "Спор третий месяц не решается на уровне двух отделов. Нужна утверждённая методика вилок и один владелец."
},
"details": {
"why": "Пока спор не закрыт решением сверху, каждый оффер задерживается на пересчёт.",
"facts_total": 4,
"meetings_total": 4,
"facts": [
{
"source": {
"kind": "meeting",
"label": "Встречи · 4"
},
"text": "Обе стороны поднимали вопрос на 4 встречах за 3 месяца, решения нет."
},
{
"source": {
"kind": "structure",
"label": "Структура компании"
},
"text": "Кто решает спор о вилке при разногласии, в должностях не задано."
}
],
"meetings": [
{
"meeting_id": "01K8Y4N6Q8S0U2W4Y6A8C0E2G4",
"date": "2026-09-18",
"title": "Планёрка управления персоналом",
"quote": "Вилку по разработчикам снова вернули на пересчёт, третий раз"
},
{
"meeting_id": "01K8W7R9T1V3X5Z7B9D1F3H5K7",
"date": "2026-09-04",
"title": "Синк по офферам",
"quote": "Пока нет единой методики, каждая вилка — спор"
}
],
"reasoning": "Спор считается затяжным, если обе стороны поднимают одну тему на трёх и более встречах без записанного решения.",
"blind_spot": "Если решение приняли в переписке, для агента спор всё ещё открыт.",
"people": [
{
"person_id": "01K8X0A2C4E6G8J0L2N4Q6S8U0",
"name": "Татьяна Тихомирова"
},
{
"person_id": "01K8X0B3D5F7H9K1M3P5R7T9V1",
"name": "Максим Галантэ"
}
]
}
}
],
"agent_version": "1.0.0",
"snapshot_version": "0.1.0+3f4ce9cfe997",
"recorded_at": "2026-10-23T19:04:31.000+03:00"
}
}
}Пример: случай «no_verdict»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-summary:14d",
"label": "Сводка Align"
}
],
"freshness": {
"as_of": "2026-10-23T19:05:00.000Z",
"ttl_sec": 86400,
"stale": false
},
"data": {
"summary": {
"period": "14d",
"from": "2026-10-10",
"to": "2026-10-23",
"coverage": {
"meetings_total": 12,
"meetings_checked": 10,
"meetings_passed_intake": 9
},
"dimensions": [
{
"id": "trust",
"score": 60,
"note": "О проблемах говорят, но позиции не доводят до конца.",
"meetings_seen": 9
},
{
"id": "conflicts",
"score": 30,
"note": "Споры сворачивают до того, как стороны высказались.",
"meetings_seen": 9
},
{
"id": "decisions",
"note": "Нет данных: за две недели не было планирований и комитетов.",
"meetings_seen": 0
},
{
"id": "commitments",
"score": 40,
"note": "Договорённости звучат без срока.",
"meetings_seen": 9
},
{
"id": "accountability",
"note": "Нет данных: нормы этого измерения не оценены ни на одной встрече.",
"meetings_seen": 0
},
{
"id": "results",
"note": "Нет данных: нормы этого измерения не оценены ни на одной встрече.",
"meetings_seen": 0
},
{
"id": "culture",
"note": "Нет данных: за две недели не было общих собраний.",
"meetings_seen": 0
}
],
"no_verdict_reason": "Оценено 3 измерения из 7: для вердикта нужно не меньше пяти.",
"supports": [],
"causes": [],
"agent_version": "1.0.0",
"snapshot_version": "0.1.0+3f4ce9cfe997",
"recorded_at": "2026-10-23T19:04:31.000+03:00"
}
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-summary:30d"
}
],
"freshness": {
"as_of": "2026-10-23T19:05:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"error": {
"code": "no_data",
"message": "Сводки Align за 30d ещё нет: агент её не записывал.",
"retryable": false
}
}
}norm_align_summary_upsert
Записать сводку Align за период. Идемпотентно по period: новая сводка заменяет прежнюю целиком. dimensions — семь измерений, каждое ровно один раз: сводку с повтором измерения сервер отклоняет как invalid_input. Балла нет — не передавайте score, а причину напишите в note. Вердикта нет — не передавайте verdict, а причину напишите в no_verdict_reason; при вердикте no_verdict_reason не передавайте. Шаг — только у причин. Люди — только кто вовлечён: person_id из norm_people_list и имя, без баллов и характеристик. Баллы, зону и правило подсчёта задаёт агент. Разбивку coverage.breakdown передавайте, только если прочитали список встреч периода целиком, и так, чтобы сумма её частей равнялась meetings_total, а meetings_recorded был не меньше parts.assessed и не больше meetings_total: сервер этого не проверяет. Список прочитан не целиком — разбивку не передавайте, нулями её не заменяйте. Сводку длиннее 30 000 знаков в JSON сервер не принимает и отклоняет вызов как invalid_input. Длина — число знаков JSON записи без recorded_at, как у предела ответа: буквы не экранируются, буква кириллицы — один знак. Тексты пишите одной строкой, кавычки — «ёлочками»: прямая кавычка и перевод строки занимают по два знака. recorded_at ставит сервер. Оценки про всю компанию и несут цитаты встреч: читать и писать их вправе только владелец и администратор компании, остальным реализация отвечает unauthorized_scope. Доменные состояния: not_ready — хранение оценок не настроено; temporary и rate_limited — повторите позже.
Доступ: запись · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
agent_version | да | string | Какая версия агента собрала сводку. |
causes | да | список AlignInsight | Причины — что мешает и что делать, до пяти, с шагами; пустой список — причин не нашлось. |
coverage | да | AlignCoverage | На скольких встречах построена сводка. |
dimensions | да | список AlignDimensionScore | Семь измерений, каждое ровно один раз: балл или «нет данных» с причиной. |
from | да | string (date) | Первый день периода. |
period | да | AlignPeriod | За какой период сводка; по нему её ищут и перезаписывают. |
supports | да | список AlignInsight | Опоры — что у команды хорошо, до пяти, без шагов; пустой список — опор не нашлось. |
to | да | string (date) | Последний день периода включительно: по какой день собрана сводка. |
dimensions_summary | нет | string | Итог по измерениям одной-двумя фразами. |
no_verdict_reason | нет | string | Почему вердикта нет; только вместе с отсутствием verdict. |
snapshot_version | нет | string | По какому снимку стандарта оценены встречи периода; снимков несколько — последний. |
supports_summary | нет | string | Итог по опорам одной-двумя фразами. |
verdict | нет | AlignVerdict | Вердикт по команде. Нет поля — вердикта нет, например оценено меньше пяти измерений из семи; почему — в no_verdict_reason. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
created | да | boolean | Создана ли сводка впервые; false — заменена прежняя. |
error | нет | DomainError | Почему сводка не записана и можно ли повторить. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-summary:30d",
"label": "Сводка Align"
}
],
"freshness": {
"as_of": "2026-10-23T19:05:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"created": false
}
}Пример: случай «domain_error»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "align-summary:30d"
}
],
"freshness": {
"as_of": "2026-10-23T19:05:00.000Z",
"ttl_sec": 0,
"stale": false
},
"data": {
"error": {
"code": "rate_limited",
"message": "Хранилище компании просит подождать.",
"retryable": true
}
}
}Объекты семейства
Объекты, из которых состоят аргументы и ответы инструментов этого семейства.
AlignAssessment
Оценка встречи. Вывод агента об одной встрече по ядру модуля Align стандарта NORM: встреча, её вид, исход, какую долю встречи видел судья, оценки норм, снимок стандарта и версии. meeting_id — встреча из norm_meetings_list и ключ записи. Нормы есть только у исхода assessed. Баллов в оценке нет: уровни в баллы переводит агент, когда собирает сводку. В JSON оценка не длиннее 30 000 знаков.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
agent_version | да | string | Какая версия агента оценила встречу: по ней агент решает, оценивать ли встречу заново после обновления. |
assessed_on | да | string (date) | В какой день агент оценил встречу: эта дата входит в задание судье. |
date | да | string (date) | День встречи: по нему оценки отбирают за период. |
genres | да | список AlignGenre | Вид встречи по классификатору стандарта, до трёх; пустой список — вид не определяли. |
meeting_id | да | string | Какую встречу оценили: id из norm_meetings_list; по нему оценку ищут и перезаписывают. |
norms | да | список AlignNormVerdict | Оценки норм ядра, применимых к виду встречи, — до 15, каждая норма один раз. У исходов, кроме assessed, список пуст. |
outcome | да | AlignOutcome | Чем закончилась оценка: оценена, не прошла проверку на входе, нет расшифровки или исключена. |
title | да | string | Название встречи: показать её, не открывая карточку; длиннее предела — агент обрезает. |
kit_version | нет | string | Какой версией протокола судейства стандарта оценено, например kit-v8. |
note | нет | string | Пояснение к исходу одной фразой: почему встреча исключена, не прошла проверку на входе или видна не целиком. |
recorded_at | нет | string (date-time) | Когда оценка записана: ставит сервер, во входе не нужна. |
seen_share | нет | number | Какую долю расшифровки видел судья, от 0 до 1; 1 — встречу целиком. Есть у исходов assessed и intake_failed. |
snapshot_version | нет | string | По какому снимку стандарта оценено, например 0.1.0+3f4ce9cfe997: стандарт меняется, и оценки разных дней сделаны по разным снимкам. |
AlignGenre
Вид встречи по стандарту. Вид встречи, который определил классификатор стандарта, и его уверенность. От вида зависит, какие нормы ядра к встрече применимы.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
code | да | string | Код вида встречи из стандарта, например GENRE.MEETING.STATUS — оперативка. |
confidence | да | number | Насколько классификатор уверен в этом виде, от 0 до 1. |
AlignNormVerdict
Оценка нормы. Вердикт судьи по одной норме ядра на одной встрече: код нормы, измерение, уровень, уверенность, обоснование, цитаты и чего не хватило до следующего уровня. В кратком ответе списка (brief: true) — только code, dimension, level и confidence.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
code | да | string | Какую норму оценили: код нормы ядра, например ALIGN.TRUST.N1. |
confidence | да | number | Насколько судья уверен в уровне, от 0 до 1. |
dimension | да | AlignDimension | К какому измерению относится норма: по нему уровни собирают в балл измерения. |
level | да | AlignLevel | Какой уровень поставил судья. |
missing_signals | нет | список string | Чего не хватило до следующего уровня: до трёх пунктов, главные первыми. В кратком ответе списка их нет. |
quotes | нет | список AlignQuote | На каких словах встречи держится уровень: до трёх цитат. В кратком ответе списка их нет. |
rationale | нет | string | Почему такой уровень: обоснование судьи словами. В записи обязательно; длиннее предела — агент сокращает, сохраняя вывод. В кратком ответе списка его нет. |
AlignDimension
Измерение Align. Семь измерений — семь направлений ядра модуля Align: trust — доверие (TRUST), conflicts — споры (CONFLICT), decisions — решения (DECISION), commitments — договорённости (COMMITMENT), accountability — ответственность (ACCOUNTABILITY), results — результаты (RESULTS), culture — культура (CULTURE).
Значения: trust, conflicts, decisions, commitments, accountability, results, culture.
AlignLevel
Уровень нормы. Уровень нормы по рубрике стандарта: absent — отсутствует, partial — частично, present — есть, exemplary — эталонно. absent значит «на этой встрече не видно», а не «плохо». Норму, которую судья счёл неприменимой, агент не записывает.
Значения: absent, partial, present, exemplary.
AlignQuote
Цитата. Дословная цитата из встречи, на которую опирается уровень нормы, и кто её сказал, если известно.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
text | да | string | Дословная цитата из расшифровки, без имени говорящего; длиннее предела — агент сокращает её с краёв. |
person_id | нет | string | Кто это сказал: id сотрудника из norm_people_list, если говорящего удалось узнать; сервер хранит его как есть. |
AlignOutcome
Исход оценки встречи. assessed — встреча оценена по нормам; intake_failed — не прошла проверку на входе: спор на ней не записан, нормы не оценивались; no_content — расшифровки пока нет; excluded — встреча исключена правилом агента, например встреча один на один или вдвоём. Встречи с исходами assessed, intake_failed и excluded агент повторно не берёт: запись нужна и затем, чтобы помнить, что встреча уже разобрана. Исход no_content временный: появится расшифровка — агент оценит встречу снова, и запись заменится.
Значения: assessed, intake_failed, no_content, excluded.
RejectedRecord
Непринятая запись. Запись пачки, которую сервер не принял: ключ записи, код из общего словаря и пояснение. Остальные записи пачки при этом записаны.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
code | да | ErrorCode | Почему запись не принята: код из общего словаря, по нему видна сторона. |
key | да | string | Какая запись пачки не принята: её ключ, у разбора встречи — meeting_id. |
message | нет | string | Пояснение для разработчика. |
AlignPeriod
Период сводки. 14d — последние 14 дней, 30d — 30 дней, 3m — три календарных месяца, по день to включительно. На каждый период хранится только последняя сводка.
Значения: 14d, 30d, 3m.
AlignSummary
Сводка периода. Всё, что показывает экран «Обзор» раздела Align за период: границы, покрытие, семь измерений, вердикт или причина его отсутствия, опоры и причины с панелью «На чём основано», версия агента и снимок стандарта. Баллы считает агент. В JSON сводка не длиннее 30 000 знаков.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
agent_version | да | string | Какая версия агента собрала сводку. |
causes | да | список AlignInsight | Причины — что мешает и что делать, до пяти, с шагами; пустой список — причин не нашлось. |
coverage | да | AlignCoverage | На скольких встречах построена сводка. |
dimensions | да | список AlignDimensionScore | Семь измерений, каждое ровно один раз: балл или «нет данных» с причиной. |
from | да | string (date) | Первый день периода. |
period | да | AlignPeriod | За какой период сводка; по нему её ищут и перезаписывают. |
supports | да | список AlignInsight | Опоры — что у команды хорошо, до пяти, без шагов; пустой список — опор не нашлось. |
to | да | string (date) | Последний день периода включительно: по какой день собрана сводка. |
dimensions_summary | нет | string | Итог по измерениям одной-двумя фразами. |
no_verdict_reason | нет | string | Почему вердикта нет; только вместе с отсутствием verdict. |
recorded_at | нет | string (date-time) | Когда сводка записана: ставит сервер. |
snapshot_version | нет | string | По какому снимку стандарта оценены встречи периода; снимков несколько — последний. |
supports_summary | нет | string | Итог по опорам одной-двумя фразами. |
verdict | нет | AlignVerdict | Вердикт по команде. Нет поля — вердикта нет, например оценено меньше пяти измерений из семи; почему — в no_verdict_reason. |
AlignInsight
Опора или причина. Одна опора («Что хорошо») или причина («Что мешает и что делать»): заголовок, текст, число, измерения, шаг у причины и панель «На чём основано».
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
details | да | AlignInsightDetails | Панель «На чём основано». |
dimensions | да | список AlignDimension | Какие измерения вывод держит или задевает, от одного до трёх. |
metric | да | string | Число, на котором держится вывод, для чипа, например «8 встреч из 10». |
text | да | string | Вывод словами: одно-два предложения. |
title | да | string | Вывод одной фразой: заголовок строки. |
step | нет | AlignStep | Только у причины: что делать. |
AlignInsightDetails
На чём основано. Панель «На чём основано» у вывода: почему он важен, на скольких фактах и встречах держится, показательные факты и встречи-источники с цитатой, рассуждение агента, чего агент не видит и кто вовлечён.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
blind_spot | да | string | Чего агент не видит и что может опровергнуть вывод. |
facts | да | список AlignFact | Показательные факты, на которых держится вывод, до четырёх. |
facts_total | да | integer | На скольких фактах всего держится вывод; в facts — до четырёх из них, поэтому число бывает больше списка. |
meetings | да | список AlignMeetingRef | Встречи-источники с цитатой, до четырёх самых показательных. |
meetings_total | да | integer | На скольких встречах всего держится вывод; в meetings — до четырёх самых показательных, поэтому число бывает больше списка. |
people | да | список AlignPersonRef | Кто вовлечён, до трёх человек; пустой список — никто лично. |
reasoning | да | string | Как агент пришёл к выводу: правило, по которому вывод сделан. |
why | да | string | Почему вывод важен для команды, одной фразой: её показывают первой строкой панели. |
AlignFact
Факт. Один факт, на котором держится опора или причина, и его источник.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
text | да | string | Факт одной фразой, без оценки людей. |
source | нет | AlignFactSource | Откуда факт; нет поля — источник не показывают. |
AlignFactSource
Источник факта. Откуда факт: вид источника и подпись для человека.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
kind | да | AlignFactSourceKind | Откуда факт: по виду источник показывают человеку значком. |
label | да | string | Подпись источника для человека, например «Встречи · 10». |
AlignFactSourceKind
Откуда факт. meeting — встречи и их оценки; structure — оргструктура компании: подразделения, должности, люди; other — источник, которого нет в словаре.
Значения: meeting, structure, other.
AlignMeetingRef
Встреча-источник. Встреча, на которой основан вывод, и цитата с неё.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
date | да | string (date) | День встречи. |
meeting_id | да | string | Какая встреча: id из norm_meetings_list. |
quote | да | string | Дословная цитата с этой встречи, которая подтверждает вывод. |
title | да | string | Название встречи; длиннее предела — агент обрезает. |
AlignPersonRef
Кто вовлечён. Человек, которого касается вывод: только id и имя. Баллов людям и характеристик людей в сводке нет.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
name | да | string | Как человека зовут. |
person_id | нет | string | id сотрудника из norm_people_list: по нему открывают профиль человека. Нет поля — человека не удалось сопоставить. |
AlignStep
Шаг. Что сделать с причиной: срочность, заголовок и пояснение.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
priority | да | AlignStepPriority | Насколько срочно. |
text | да | string | Почему и как: одно-два предложения. |
title | да | string | Что сделать: заголовок шага. |
AlignStepPriority
Срочность шага. now — сделать сейчас, month — в этом месяце, quarter — в этом квартале.
Значения: now, month, quarter.
AlignCoverage
Покрытие сводки. На скольких встречах построена сводка: всего за период, проверено агентом, прошло проверку на входе. Часы и люди — если агент их знает; разбивка — только если агент прочитал список встреч периода целиком.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
meetings_checked | да | integer | Сколько из них агент проверил: оценки с исходом assessed или intake_failed. |
meetings_passed_intake | да | integer | Сколько прошли проверку на входе и оценены по нормам: исход assessed. |
meetings_total | да | integer | Сколько встреч компании прошло за период. |
breakdown | нет | AlignCoverageBreakdown | Сколько встреч периода с записью и почему оценены не все. Нет поля — разбивки нет: например, агент не прочитал список встреч периода целиком или его версия разбивку ещё не пишет. |
hours | нет | integer | Сколько часов шли встречи периода, округлено до целого: показать масштаб. |
people | нет | integer | Сколько разных людей было на встречах периода: показать масштаб. |
AlignCoverageBreakdown
Разбивка покрытия. Сколько встреч периода с записью и почему оценены не все. Агент пишет разбивку, только если прочитал список встреч периода целиком; иначе поля breakdown нет — нулями его не заменяют. Периоды независимы: у короткого периода разбивка бывает и тогда, когда у длинного её нет. Сумму и границы meetings_recorded схема не проверяет. Разбивку читают как отсутствующую в любом из трёх случаев: сумма частей не равна meetings_total, meetings_recorded меньше parts.assessed, meetings_recorded больше meetings_total.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
meetings_recorded | да | integer | Сколько встреч периода с записью: в norm_meetings_list у них recorded: true. Встреча, оценённая по нормам (последняя оценка — assessed), тоже считается с записью, даже если в списке её уже нет или там recorded: false: иначе оценённых по нормам было бы больше, чем встреч с записью, и доля «оценено из встреч с записью» переваливала бы за 100 %. Не меньше parts.assessed и не больше meetings_total. |
parts | да | AlignCoverageParts | Все встречи периода по семи частям; сумма частей равна meetings_total. |
AlignCoverageParts
Части встреч периода. Все встречи периода по частям: почему встреча оценена по нормам или нет. Встречи периода — по дню встречи: из списка встреч norm_meetings_list и из оценок. Каждая встреча — ровно в одной части, по последней оценке и по списку встреч; сумма семи частей равна meetings_total.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
assessed | да | integer | Оценены по нормам: последняя оценка встречи — assessed. То же число, что meetings_passed_intake. |
awaiting_agent | да | integer | Ждут агента: в norm_meetings_list у встречи recorded: true, а оценки ещё нет. |
awaiting_transcript | да | integer | Ждут расшифровку: последняя оценка — no_content, а в norm_meetings_list у встречи recorded: true или встречи там уже нет. |
excluded_one_on_one | да | integer | Исключены как встречи вдвоём или один на один: последняя оценка — excluded с таким пояснением в note. |
excluded_other | да | integer | Исключены другим правилом агента: остальные оценки excluded — например, вид встречи не из каталога стандарта, у вида нет норм ядра, расшифровка слишком длинная, встречу не оценили за три попытки, судья счёл нормы неприменимыми. |
intake_failed | да | integer | Не прошли проверку на входе: последняя оценка — intake_failed. Вместе с assessed — meetings_checked. |
unrecorded | да | integer | Без записи: в norm_meetings_list у встречи recorded: false, а оценки нет или она no_content. |
AlignDimensionScore
Измерение в сводке. Балл одного измерения за период или «нет данных» с причиной, изменение, заметка и на скольких встречах измерение видно.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
id | да | AlignDimension | Какое измерение. |
meetings_seen | да | integer | На скольких встречах периода измерение видно: у встречи оценена хотя бы одна его норма. |
note | да | string | Что видно по измерению, одной-двумя фразами; если балла нет — почему нет данных, например «за период не было планирований и комитетов». |
delta | нет | integer | На сколько баллов изменилось к прошлому периоду той же длины; нет поля — сравнить не с чем. |
score | нет | integer | Балл измерения от 0 до 100. Нет поля — «нет данных»: за период не было встреч, где видно это измерение; почему — в note. |
AlignVerdict
Вердикт по команде. Общий балл и зона, изменение, заголовок, текст и раскрытие. Самое сильное, самое слабое и сильнее всего изменившееся измерения видно по dimensions: отдельно их не пишут.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
explanation | да | AlignVerdictExplanation | Раскрытие «Подробнее о вердикте». |
score | да | integer | Общий балл команды от 0 до 100. |
text | да | string | Вердикт словами: два-три предложения под заголовком. |
title | да | string | Вердикт одной фразой: заголовок блока. |
zone | да | AlignZone | В какой зоне команда. |
delta | нет | integer | На сколько баллов изменился общий балл к прошлому периоду той же длины; нет поля — сравнить не с чем. |
AlignVerdictExplanation
Раскрытие вердикта. Раскрытие «Подробнее о вердикте»: что вердикт значит, его следствия, как он посчитан, что изменилось к прошлому периоду и чего агент не видит.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
blind_spot | да | string | Чего агент не видит и как это может исказить вердикт. |
changes | да | список AlignDimensionChange | Главные изменения к прошлому периоду, до четырёх, каждое измерение один раз; пустой список — сравнить не с чем. |
meaning | да | string | Что вердикт значит для команды: связный абзац. |
points | да | список string | Следствия вердикта: до трёх пунктов. |
calc | нет | AlignVerdictCalc | Как посчитан вердикт. |
AlignVerdictCalc
Как посчитан вердикт. Четыре строки блока «Как посчитано» в раскрытии вердикта: состав балла, данные, шкала и предмет. Правило подсчёта — агента, поэтому и описывает его агент.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
composition | да | string | Из чего сложен балл, например «семь измерений с равным весом». |
scale | да | string | Как читать шкалу: границы зон. |
sources | да | string | По каким данным посчитано, например «48 встреч за 30 дней». |
subject | да | string | О ком вердикт: о команде и устройстве работы, не о людях. |
AlignDimensionChange
Изменение измерения. Главное изменение одного измерения к прошлому периоду: на сколько баллов и что за ним стоит.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
delta | да | integer | На сколько баллов к прошлому периоду той же длины. |
dimension | да | AlignDimension | Какое измерение изменилось. |
text | да | string | Что изменилось на встречах, одной фразой. |
AlignZone
Зона вердикта. risk — риск, unstable — неустойчиво, healthy — норма. Зону ставит агент вместе с баллом.
Значения: risk, unstable, healthy.