Skip to main content
Glama

Уникальные ссылки на опрос

manage_quiz_unique_links
Destructive

Ведёт наборы уникальных ссылок на опрос — отдельных адресов вида https://<домен опроса>/s/<код> для отдела, филиала, класса или партнёра. У каждой ссылки лимит ответов (свой или набора), у набора — срок, недельное расписание, правило пароля и свои тексты отказа. Ответ помнит ссылку, по ней фильтруются ответы и отчёт (unique_link_group_id / unique_link_ids в get_quiz_answers и generate_filtered_report). Основной адрес опроса работает как раньше. Чтение — по праву view_results, изменения — по праву settings. Ошибка проверки приходит машинным кодом поля, например «max_uses: max_uses_range».

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

Input Schema

NameRequiredDescriptionDefault
idsNoID ссылок для bulk_links. Без ids действие применяется ко всему, что отбирают search и show, на всех страницах. Для delete нужны ids, search или show, отличный от all.
nameNoНазвание набора для create_group, до 120 символов.
pageNoСтраница для list_links, с 1.
showNoОтбор для list_links и для bulk_links без ids: all — все, no_answers — без ответов, answered — с ответами, limit_reached — набран лимит, unavailable — не пускают.
countNoСколько ссылок выпустить: для create_group и add_links, 1..1000. Не учитывается, если переданы labels.
actionYesЧто сделать: list_groups — наборы, get_group — один набор, create_group — создать набор со ссылками, update_group — изменить набор, delete_group — удалить набор со ссылками, list_links — ссылки набора по странице, add_links — добавить ссылки, update_link — изменить ссылку, bulk_links — включить, выключить или удалить несколько ссылок, export_links — файл со ссылками набора (CSV или Excel) по ссылке на скачивание.
formatNoФормат файла для export_links: xlsx (по умолчанию) или csv. Ссылка на скачивание действует час.
labelsNoНазвания ссылок для create_group и add_links: по ссылке на каждое непустое имя, в этом порядке, до 1000, каждое до 64 символов.
searchNoПодстрока кода или своего названия ссылки — для list_links и для bulk_links без ids.
changesNoИзменяемые поля. Для update_group: name, active, max_uses, starts_at, expires_at (моменты ISO), period_timezone, schedule_enabled, schedule_days (ISO 1..7), schedule_time_from, schedule_time_to (HH:mm), schedule_timezone, password_mode (survey — пароли опроса, own — пароль набора, none — без пароля), password (только запись), message_used, message_invalid (HTML, до 1000 символов текста). Для update_link: label, active, own_max_uses вместе с max_uses (свой лимит только сужает лимит набора), own_password, password_add, password_edit {id, value}, password_delete (id пароля), params — скрытые переменные ссылки [{name, value}], до 20.
dry_runNoДля update_group: только посчитать, сколько ссылок перестанут пускать при новом max_uses (becomes_used), ничего не сохраняя.
link_idNoID ссылки. Нужен для update_link.
quiz_idYesID опроса.
group_idNoID набора. Нужен для get_group, update_group, delete_group, list_links, add_links, bulk_links и export_links.
max_usesNoЛимит ответов на ссылку для create_group: 1 — одноразовые (по умолчанию), N, или null — без лимита.
per_pageNoСсылок на странице для list_links, до 500, по умолчанию 50.
bulk_actionNoДля bulk_links: enable — включить, disable — выключить, delete — удалить.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already flag destructiveHint=true and openWorldHint=true, but the description adds the permission model (view_results vs settings), the fact that the base survey URL is unaffected by these link groups, and the machine-readable error contract ('max_uses: max_uses_range'). Missing details on side effects of bulk operations across pages are left to the schema, but the added auth and error context is genuinely beyond the annotations.

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?

Front-loaded with the core definition, then layered: link semantics, reporting integration, permissions, error format. Every sentence carries information, though the density and the parenthetical URL template make it slower to parse than a tighter version would be.

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

Completeness4/5

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

For a 17-parameter, multi-action tool with nested objects and no output schema, the description covers the domain model, permissions, downstream consumption and error shape. Return values are largely left to the schema (which documents the export download link and its one-hour validity), so the remaining gap is minor.

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% and the action enum, changes object, show filters and dry_run are all fully documented in the schema itself. The description adds conceptual framing (link vs group limits, that responses remember their link) but no syntax or constraint detail beyond what the schema already states, so the baseline 3 applies.

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

Purpose5/5

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

States a specific verb+resource ('Ведёт наборы уникальных ссылок на опрос') and defines what the resource actually is — per-target URLs of the form /s/<код> with per-link and per-group limits, schedules, password rules and refusal texts. It also separates the concept from the ordinary survey address ('Основной адрес опроса работает как раньше'), so an agent can tell it apart from get_share_links and the plain survey link.

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?

Gives concrete routing signals: reads need view_results, mutations need settings, and answers/reports are filtered via unique_link_group_id / unique_link_ids in get_quiz_answers and generate_filtered_report. That tells the agent both when to call this and where the resulting link IDs are consumed downstream. It stops short of explicit when-not guidance against other sibling link/password tools, so not a 5.

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