Đăng ký webhook tên miền

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

Annotations đã khai báo readOnlyHint=false, idempotentHint=true, openWorldHint=true, destructiveHint=false; mô tả bổ sung thông tin về HMAC, loại sự kiện và giới hạn 1 webhook/user. Không có mâu thuẫn với annotations.

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?

Hai mệnh đề ngắn, thông tin quan trọng được đưa lên trước, không có câu thừa. Độ dài phù hợp với một công cụ đăng ký webhook đơn giản.

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?

Với công cụ mutation 2 tham số, annotations khá đầy đủ, mô tả nêu được sự kiện, HMAC, hành vi một-webhook-mỗi-user và cập nhật khi gọi lại. Còn thiếu mô tả về phản hồi hoặc xác thực, nhưng không cản trở việc gọi đúng công cụ.

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?

Schema mô tả secret ở mức 50% (chuỗi bí mật xác minh HMAC); mô tả chỉ nhắc lại HMAC và URL nhận sự kiện, không thêm ràng buộc định dạng hay ý nghĩa mới cho url. Baseline 3 phù hợp khi schema đã làm phần lớn việc mô tả tham số.

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?

Nêu rõ động từ + tài nguyên: đăng ký URL nhận sự kiện domain.status_changed, có ký HMAC. Sự kiện domain giúp phân biệt với các webhook monapay/mail, dù không nêu tên công cụ thay thế.

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?

Cho biết mỗi user chỉ có 1 webhook và gọi lại để cập nhật, tức là hành vi upsert. Thiếu khi nào không nên dùng hoặc công cụ thay thế, nhưng ngữ cảnh sử dụng đã rõ.

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