Skip to main content
Glama

Сборка опроса по описанию

generate_ai_quiz

Собирает опрос по текстовому описанию. Сборка идёт в фоне: вызов возвращает ID будущего опроса и ставит работу в очередь, а сам опрос сначала пустой. Готовность спрашивают этим же инструментом, передав quiz_id — придёт pending или ready. Так же это устроено в кабинете; синхронной сборки нет, потому что обращения к модели занимают до минуты и обрывались по таймауту.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "generate_ai_quiz"
  }
}

Input Schema

NameRequiredDescriptionDefault
promptNoПользовательское описание того, какой опрос нужно создать.
ai_typeNoЧто собирать: quiz — обычный опрос, у вопросов нет правильных ответов; test — тест, где у вариантов проставлены баллы и отмечены правильные ответы, а респондент в конце получает результат. По умолчанию quiz.
projectNoМетка проекта для своего учёта: произвольная строка, которая просто сохраняется у опроса. На поведение не влияет, респондент её не видит. Не просите её у человека сами.
quiz_idNoID опроса из предыдущего вызова. Передайте его, чтобы узнать, готова ли сборка. Вместе с ним folder_id и prompt не нужны.
folder_idNoID папки, в которой нужно создать AI-опрос. Взять из folder://list.
with_logicNoПросить ли AI сразу построить логику переходов между вопросами (ветвление по ответам). Без неё вопросы идут подряд.
source_textNoНеобязательный исходный материал, по которому строить вопросы, например текст статьи. Передавать, только если человек дал такой материал. Принимается до 100 000 символов, в работу идут первые 20 000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / source_text
      Added value: +{
      +  "description": "Необязательный исходный материал, по которому строить вопросы, например текст статьи. Передавать, только если человек дал такой материал. Принимается до 100 000 символов, в работу идут первые 20 000.",
      +  "type": "string"
      +}
  2. First observed

TDQS

A4.1/5.0
Behavior5/5

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

Adds substantial behavior beyond the thin annotations (only readOnly=false, idempotent=false, destructive=false): the call is asynchronous, it enqueues work, it returns an ID for a not-yet-populated quiz, and polling yields pending or ready. The rationale for the async design is disclosed, which tells the agent not to expect results in the first response.

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?

Four sentences, front-loaded with the core behavior and the async constraint, with no wasted filler. The comparative aside about the web UI ('Так же это устроено в кабинете') is mildly extraneous but supports the timeout rationale, so it mostly earns its place.

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?

With seven parameters and no output schema, the description carries the return-value burden and does so by naming the ID return and the pending/ready statuses. It does not clarify which fields are needed for the creation call versus the polling call (required list is empty), though the schema description covers that gap.

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%, so every parameter is already documented, including the quiz_id readiness semantics and the mutual exclusivity with prompt/folder_id. The description restates the quiz_id polling role but adds no new syntax, limits, or defaults beyond the schema, so the baseline of 3 applies.

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?

States a specific verb and resource in the first sentence ('Собирает опрос по текстовому описанию') and goes on to clarify that the same tool also serves as a readiness poll. The dual create/poll role is explicit, but no sibling is named, so an agent cannot tell from the description alone how this differs from create_quiz or create_quiz_from_template.

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 clear when-to-use context for both modes: call with a description to enqueue a build, call again with quiz_id to check readiness. It also explains why no synchronous variant exists (model calls can take up to a minute and time out), which pre-empts an agent looking for a blocking version. There are no explicit exclusions relative to siblings, though.

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