MCP Tools Reference: developerknowledge.googleapis.com

ابزار: answer_query

از answer_query برای دریافت پاسخی مستدل به یک پرسش در مورد محصولات توسعه‌دهندگان گوگل استفاده کنید. این ابزار سهمیه محدودی دارد. این ابزار اطلاعات را از مجموعه داده‌ها ترکیب می‌کند تا پاسخی برای پرسش ایجاد کند. answer_query پاسخ‌ها را با استفاده از همان مجموعه داده‌های search_documents زمینه‌سازی می‌کند. این ابزار answer_text تولید شده و لیستی از نام‌های سند (مرجع‌ها) مورد استفاده برای تولید پاسخ را برمی‌گرداند. در صورت نیاز، از get_documents به همراه نام‌های سند برای دریافت کل محتوای سند استفاده کنید.

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

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

درخواست کرل 
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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

درخواست پاسخ

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

string

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

طرحواره خروجی

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

پاسخپرسش و پاسخ

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

string

پاسخ به پرسش.

references[]

string

فقط خروجی. نام منابع اسنادی که برای تولید پاسخ استفاده شده‌اند.

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

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

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

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

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌