Skip to content

Оценки 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
      },
      "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 и имя, без баллов и характеристик. Баллы, зону и правило подсчёта задаёт агент. Сводку длиннее 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нетstringid сотрудника из 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Сколько встреч компании прошло за период.
hoursнетintegerСколько часов шли встречи периода, округлено до целого: показать масштаб.
peopleнетintegerСколько разных людей было на встречах периода: показать масштаб.

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.