MCP Tools Reference: developerknowledge.googleapis.com

ابزار: search_documents

از این ابزار برای یافتن مستندات مربوط به محصولات توسعه‌دهندگان گوگل استفاده کنید. این اسناد شامل APIهای رسمی، قطعه کدهای کوتاه، یادداشت‌های انتشار، بهترین شیوه‌ها، راهنماها، اطلاعات اشکال‌زدایی و موارد دیگر است. این اسناد محصولات و حوزه‌های زیر را پوشش می‌دهد:

  • ADK: adk.dev

  • اندروید: developer.android.com

  • آپیجی: docs.apigee.com

  • کروم: developer.chrome.com

  • دارت: dart.dev

  • فایربیس: firebase.google.com

  • فلاتر: docs.flutter.dev

  • فوشیا: fuchsia.dev

  • رابط خط فرمان جمینی: geminicli.com

  • برو: go.dev

  • هوش مصنوعی گوگل: ai.google.dev

  • گوگل ضد جاذبه: antigravity.google

  • گوگل کلود: cloud.google.com و docs.cloud.google.com

  • توسعه‌دهندگان گوگل، تبلیغات، جستجو، نقشه‌های گوگل، یوتیوب: developers.google.com

  • گوگل هوم: developers.home.google.com

  • پلتفرم نقشه گوگل: mapsplatform.google.com

  • تنسورفلو: www.tensorflow.org

  • وب: web.dev

این ابزار تکه‌هایی از متن، نام‌ها و URLها را برای اسناد منطبق برمی‌گرداند. اگر تکه‌های برگردانده شده به اندازه کافی دقیق نیستند تا به سوال کاربر پاسخ دهند، از get_documents به همراه parent خروجی این ابزار برای بازیابی محتوای کامل سند استفاده کنید.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار search_documents 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": "search_documents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

درخواست طرحواره برای search_documents. از فیلد پرس و جو برای جستجوی اسناد توسعه‌دهنده گوگل مرتبط استفاده کنید.

درخواست جستجو

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

string

الزامی. رشته پرس‌وجوی خام ارائه شده توسط کاربر، مانند «چگونه یک مخزن ذخیره‌سازی ابری ایجاد کنیم؟».

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

طرحواره پاسخ برای search_documents.

جستجوقطعات سندپاسخ

نمایش JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
فیلدها
results[]

object ( DocumentChunk )

نتایج جستجو برای عبارت جستجو شده. هر سند در این لیست شامل یک قطعه از محتوای مرتبط با عبارت جستجو شده است. برای بازیابی محتوای کامل سند، از فیلد DocumentChunk.name هر نتیجه به همراه get_documents استفاده کنید.

سندچانک

نمایش JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
فیلدها
parent

string

فقط خروجی. نام منبع سندی که این قطعه از آن است. قالب: documents/{uri_without_scheme} مثال: documents/docs.cloud.google.com/storage/docs/creating-buckets

id

string

فقط خروجی. شناسه این قطعه در داخل سند. شناسه قطعه در داخل یک سند منحصر به فرد است، اما به صورت جهانی در بین اسناد منحصر به فرد نیست. شناسه قطعه پایدار نیست و ممکن است با گذشت زمان تغییر کند.

content

string

فقط خروجی. محتوای بخش سند.

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

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

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

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

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