Skip to main content
Glama

Вопросы и структура опроса

update_quiz_widgets
Destructive

Сохраняет структуру виджетов опроса (ids + entities). Перед вызовом прочитайте текущую структуру через ресурс quiz://{id}/structure. Тариф ограничивает число вопросов и их типы: сохранение, которое добавляет вопросы сверх лимита или вопрос недоступного типа, отклоняется. ids — массив идентификаторов виджетов по порядку; entities — объект конфигов по этим id. ВАЖНО: идентификаторы виджетов — уникальные UUID в формате RFC 4122 (например 550e8400-e29b-41d4-a716-446655440000). Допустимы только служебные строки "welcome" (первый) и "submit" (после вопросов, перед экранами finish); все остальные id обязаны быть уникальными UUID. При добавлении новых виджетов генерируйте новый UUID для каждого; дубликаты id запрещены. Экран благодарности («спасибо», thank you) — это ОТДЕЛЬНЫЙ виджет type = "finish" с новым UUID сразу после "submit"; правка полей submit его не создаёт. Спецварианты «Другое / Свой вариант», «Затрудняюсь ответить», «Ничего из перечисленного» включаются флагами choiceTextOther / dropdownOther / hardToAnswer / noneOfAbove, а не добавляются пунктами в список вариантов. Ответ инструмента содержит фактически сохранённый состав (saved: количество виджетов и разбивка по типам) — сверьтесь с ним, прежде чем отвечать пользователю, что изменение применилось.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "quiz_id": "<quiz_id>",
      "ids": "<ids>",
      "entities": "<entities>"
    },
    "name": "update_quiz_widgets"
  }
}

Input Schema

NameRequiredDescriptionDefault
idsYesПорядок виджетов: "welcome", затем уникальные UUID виджетов, затем "submit". Каждый id — уникальный UUID (кроме welcome/submit).
quiz_idYesID опроса для обновления.
entitiesYesКонфигурации виджетов: ключ — UUID из ids (уникальный для каждого виджета). Идентификаторы вариантов внутри виджета (choiceTextIds, dropdownIds, matrixRowIds и остальные списки опций) — тоже UUID, сгенерированные заново; порядковые имена вроде «q2_1» не годятся: опрос с ними сохранится, но публикация упадёт.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / entities / additionalProperties / properties / categoryProfile
      Added value: +{
      +  "description": "finish, режим «Категории»: показывать профиль по шкалам — балл каждой категории и текст её диапазона (ranges в settings.quiz_categories). Считает рендер (default: false)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / categoryProfile
      Added value: +{
      +  "description": "finish, режим «Категории»: показывать профиль по шкалам — балл каждой категории и текст её диапазона (ranges в settings.quiz_categories). Считает рендер (default: false)",
      +  "type": "boolean"
      +}
  2. Changed14 schema fields changed
    • addedInput schema / properties / entities / additionalProperties / properties / answerExplanation
      Added value: +{
      +  "description": "Тест: пояснение к правильному ответу, видно после ответа; простой текст до 1000 знаков или null",
      +  "maxLength": 1000,
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / answerKey
      Added value: +{
      +  "description": "Тест: допустимые ответы вопроса input или number, до 50 строк (у number — числа). При сверке не важны регистр, ё/е, лишние пробелы, знаки в конце и кавычки по краям; у числа — пробелы и запятая вместо точки. Вопрос добавьте в savedScoring.scoringEnabledWidgets через update_quiz_logic, иначе ответ не проверяется. Заменяется целиком",
      +  "items": {
      +    "type": [
      +      "string",
      +      "number"
      +    ]
      +  },
      +  "maxItems": 50,
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / answerKeyScore
      Added value: +{
      +  "description": "Тест: баллы за правильный ответ вопроса input или number, целое 0..1000000 или null",
      +  "maximum": 1000000,
      +  "minimum": 0,
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / answerExplanation
      Added value: +{
      +  "description": "Тест: пояснение к правильному ответу, видно после ответа; простой текст до 1000 знаков или null",
      +  "maxLength": 1000,
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / answerKey
      Added value: +{
      +  "description": "Тест: допустимые ответы вопроса input или number, до 50 строк (у number — числа). При сверке не важны регистр, ё/е, лишние пробелы, знаки в конце и кавычки по краям; у числа — пробелы и запятая вместо точки. Вопрос добавьте в savedScoring.scoringEnabledWidgets через update_quiz_logic, иначе ответ не проверяется. Заменяется целиком",
      +  "items": {
      +    "type": [
      +      "string",
      +      "number"
      +    ]
      +  },
      +  "maxItems": 50,
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / answerKeyScore
      Added value: +{
      +  "description": "Тест: баллы за правильный ответ вопроса input или number, целое 0..1000000 или null",
      +  "maximum": 1000000,
      +  "minimum": 0,
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / passScore
      Added value: +{
      +  "description": "finish: проходной балл теста, {\"value\": 70, \"unit\": \"percent\"} или {\"value\": 7, \"unit\": \"points\"}; респондент видит «Тест пройден» или «Тест не пройден». null — без проходного балла",
      +  "properties": {
      +    "unit": {
      +      "enum": [
      +        "percent",
      +        "points"
      +      ],
      +      "type": "string"
      +    },
      +    "value": {
      +      "minimum": 0,
      +      "type": "number"
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / randomGroupPick
      Added value: +{
      +  "description": "Сколько вопросов набора (randomGroupId) показать: одно целое ≥ 1 у всех вопросов набора; остальные приходят без ответа, как скрытые логикой. Нужен question_random_mode = groups (нет поля — показываются все вопросы набора)",
      +  "minimum": 1,
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / scoreShowMax
      Added value: +{
      +  "description": "finish: писать максимум рядом с суммой баллов: «Вы набрали 7 баллов из 10»",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / type / description
      Previous value: -"Тип виджета. Экраны: welcome — экран приветствия (первый); submit — обязательный экран отправки (последний, с кнопкой «Отправить»); finish — экран благодарности (он же «спасибо», «thank you», страница после отправки) — отдельный виджет, его нужно добавить в ids; screenout — экран отсева (респондент не подходит под условия)."New value: +"Тип виджета. Экраны: welcome — экран приветствия (первый); submit — обязательный экран отправки (после вопросов, с кнопкой «Отправить»; за ним только экраны finish); finish — экран благодарности (он же «спасибо», «thank you», страница после отправки) — отдельный виджет, его нужно добавить в ids; screenout — экран отсева (респондент не подходит под условия)."
    • addedInput schema / properties / entities / additionalProperties / properties / passScore
      Added value: +{
      +  "description": "finish: проходной балл теста, {\"value\": 70, \"unit\": \"percent\"} или {\"value\": 7, \"unit\": \"points\"}; респондент видит «Тест пройден» или «Тест не пройден». null — без проходного балла",
      +  "properties": {
      +    "unit": {
      +      "enum": [
      +        "percent",
      +        "points"
      +      ],
      +      "type": "string"
      +    },
      +    "value": {
      +      "minimum": 0,
      +      "type": "number"
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / randomGroupPick
      Added value: +{
      +  "description": "Сколько вопросов набора (randomGroupId) показать: одно целое ≥ 1 у всех вопросов набора; остальные приходят без ответа, как скрытые логикой. Нужен question_random_mode = groups (нет поля — показываются все вопросы набора)",
      +  "minimum": 1,
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / scoreShowMax
      Added value: +{
      +  "description": "finish: писать максимум рядом с суммой баллов: «Вы набрали 7 баллов из 10»",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / type / description
      Previous value: -"Тип виджета. Экраны: welcome — экран приветствия (первый); submit — обязательный экран отправки (последний, с кнопкой «Отправить»); finish — экран благодарности (он же «спасибо», «thank you», страница после отправки) — отдельный виджет, его нужно добавить в ids; screenout — экран отсева (респондент не подходит под условия)."New value: +"Тип виджета. Экраны: welcome — экран приветствия (первый); submit — обязательный экран отправки (после вопросов, с кнопкой «Отправить»; за ним только экраны finish); finish — экран благодарности (он же «спасибо», «thank you», страница после отправки) — отдельный виджет, его нужно добавить в ids; screenout — экран отсева (респондент не подходит под условия)."
  3. Changed2 schema fields changed
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / rankingImageLayout
      Added value: +{
      +  "description": "Как показывать картинки вариантов при rankingWithImages: thumbnail — миниатюры у подписи, full — каждая картинка целиком под подписью",
      +  "enum": [
      +    "thumbnail",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / rankingImageLayout
      Added value: +{
      +  "description": "Как показывать картинки вариантов при rankingWithImages: thumbnail — миниатюры у подписи, full — каждая картинка целиком под подписью",
      +  "enum": [
      +    "thumbnail",
      +    "full"
      +  ],
      +  "type": "string"
      +}
  4. Changed42 schema fields changed
    • changedInput schema / properties / entities / additionalProperties / properties / abVariantEntities / description
      Previous value: -"Конфигурации вариантов A/B-теста по UUID. Вариант: { \"name\": \"подпись для автора, условий и отчёта\", \"title\": \"заголовок варианта\", \"description\": \"описание варианта\", \"percent\": <целое 0..100> }. Сумма percent по всем вариантам должна быть ровно 100 — иначе часть респондентов не получит ни одного варианта. Ключи объекта обязаны совпадать с abVariantIds: порядок показа берётся из ids. Варианты подменяют только заголовок и описание, ответную часть (опции, шкалу) они не меняют. Для контент-блоков message и html вариант может дополнительно задать media, mediaType (image|video|audio) и nextUrl. A/B-теста не бывает у welcome, submit, finish, screenout, inline_group и payment."New value: +"Конфигурации вариантов A/B-теста по UUID. Вариант: { \"name\": \"подпись для автора, условий и отчёта\", \"title\": \"заголовок варианта\", \"description\": \"описание варианта\", \"percent\": <целое 0..100> }. Сумма percent по всем вариантам должна быть ровно 100 — иначе часть респондентов не получит ни одного варианта. Ключи объекта обязаны совпадать с abVariantIds: порядок показа берётся из ids. Варианты подменяют только заголовок и описание, ответную часть (опции, шкалу) они не меняют. Для контент-блоков message и html вариант может дополнительно задать media, mediaType (image|video|audio) и nextUrl. A/B-теста не бывает у welcome, submit, finish, screenout, inline_group, payment."
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / abVariantEntities / description
      Previous value: -"Конфигурации вариантов A/B-теста по UUID. Вариант: { \"name\": \"подпись для автора, условий и отчёта\", \"title\": \"заголовок варианта\", \"description\": \"описание варианта\", \"percent\": <целое 0..100> }. Сумма percent по всем вариантам должна быть ровно 100 — иначе часть респондентов не получит ни одного варианта. Ключи объекта обязаны совпадать с abVariantIds: порядок показа берётся из ids. Варианты подменяют только заголовок и описание, ответную часть (опции, шкалу) они не меняют. Для контент-блоков message и html вариант может дополнительно задать media, mediaType (image|video|audio) и nextUrl. A/B-теста не бывает у welcome, submit, finish, screenout, inline_group и payment."New value: +"Конфигурации вариантов A/B-теста по UUID. Вариант: { \"name\": \"подпись для автора, условий и отчёта\", \"title\": \"заголовок варианта\", \"description\": \"описание варианта\", \"percent\": <целое 0..100> }. Сумма percent по всем вариантам должна быть ровно 100 — иначе часть респондентов не получит ни одного варианта. Ключи объекта обязаны совпадать с abVariantIds: порядок показа берётся из ids. Варианты подменяют только заголовок и описание, ответную часть (опции, шкалу) они не меняют. Для контент-блоков message и html вариант может дополнительно задать media, mediaType (image|video|audio) и nextUrl. A/B-теста не бывает у welcome, submit, finish, screenout, inline_group, payment."
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / mediaAllowText
      Added value: +{
      +  "description": "Аудио- и видеоответ: разрешить ответить текстом вместо записи (по умолчанию true)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / mediaAllowUpload
      Added value: +{
      +  "description": "Аудио- и видеоответ: разрешить загрузить готовый файл (по умолчанию true)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / mediaMaxDurationSeconds
      Added value: +{
      +  "description": "Аудио- и видеоответ: максимальная длительность записи, секунд (10..300, по умолчанию 120). Действует и на загруженные файлы",
      +  "maximum": 300,
      +  "minimum": 10,
      +  "type": "integer"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / mediaTranscriptionEnabled
      Added value: +{
      +  "description": "Аудио- и видеоответ: расшифровывать записи в текст (по умолчанию true; расходует минуты расшифровки пространства)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / mediaTranscriptionLanguage
      Added value: +{
      +  "description": "Аудио- и видеоответ: язык расшифровки — auto (русский или английский, определяется сам), ru, en; по умолчанию auto",
      +  "enum": [
      +    "auto",
      +    "ru",
      +    "en"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / npsColorMode
      Added value: +{
      +  "description": "NPS: цвет — theme, group, groups_visible или gradient. Новый NPS — group. Нет поля — theme",
      +  "enum": [
      +    "theme",
      +    "group",
      +    "groups_visible",
      +    "gradient"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / npsView
      Added value: +{
      +  "description": "NPS: вид шкалы — buttons (кнопки), bar (полоса), circles (кружки) или slider (ползунок). Новый NPS — buttons. Нет поля у существующего вопроса — прежний вид",
      +  "enum": [
      +    "buttons",
      +    "bar",
      +    "circles",
      +    "slider"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / phoneDefaultCountry / description
      Previous value: -"Страна по умолчанию (ISO 3166-1 alpha-2). Допустимы: RU, BY, UA, KZ, TJ, US, GB, DE, FR, IT, ES, PL, CN, JP, KR, IN, BR, AU, CA, MX, AR, TR. Дефолт RU."New value: +"Страна по умолчанию (ISO 3166-1 alpha-2). Допустимы: RU, BY, UA, KZ, TJ, US, GB, DE, FR, IT, ES, PL, CN, JP, KR, IN, BR, AU, CA, MX, AR, TR. Дефолт — по языку опроса: ru → RU, en → US, es → ES, pt → BR."
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingColorMode
      Added value: +{
      +  "description": "Оценка: цвет выбранной оценки — theme (как в теме) или score (от красного у низшей до зелёного у высшей). Нет поля — theme",
      +  "enum": [
      +    "theme",
      +    "score"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingFigure / enum
      Previous value: -[
      -  "star",
      -  "heart",
      -  "users",
      -  "thumb",
      -  "crown",
      -  "cat",
      -  "dog",
      -  "circle",
      -  "flag",
      -  "droplet",
      -  "tick",
      -  "lightbulb",
      -  "trophy",
      -  "cloud",
      -  "thunderbolt",
      -  "pencil",
      -  "skull"
      -]New value: +[
      +  "star",
      +  "heart",
      +  "users",
      +  "thumb",
      +  "crown",
      +  "cat",
      +  "dog",
      +  "circle",
      +  "flag",
      +  "droplet",
      +  "tick",
      +  "lightbulb",
      +  "trophy",
      +  "cloud",
      +  "thunderbolt",
      +  "pencil",
      +  "skull",
      +  "smile",
      +  "diamond",
      +  "target",
      +  "fire",
      +  "briefcase",
      +  "graduation",
      +  "book",
      +  "house",
      +  "coffee",
      +  "bell",
      +  "clock",
      +  "coin",
      +  "gift",
      +  "sun",
      +  "leaf",
      +  "music",
      +  "paw"
      +]
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingFollowUpEnabled
      Added value: +{
      +  "description": "Оценка: спрашивать причину оценки после отмеченных оценок. Нет поля — не спрашивать",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingFollowUpQuestion
      Added value: +{
      +  "description": "Оценка: вопрос о причине, один на все отмеченные оценки, простой текст до 140 символов",
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingFollowUpValues
      Added value: +{
      +  "additionalProperties": {
      +    "type": "boolean"
      +  },
      +  "description": "Оценка: после каких оценок спрашивать причину, ключ — значение строкой → true/false",
      +  "type": "object"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingLabels
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "Оценка: слово для каждой оценки, ключ — значение строкой («1»…«10», «0» у шкалы с нуля), простой текст до 40 символов. Пустое слово — показывается число",
      +  "type": "object"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingLabelsMode
      Added value: +{
      +  "description": "Оценка: где подписи — picked (слово выбранной оценки), under (под каждой иконкой), edges (по краям) или none. Новая оценка — picked. Нет поля у существующего вопроса — none",
      +  "enum": [
      +    "picked",
      +    "under",
      +    "edges",
      +    "none"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / ratingView
      Added value: +{
      +  "description": "Оценка: вид — icons (иконки), tiles (плитки), bar (полоса) или slider (ползунок). Новая оценка — icons. Нет поля — icons",
      +  "enum": [
      +    "icons",
      +    "tiles",
      +    "bar",
      +    "slider"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / scaleColorMode
      Added value: +{
      +  "description": "Шкала: цвет — theme, score или gradient. Новая шкала — theme. Нет поля — theme",
      +  "enum": [
      +    "theme",
      +    "score",
      +    "gradient"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / scaleView
      Added value: +{
      +  "description": "Шкала: вид — buttons (кнопки), bar (полоса), circles (кружки) или slider (ползунок). Новая шкала — buttons. Нет поля у существующего вопроса — прежний вид",
      +  "enum": [
      +    "buttons",
      +    "bar",
      +    "circles",
      +    "slider"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / translations
      Added value: +{
      +  "description": "Языки опроса: переводы текстов этого вопроса, { \"<код языка из settings.languages>\": { \"<путь к тексту внутри вопроса>\": { \"t\": \"перевод\" } } }. Путь — через точку, элемент массива — по номеру: \"title\", \"description\", \"choiceTextEntities.<id варианта>.label\", \"finishWidgetLogic.0.headText\". Где оригинал в HTML, перевод — HTML с той же разметкой; упоминания и {{…}} / %…% остаются как есть. Присланные ключи сливаются с сохранёнными. Нет перевода — показывается текст основного языка.",
      +  "type": "object"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / type / enum
      Previous value: -[
      -  "welcome",
      -  "submit",
      -  "finish",
      -  "screenout",
      -  "yesno",
      -  "choice",
      -  "dropdown",
      -  "ranking",
      -  "slider",
      -  "rating",
      -  "scale",
      -  "nps",
      -  "input",
      -  "number",
      -  "fio",
      -  "pair",
      -  "pair_manual",
      -  "area_select",
      -  "email",
      -  "phone",
      -  "datetime",
      -  "matrix",
      -  "matrix_3d",
      -  "message",
      -  "file",
      -  "html",
      -  "payment",
      -  "inline_group",
      -  "click_test",
      -  "area_highlight",
      -  "map",
      -  "allocation_slider",
      -  "smile-rating",
      -  "semantic_differential",
      -  "booking"
      -]New value: +[
      +  "welcome",
      +  "submit",
      +  "finish",
      +  "screenout",
      +  "yesno",
      +  "choice",
      +  "dropdown",
      +  "ranking",
      +  "slider",
      +  "rating",
      +  "scale",
      +  "nps",
      +  "input",
      +  "number",
      +  "fio",
      +  "pair",
      +  "pair_manual",
      +  "area_select",
      +  "email",
      +  "phone",
      +  "datetime",
      +  "matrix",
      +  "matrix_3d",
      +  "message",
      +  "file",
      +  "html",
      +  "payment",
      +  "inline_group",
      +  "click_test",
      +  "area_highlight",
      +  "map",
      +  "allocation_slider",
      +  "smile-rating",
      +  "semantic_differential",
      +  "booking",
      +  "audio_response",
      +  "video_response"
      +]
    • addedInput schema / properties / entities / additionalProperties / properties / mediaAllowText
      Added value: +{
      +  "description": "Аудио- и видеоответ: разрешить ответить текстом вместо записи (по умолчанию true)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / mediaAllowUpload
      Added value: +{
      +  "description": "Аудио- и видеоответ: разрешить загрузить готовый файл (по умолчанию true)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / mediaMaxDurationSeconds
      Added value: +{
      +  "description": "Аудио- и видеоответ: максимальная длительность записи, секунд (10..300, по умолчанию 120). Действует и на загруженные файлы",
      +  "maximum": 300,
      +  "minimum": 10,
      +  "type": "integer"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / mediaTranscriptionEnabled
      Added value: +{
      +  "description": "Аудио- и видеоответ: расшифровывать записи в текст (по умолчанию true; расходует минуты расшифровки пространства)",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / mediaTranscriptionLanguage
      Added value: +{
      +  "description": "Аудио- и видеоответ: язык расшифровки — auto (русский или английский, определяется сам), ru, en; по умолчанию auto",
      +  "enum": [
      +    "auto",
      +    "ru",
      +    "en"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / npsColorMode
      Added value: +{
      +  "description": "NPS: цвет — theme, group, groups_visible или gradient. Новый NPS — group. Нет поля — theme",
      +  "enum": [
      +    "theme",
      +    "group",
      +    "groups_visible",
      +    "gradient"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / npsView
      Added value: +{
      +  "description": "NPS: вид шкалы — buttons (кнопки), bar (полоса), circles (кружки) или slider (ползунок). Новый NPS — buttons. Нет поля у существующего вопроса — прежний вид",
      +  "enum": [
      +    "buttons",
      +    "bar",
      +    "circles",
      +    "slider"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / phoneDefaultCountry / description
      Previous value: -"Страна по умолчанию (ISO 3166-1 alpha-2). Допустимы: RU, BY, UA, KZ, TJ, US, GB, DE, FR, IT, ES, PL, CN, JP, KR, IN, BR, AU, CA, MX, AR, TR. Дефолт RU."New value: +"Страна по умолчанию (ISO 3166-1 alpha-2). Допустимы: RU, BY, UA, KZ, TJ, US, GB, DE, FR, IT, ES, PL, CN, JP, KR, IN, BR, AU, CA, MX, AR, TR. Дефолт — по языку опроса: ru → RU, en → US, es → ES, pt → BR."
    • addedInput schema / properties / entities / additionalProperties / properties / ratingColorMode
      Added value: +{
      +  "description": "Оценка: цвет выбранной оценки — theme (как в теме) или score (от красного у низшей до зелёного у высшей). Нет поля — theme",
      +  "enum": [
      +    "theme",
      +    "score"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / ratingFigure / enum
      Previous value: -[
      -  "star",
      -  "heart",
      -  "users",
      -  "thumb",
      -  "crown",
      -  "cat",
      -  "dog",
      -  "circle",
      -  "flag",
      -  "droplet",
      -  "tick",
      -  "lightbulb",
      -  "trophy",
      -  "cloud",
      -  "thunderbolt",
      -  "pencil",
      -  "skull"
      -]New value: +[
      +  "star",
      +  "heart",
      +  "users",
      +  "thumb",
      +  "crown",
      +  "cat",
      +  "dog",
      +  "circle",
      +  "flag",
      +  "droplet",
      +  "tick",
      +  "lightbulb",
      +  "trophy",
      +  "cloud",
      +  "thunderbolt",
      +  "pencil",
      +  "skull",
      +  "smile",
      +  "diamond",
      +  "target",
      +  "fire",
      +  "briefcase",
      +  "graduation",
      +  "book",
      +  "house",
      +  "coffee",
      +  "bell",
      +  "clock",
      +  "coin",
      +  "gift",
      +  "sun",
      +  "leaf",
      +  "music",
      +  "paw"
      +]
    • addedInput schema / properties / entities / additionalProperties / properties / ratingFollowUpEnabled
      Added value: +{
      +  "description": "Оценка: спрашивать причину оценки после отмеченных оценок. Нет поля — не спрашивать",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / ratingFollowUpQuestion
      Added value: +{
      +  "description": "Оценка: вопрос о причине, один на все отмеченные оценки, простой текст до 140 символов",
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / ratingFollowUpValues
      Added value: +{
      +  "additionalProperties": {
      +    "type": "boolean"
      +  },
      +  "description": "Оценка: после каких оценок спрашивать причину, ключ — значение строкой → true/false",
      +  "type": "object"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / ratingLabels
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "Оценка: слово для каждой оценки, ключ — значение строкой («1»…«10», «0» у шкалы с нуля), простой текст до 40 символов. Пустое слово — показывается число",
      +  "type": "object"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / ratingLabelsMode
      Added value: +{
      +  "description": "Оценка: где подписи — picked (слово выбранной оценки), under (под каждой иконкой), edges (по краям) или none. Новая оценка — picked. Нет поля у существующего вопроса — none",
      +  "enum": [
      +    "picked",
      +    "under",
      +    "edges",
      +    "none"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / ratingView
      Added value: +{
      +  "description": "Оценка: вид — icons (иконки), tiles (плитки), bar (полоса) или slider (ползунок). Новая оценка — icons. Нет поля — icons",
      +  "enum": [
      +    "icons",
      +    "tiles",
      +    "bar",
      +    "slider"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / scaleColorMode
      Added value: +{
      +  "description": "Шкала: цвет — theme, score или gradient. Новая шкала — theme. Нет поля — theme",
      +  "enum": [
      +    "theme",
      +    "score",
      +    "gradient"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / scaleView
      Added value: +{
      +  "description": "Шкала: вид — buttons (кнопки), bar (полоса), circles (кружки) или slider (ползунок). Новая шкала — buttons. Нет поля у существующего вопроса — прежний вид",
      +  "enum": [
      +    "buttons",
      +    "bar",
      +    "circles",
      +    "slider"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / translations
      Added value: +{
      +  "description": "Языки опроса: переводы текстов этого вопроса, { \"<код языка из settings.languages>\": { \"<путь к тексту внутри вопроса>\": { \"t\": \"перевод\" } } }. Путь — через точку, элемент массива — по номеру: \"title\", \"description\", \"choiceTextEntities.<id варианта>.label\", \"finishWidgetLogic.0.headText\". Где оригинал в HTML, перевод — HTML с той же разметкой; упоминания и {{…}} / %…% остаются как есть. Присланные ключи сливаются с сохранёнными. Нет перевода — показывается текст основного языка.",
      +  "type": "object"
      +}
    • changedInput schema / properties / entities / additionalProperties / properties / type / enum
      Previous value: -[
      -  "welcome",
      -  "submit",
      -  "finish",
      -  "screenout",
      -  "yesno",
      -  "choice",
      -  "dropdown",
      -  "ranking",
      -  "slider",
      -  "rating",
      -  "scale",
      -  "nps",
      -  "input",
      -  "number",
      -  "fio",
      -  "pair",
      -  "pair_manual",
      -  "area_select",
      -  "email",
      -  "phone",
      -  "datetime",
      -  "matrix",
      -  "matrix_3d",
      -  "message",
      -  "file",
      -  "html",
      -  "payment",
      -  "inline_group",
      -  "click_test",
      -  "area_highlight",
      -  "map",
      -  "allocation_slider",
      -  "smile-rating",
      -  "semantic_differential",
      -  "booking"
      -]New value: +[
      +  "welcome",
      +  "submit",
      +  "finish",
      +  "screenout",
      +  "yesno",
      +  "choice",
      +  "dropdown",
      +  "ranking",
      +  "slider",
      +  "rating",
      +  "scale",
      +  "nps",
      +  "input",
      +  "number",
      +  "fio",
      +  "pair",
      +  "pair_manual",
      +  "area_select",
      +  "email",
      +  "phone",
      +  "datetime",
      +  "matrix",
      +  "matrix_3d",
      +  "message",
      +  "file",
      +  "html",
      +  "payment",
      +  "inline_group",
      +  "click_test",
      +  "area_highlight",
      +  "map",
      +  "allocation_slider",
      +  "smile-rating",
      +  "semantic_differential",
      +  "booking",
      +  "audio_response",
      +  "video_response"
      +]
  5. Changed6 schema fields changed
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / npsFollowUpEnabled
      Added value: +{
      +  "description": "NPS: спрашивать причину оценки под шкалой. Нет поля — не спрашивать",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / npsFollowUpGroups
      Added value: +{
      +  "additionalProperties": {
      +    "type": "boolean"
      +  },
      +  "description": "NPS: какие группы спрашивать — detractors (0–6), passives (7–8), promoters (9–10) → true/false. Нет ключа — группу спрашиваем",
      +  "type": "object"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / npsFollowUpQuestions
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "NPS: вопрос о причине для каждой группы (detractors, passives, promoters), простой текст до 140 символов. Пустой — группу не спрашиваем",
      +  "type": "object"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / npsFollowUpEnabled
      Added value: +{
      +  "description": "NPS: спрашивать причину оценки под шкалой. Нет поля — не спрашивать",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / npsFollowUpGroups
      Added value: +{
      +  "additionalProperties": {
      +    "type": "boolean"
      +  },
      +  "description": "NPS: какие группы спрашивать — detractors (0–6), passives (7–8), promoters (9–10) → true/false. Нет ключа — группу спрашиваем",
      +  "type": "object"
      +}
    • addedInput schema / properties / entities / additionalProperties / properties / npsFollowUpQuestions
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "NPS: вопрос о причине для каждой группы (detractors, passives, promoters), простой текст до 140 символов. Пустой — группу не спрашиваем",
      +  "type": "object"
      +}
  6. Changed16 schema fields changed
    • changedInput schema / properties / entities / additionalProperties / properties / choiceImageEntities / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор"New value: +"Балл за выбор (целое число)"
    • changedInput schema / properties / entities / additionalProperties / properties / choiceImageEntities / additionalProperties / properties / score / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / entities / additionalProperties / properties / choiceTextEntities / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор"New value: +"Балл за выбор (целое число)"
    • changedInput schema / properties / entities / additionalProperties / properties / choiceTextEntities / additionalProperties / properties / score / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / entities / additionalProperties / properties / dropdownScores / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор (число или строка)"New value: +"Балл за выбор (целое число или строка из цифр)"
    • changedInput schema / properties / entities / additionalProperties / properties / dropdownScores / additionalProperties / properties / score / type
      Previous value: -[
      -  "number",
      -  "string"
      -]New value: +[
      +  "integer",
      +  "string"
      +]
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / choiceImageEntities / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор"New value: +"Балл за выбор (целое число)"
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / choiceImageEntities / additionalProperties / properties / score / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / choiceTextEntities / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор"New value: +"Балл за выбор (целое число)"
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / choiceTextEntities / additionalProperties / properties / score / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / dropdownScores / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор (число или строка)"New value: +"Балл за выбор (целое число или строка из цифр)"
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / dropdownScores / additionalProperties / properties / score / type
      Previous value: -[
      -  "number",
      -  "string"
      -]New value: +[
      +  "integer",
      +  "string"
      +]
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / yesNoTextEntities / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор"New value: +"Балл за выбор (целое число)"
    • changedInput schema / properties / entities / additionalProperties / properties / groupWidgets / properties / entities / additionalProperties / properties / yesNoTextEntities / additionalProperties / properties / score / type
      Previous value: -"number"New value: +"integer"
    • changedInput schema / properties / entities / additionalProperties / properties / yesNoTextEntities / additionalProperties / properties / score / description
      Previous value: -"Балл за выбор"New value: +"Балл за выбор (целое число)"
    • changedInput schema / properties / entities / additionalProperties / properties / yesNoTextEntities / additionalProperties / properties / score / type
      Previous value: -"number"New value: +"integer"
  7. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true and non-idempotent, and the description adds real behavioral detail: full-structure replacement semantics, tariff-based rejection, UUID/ordering constraints, and the fact that the response returns the actually saved composition ('saved') to verify before reporting success. It does not state what happens to widgets omitted from ids (whether their answers are lost), which is a material gap for a destructive save.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded, then prerequisites, then hard constraints, then the verification step — a sensible order. It is a single dense block with some redundancy against the already verbose schema (notably the special-option flags), but every sentence carries actionable guidance.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a three-parameter but deeply nested replacement tool with no output schema, the description covers id generation, ordering, special-answer flags, and the saved-summary verification. It leaves out the most consequential unknown for a destructive operation: whether dropping an id deletes that widget and its collected answers. That omission keeps it at minimum-viable-plus rather than complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3, but the description adds meaning beyond the schema: the RFC 4122 UUID format with an example, the rule to generate a fresh UUID per new widget, the ban on duplicate ids, and the required ordering (welcome first, submit after questions and before finish screens). Some of this duplicates the schema's own enum and flag descriptions, keeping it from a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: saves ('Сохраняет') the widget structure of a quiz as an ordered ids array plus entities configs. That is concrete enough to distinguish it from the sibling text/logic updaters by scope, though it never names an alternative tool explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a clear prerequisite — read the current structure via quiz://{id}/structure before calling — and states that saves exceeding the tariff's question/type limits are rejected. It stops short of explicit alternatives or exclusions (e.g., 'use update_quiz_texts for texts'), so it is strong context without full when/when-not routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources