⚠️ Включить webhook

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

Аннотации уже указывают, что инструмент не read-only (изменяет состояние), не деструктивен и не идемпотентен. Описание дополняет требованием к URL, что важно для понимания поведения. Однако не раскрывает, что происходит при повторных вызовах (хотя это покрыто параметром idempotencyKey в схеме).

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

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

Описание состоит из двух коротких предложений, которые сразу передают суть и ключевое требование. Нет лишней информации, каждое слово на месте.

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

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

Описание охватывает основное действие и критическое требование, но не сообщает о возвращаемом значении (отсутствует output schema). Для простого инструмента это может быть приемлемо, но агент не знает, как обработать результат. Также не указаны возможные ошибки или побочные эффекты.

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

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

Покрытие схемы параметров 100%: все три параметра имеют описания в схеме. Описание инструмента не добавляет дополнительной информации о параметрах, поэтому базовая оценка 3.

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

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

Описание чётко указывает действие (включение webhook-уведомлений) и ресурс (уведомления о новых сообщениях). Название и заголовок также ясно указывают на включение. Отличие от sibling-инструмента messenger_post_webhook_unsubscribe прослеживается, хотя явно не указано.

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

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

Описание даёт ключевое условие использования: URL должен быть публичным HTTPS и доступным из интернета, не локальным. Это помогает агенту избежать неверного вызова. Отсутствует явное указание, когда не следует использовать, но альтернатива (отписка) подразумевается наличием sibling.

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