Skip to main content
Glama

Настройки опроса

update_quiz_settings
Destructive

Обновляет настройки опроса (название, язык, отображение, навигация, ограничения по времени и числу ответов, капча, тема, QR-код, таймер заполнения, IP/устройства, расписание доступа, аналитика и пиксели, SSO, анонимные ответы, категорийный скоринг и др.). Передаются только те поля, которые нужно изменить; остальные не трогаются.

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>"
    },
    "name": "update_quiz_settings"
  }
}

Input Schema

NameRequiredDescriptionDefault
langNoЯзык интерфейса опроса: ru, en, es или pt.
nameNoНазвание опроса (макс. 255 символов).
quiz_idYesID опроса, настройки которого нужно изменить.
theme_idNoID темы: общей или из воркспейса опроса (целое ≥ 1).
languagesNoЯзыки опроса: {items: [{code, enabled}]} — дополнительные языки кроме основного lang (код из списка, не больше 10, без повторов, не основной язык); enabled — показывать респондентам после публикации. Необязательный picker — как респондент выбирает язык: screen (экран выбора до опроса), buttons (кнопки языков над заголовком первого экрана), corner (переключатель в углу каждого экрана), none (без выбора: язык из ?lang= или браузера); без поля — как screen. Список целиком заменяет сохранённый; null — один язык. Тексты переводятся в поле translations каждого вопроса ({<код>: {<путь внутри вопроса>: {t: текст}}}) через update_quiz_widgets; кнопки и сообщения языка — update_quiz_texts с locale. Добавить или показать язык можно только с опцией тарифа publication.survey_languages.
info_titleNoЗаголовок (мета, макс. 500 символов, без ссылок).
numerationNoВключить нумерацию вопросов.
sso_activeNoТребовать вход через SSO перед прохождением опроса.
descriptionNoОписание опроса (мета, макс. 5000 символов).
multiple_ipNoРазрешить прохождение с нескольких IP (иначе один IP на прохождение).
show_by_oneNoПоказывать по одному вопросу на экране.
extra_fieldsNoСписок скрытых переменных (extra fields): массив объектов с полями id (UUID) и name (макс. 250 символов).
ip_blacklistNoЧёрный список IP (макс. 5000 символов).
ip_whitelistNoБелый список IP (макс. 5000 символов).
qr_code_sizeNoРазмер QR-кода в пикселях (1–1000).
show_captchaNoПоказывать капчу при отправке ответа.
use_passwordNoТребовать пароль для доступа к опросу.
fb_pixel_codeNoИдентификатор пикселя Facebook (макс. 100 символов).
qr_code_colorNoЦвет QR-кода (макс. 50 символов).
schedule_daysNoДни недели, в которые опрос доступен: массив чисел 1–7 по ISO (1 — понедельник, 7 — воскресенье).
show_navigateNoПоказывать навигацию (кнопки назад/вперёд).
vk_pixel_codeNoИдентификатор пикселя VK (макс. 100 символов).
qr_code_formatNoФормат файла QR-кода: png, svg или eps. Это запомненная настройка опроса; сам код собирает manage_quiz_qr_code.
qr_code_marginNoОтступ QR-кода (0–100).
show_to_robotsNoДоступность страницы опроса для поисковых роботов.
correct_answersNoПоказывать и использовать корректные ответы для тестового сценария.
ip_list_enabledNoВключить фильтрацию по спискам IP (белый/чёрный список).
is_change_themeNoМенять тему оформления по данным из QR-кода.
quiz_categoriesNoСписок категорий для категорийного скоринга: массив объектов { "id": "<строка>", "name": "<название>" }. Порядок значим: при равенстве баллов побеждает категория, идущая раньше. Веса категорий задаются у опций виджетов, а не здесь. Категория — ещё и шкала: необязательные ranges [{id, from, to, text}] — диапазоны с текстом для экрана результата (границы целые и включаются, null — без границы, text — простой текст до 1000 знаков, до 50 диапазонов), normUnit (sten, stanine, t, percentile) и norms [{id, from, to, value}] — перевод сырого балла в значение нормы (до 100 строк). Список заменяется целиком: передавайте категории со всеми их полями.
scripts_in_bodyNoКод скриптов, вставляемых в <body> (макс. 65535 символов). Хранится без санитизации — ответственность за безопасность содержимого на стороне рендерера.
scripts_in_headNoКод скриптов, вставляемых в <head> (макс. 65535 символов). Хранится без санитизации — ответственность за безопасность содержимого на стороне рендерера.
category_scoringNoВключить категорийный скоринг: баллы опций суммируются по категориям, победившая категория пишется в ответ.
detailed_journalNoПодробный журнал прохождения в протоколе ответа (get_answer_protocol): уход со вкладки, вставка текста, возвраты к вопросам. Только тариф Enterprise: включить на другом тарифе — ошибка.
limit_time_valueNoДата/время окончания доступности (макс. 50 символов; пустая строка — сброс).
matrix_transposeNoТранспонировать матричные вопросы в отчёте: строки и столбцы меняются местами.
schedule_enabledNoВключить доступ к опросу по расписанию (дни недели + интервал времени).
schedule_time_toNoКонец интервала доступности в формате H:i (например "18:00"). Трактуется в таймзоне schedule_timezone.
scoring_switcherNoВключить переключатель подсчёта баллов в опросе.
show_progressbarNoПоказывать прогресс-бар прохождения опроса.
sso_allow_retakeNoРазрешать SSO-респонденту пройти опрос повторно.
available_devicesNoДоступные устройства: массив из desktop, mobile, tablet.
schedule_timezoneNoТаймзона расписания, идентификатор IANA (например "Europe/Moscow").
answers_allow_editNoРазрешить респонденту редактировать уже отправленный ответ. Работает только вместе с SSO (sso_active) или подтверждением e-mail (require_email_verification) — иначе ссылка на редактирование не выдаётся.
auto_move_by_enterNoПереход к следующему вопросу по нажатию Enter.
auto_save_progressNoАвтосохранение прогресса: респондент может вернуться и продолжить с того же места.
captcha_public_keyNoПубличный ключ капчи (макс. 500 символов).
captcha_secret_keyNoСекретный ключ капчи (макс. 500 символов).
close_quiz_enabledNoОпрос закрыт (приём ответов отключён).
fb_pixel_is_activeNoВключить пиксель Facebook.
limit_message_bodyNoТекст сообщения при достижении лимита ответов (макс. 5000 символов).
limit_time_enabledNoВключить ограничение по времени доступности опроса.
report_row_optionsNoНастройки строк отчёта: sort_mode (default, asc, desc) и value_format (both, count, percent). null возвращает стандартное поведение.
results_appearanceNoОформление отчёта этого опроса: palette_id, custom_colors, bar_color_mode, font_family, show_value_labels, show_grid_lines. null возвращает стандартный вид. Передача этого объекта заодно выключает results_appearance_use_shared — иначе цвета не применились бы, потому что общая палитра аккаунта имеет приоритет. Допустимые значения и текущая палитра аккаунта: get_workspace_report_appearance.
schedule_time_fromNoНачало интервала доступности в формате H:i (например "09:00"). Трактуется в таймзоне schedule_timezone.
vk_pixel_is_activeNoВключить пиксель VK.
anonymous_responsesNoАнонимные ответы: не сохранять данные, идентифицирующие респондента.
limit_message_titleNoЗаголовок сообщения при достижении лимита ответов (макс. 500 символов).
limit_time_timezoneNoТаймзона для ограничения по времени (макс. 100 символов).
limit_time_value_tzNoЗначение времени с таймзоной (макс. 50 символов).
question_timer_modeNoТаймер обратного отсчёта на вопрос: individual, all_enabled или all_disabled.
filling_time_enabledNoВключить таймер времени на заполнение опроса.
filling_time_secondsNoВремя на заполнение в секундах (0–86400).
question_random_modeNoЧто перемешивать при случайном порядке: all — всю анкету, groups — только вопросы, отмеченные полем randomGroupId (каждый набор перемешивается по своим позициям). По умолчанию all.
session_check_methodNoМетоды проверки сессии: массив из ip, cookie, extra_params.
allow_multiple_answerNoРазрешить повторную отправку ответа (несколько прохождений).
disable_auto_redirectNoОтключить автоматический переход после ответа.
google_analytics_codeNoИдентификатор Google Analytics (макс. 100 символов).
question_random_orderNoПоказывать вопросы в случайном порядке.
repeat_interval_hoursNoПовторное заполнение через интервал: человек может пройти опрос снова только через N часов (1–8760) после своего прошлого завершённого ответа. Работает только при allow_multiple_answer: true; null — без интервала. Человек узнаётся по session_check_method (cookie и/или ip). Нельзя сочетать с sso_active, require_email_verification и способом проверки extra_params.
report_merge_versionsNoСклеивать версии вопросов в отчёте: ответы, собранные разными версиями опроса, показываются одним блоком.
yandex_analytics_codeNoНомер счётчика Яндекс.Метрики (макс. 100 символов).
allow_restart_progressNoРазрешить вернувшемуся респонденту начать прохождение заново вместо продолжения незавершённого. Работает только вместе с auto_save_progress.
question_min_view_modeNoМинимальное время просмотра вопроса перед переходом вперёд: individual, all_enabled или all_disabled.
question_required_modeNoРежим обязательности вопросов: individual, all_required или all_optional.
question_timer_secondsNoДлительность таймера вопроса в секундах (при question_timer_mode=all_enabled).
limit_answer_count_modeNoЧто считать за ответ в лимите: all (все записи, включая брошенные), completed (завершённые вместе с отсеянными), completed_no_screenout (завершённые без отсеянных). Дефолт новых опросов — completed.
scripts_in_body_enabledNoВключить выполнение скриптов в body.
scripts_in_head_enabledNoВключить выполнение скриптов в head.
google_analytics_versionNoВерсия Google Analytics (макс. 20 символов).
limit_answer_count_valueNoМаксимальное число ответов (0–1000000).
qr_code_background_colorNoЦвет фона QR-кода (макс. 50 символов).
block_jump_to_prev_widgetNoЗапретить переход к предыдущему вопросу (виджету).
question_lock_answer_modeNoЗапретить изменение ответа после ответа: individual, all_enabled или all_disabled.
question_min_view_secondsNoМинимальное время просмотра в секундах (при question_min_view_mode=all_enabled).
google_analytics_is_activeNoВключить отправку событий в Google Analytics.
limit_answer_count_enabledNoВключить ограничение максимального числа ответов (прохождений).
multilogic_sequential_modeNoПоследовательная мульти-логика: несколько групп условий одного вопроса применяются по порядку, а не только первая сработавшая.
question_timer_button_modeNoПоказывать вопрос по кнопке: individual, all_enabled или all_disabled.
require_email_verificationNoТребовать подтверждение e-mail перед отправкой ответа.
yandex_analytics_is_activeNoВключить отправку событий в Яндекс.Метрику.
closed_quiz_message_enabledNoВключить сообщение о закрытии опроса.
yandex_analytics_is_webvisorNoВключить Вебвизор в Яндекс.Метрике.
results_appearance_use_sharedNoСледовать общей палитре отчётов аккаунта (update_workspace_report_palette). true — опрос рисует отчёты палитрой аккаунта; свои цвета опроса остаются на месте и вернутся, если выключить.
anonymous_responses_show_labelNoПоказывать респонденту пометку о том, что опрос анонимный.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / detailed_journal
      Added value: +{
      +  "description": "Подробный журнал прохождения в протоколе ответа (get_answer_protocol): уход со вкладки, вставка текста, возвраты к вопросам. Только тариф Enterprise: включить на другом тарифе — ошибка.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / quiz_categories / description
      Previous value: -"Список категорий для категорийного скоринга: массив объектов { \"id\": \"<строка>\", \"name\": \"<название>\" }. Порядок значим: при равенстве баллов побеждает категория, идущая раньше. Веса категорий задаются у опций виджетов, а не здесь."New value: +"Список категорий для категорийного скоринга: массив объектов { \"id\": \"<строка>\", \"name\": \"<название>\" }. Порядок значим: при равенстве баллов побеждает категория, идущая раньше. Веса категорий задаются у опций виджетов, а не здесь. Категория — ещё и шкала: необязательные ranges [{id, from, to, text}] — диапазоны с текстом для экрана результата (границы целые и включаются, null — без границы, text — простой текст до 1000 знаков, до 50 диапазонов), normUnit (sten, stanine, t, percentile) и norms [{id, from, to, value}] — перевод сырого балла в значение нормы (до 100 строк). Список заменяется целиком: передавайте категории со всеми их полями."
    • addedInput schema / properties / quiz_categories / items
      Added value: +{
      +  "properties": {
      +    "id": {
      +      "type": "string"
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "normUnit": {
      +      "description": "sten | stanine | t | percentile",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "norms": {
      +      "items": {
      +        "properties": {
      +          "from": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "to": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "ranges": {
      +      "items": {
      +        "properties": {
      +          "from": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "text": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "to": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / info_title / description
      Previous value: -"Заголовок (мета, макс. 500 символов)."New value: +"Заголовок (мета, макс. 500 символов, без ссылок)."
  3. Changed1 schema field changed
    • addedInput schema / properties / name / maxLength
      Added value: +80
  4. Changed1 schema field changed
    • changedInput schema / properties / languages / description
      Previous value: -"Языки опроса: {items: [{code, enabled}]} — дополнительные языки кроме основного lang (код из списка, не больше 10, без повторов, не основной язык); enabled — показывать респондентам после публикации. Список целиком заменяет сохранённый; null — один язык. Тексты переводятся в поле translations каждого вопроса ({<код>: {<путь внутри вопроса>: {t: текст}}}) через update_quiz_widgets; кнопки и сообщения языка — update_quiz_texts с locale. Добавить или показать язык можно только с опцией тарифа publication.survey_languages."New value: +"Языки опроса: {items: [{code, enabled}]} — дополнительные языки кроме основного lang (код из списка, не больше 10, без повторов, не основной язык); enabled — показывать респондентам после публикации. Необязательный picker — как респондент выбирает язык: screen (экран выбора до опроса), buttons (кнопки языков над заголовком первого экрана), corner (переключатель в углу каждого экрана), none (без выбора: язык из ?lang= или браузера); без поля — как screen. Список целиком заменяет сохранённый; null — один язык. Тексты переводятся в поле translations каждого вопроса ({<код>: {<путь внутри вопроса>: {t: текст}}}) через update_quiz_widgets; кнопки и сообщения языка — update_quiz_texts с locale. Добавить или показать язык можно только с опцией тарифа publication.survey_languages."
  5. Changed1 schema field changed
    • addedInput schema / properties / languages
      Added value: +{
      +  "description": "Языки опроса: {items: [{code, enabled}]} — дополнительные языки кроме основного lang (код из списка, не больше 10, без повторов, не основной язык); enabled — показывать респондентам после публикации. Список целиком заменяет сохранённый; null — один язык. Тексты переводятся в поле translations каждого вопроса ({<код>: {<путь внутри вопроса>: {t: текст}}}) через update_quiz_widgets; кнопки и сообщения языка — update_quiz_texts с locale. Добавить или показать язык можно только с опцией тарифа publication.survey_languages.",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  6. Changed1 schema field changed
    • changedInput schema / properties / theme_id / description
      Previous value: -"ID темы оформления воркспейса (целое ≥ 1)."New value: +"ID темы: общей или из воркспейса опроса (целое ≥ 1)."
  7. Changed1 schema field changed
    • addedInput schema / properties / repeat_interval_hours
      Added value: +{
      +  "description": "Повторное заполнение через интервал: человек может пройти опрос снова только через N часов (1–8760) после своего прошлого завершённого ответа. Работает только при allow_multiple_answer: true; null — без интервала. Человек узнаётся по session_check_method (cookie и/или ip). Нельзя сочетать с sso_active, require_email_verification и способом проверки extra_params.",
      +  "maximum": 8760,
      +  "minimum": 1,
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
  8. First observed

TDQS

B3.3/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true, openWorldHint=true, and idempotentHint=false, so the safety profile is largely carried by structured data. The description adds the meaningful partial-update semantics (only supplied fields are written, others untouched), which is real behavioral value beyond the annotations. It does not warn about the destructive blast radius, tariff-gated fields, or cross-field constraints — those live only in the schema.

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

Conciseness3/5

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

The patch rule is front-loaded in the second sentence, which is the more valuable information. However, the parenthetical enumeration of a dozen-plus settings categories restates what the schema already lists exhaustively and inflates the sentence without adding discriminative value.

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 94-parameter destructive mutation with no output schema, the description covers the essential bulk-update contract but omits what an agent would want before calling: what happens on conflicting or interdependent fields, what response to expect, and which settings must be changed through sibling tools instead. Adequate, but thin against this complexity.

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

Parameters3/5

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

Schema description coverage is 100% across 94 parameters, so the schema does all the heavy lifting on individual field meaning and constraints. The description contributes only the merge/patch convention rather than any per-parameter syntax or format detail, which is the expected baseline when the schema is fully documented.

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 names a specific verb and resource ("Обновляет настройки опроса") and enumerates the families of settings covered, so an agent knows exactly what domain this mutates. It does not differentiate itself from near-siblings such as update_quiz_widgets, update_quiz_texts, or update_quiz_logic — that routing only appears inside the schema text, not the description.

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

Usage Guidelines3/5

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

The second sentence gives one genuinely useful usage rule: pass only the fields to change, everything else is left untouched. There is no explicit when-to-use / when-not-to-use guidance and no pointer to alternatives for settings that live in other tools (themes, texts, widgets), leaving that inference to the caller.

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