MCP Tools Reference: developerknowledge.googleapis.com

ابزار: answer_query

از answer_query برای دریافت پاسخ مفهومی ترکیبی و مستدل به پرسش‌های سطح بالا درباره محصولات توسعه‌دهنده Google استفاده کنید. برای نمونه‌های دقیق کد، پرچم‌های CLI، پیام‌های خطای خاص، یا راهنماهای کامل سند، بهتر است به‌جای آن از search_documents و سپس get_documents استفاده کنید. این ابزار سهمیه محدودی دارد. این ابزار اطلاعات را از مجموعه نوشتار ترکیب می‌کند تا پاسخی برای پُرسمان تولید کند. answer_query پاسخ‌ها را بااستفاده از همان مجموعه نوشتار search_documents زمینه‌سازی می‌کند. این ابزار answer_text تولیدشده و فهرستی از نام‌های سند (مرجع) را که برای تولید پاسخ استفاده شده است برمی‌گرداند. همیشه نام اسناد منبع معتبر را از references (documents/...) در پاسخ نهایی خود به کاربر ذکر کنید. درصورت نیاز، از get_documents با نام‌های سند از references برای واکشی کل محتوای سند استفاده کنید.

اگر خطای ۴۲۹ «خارج از سهمیه» دریافت کردید، به‌جای آن از search_documents استفاده کنید.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار MCP answer_query را نشان می‌دهد.

درخواست Curl 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرح‌واره ورودی

پیام درخواست برای AnswerQuery.

AnswerQueryRequest

نمایش JSON 
{
  "query": string
}
فیلدها
query

string

الزامی. پرسمانی که باید پاسخ داده شود.

طرح‌واره برونداد

پیام پاسخ برای AnswerQuery.

AnswerQueryResponse

نمایش JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
فیلدها
answerText

string

پاسخ به پُرسمان.
references[]

string

فقط خروجی. نام‌های منبع اسناد استفاده‌شده برای تولید پاسخ (مثلاً documents/docs.cloud.google.com/storage/docs/creating-buckets). این نام‌های منبع را در پاسخ نهایی ذکر کنید و اگر محتوای کامل سند لازم است، آن‌ها را به get_documents ارسال کنید.

حاشیه‌نویسی‌های ابزار

حاشیه‌نویسی‌های ابزار به کارخواهان MCP ارسال می‌شود تا خطر اصلی ابزار موردنظر را شرح دهد. اکثر کارخواه‌ها این راهنمایی‌ها را غیرقابل‌اعتماد تلقی می‌کنند، اما می‌توان از آن‌ها برای تصمیم‌گیری درباره زمان ارسال پیام‌واره تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به‌صورت زیر تعریف می‌شوند:

  • ‫readOnlyHint: اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: false.
  • ‫destructiveHint: اگر درست باشد، ابزار می‌تواند کنش‌های مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند کنش‌های افزایشی انجام دهد. پیش‌فرض: true.
  • idempotentHint: اگر درست باشد، فراخوانی مکرر ابزار با همان متغیرهای مستقل تأثیر بیشتری بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • ‫openWorldHint: اگر درست باشد، ابزار می‌تواند با «دنیای باز» نهادهای خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با نهادهای داخلی تعامل داشته باشد. برای مثال، ابزار جستجوی وب از نوع دنیای باز است، درحالی‌که ابزار حافظه از نوع دنیای باز نیست.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌