MCP Tools Reference: developerknowledge.googleapis.com

الأداة: search_documents

استخدِم هذه الأداة للعثور على مستندات حول منتجات المطوّرين من Google. تحتوي المستندات على واجهات برمجة تطبيقات رسمية ومقتطفات من الرموز البرمجية وملاحظات الإصدار وأفضل الممارسات والأدلّة ومعلومات تصحيح الأخطاء وغير ذلك. ويشمل المنتجات والنطاقات التالية:

  • ‫Android: developer.android.com
  • Apigee: ‏ docs.apigee.com
  • Chrome: developer.chrome.com
  • ‫Firebase: firebase.google.com
  • Fuchsia: fuchsia.dev
  • Google AI: ai.google.dev
  • ‫Google Cloud: docs.cloud.google.com
  • Google Developers و"إعلانات Google" و"بحث Google" و"خرائط Google" وYouTube: developers.google.com
  • ‫Google Home: developers.home.google.com
  • ‫TensorFlow: www.tensorflow.org
  • الويب: web.dev

تعرض هذه الأداة أجزاء من النصوص والأسماء وعناوين URL للمستندات المطابقة. إذا لم تكن الأجزاء المعروضة مفصّلة بما يكفي للإجابة عن سؤال المستخدم، استخدِم get_documents مع parent من ناتج هذه الأداة لاسترداد محتوى المستند الكامل.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة search_documents MCP.

طلب 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": "search_documents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

مخطط الطلب الخاص بـ search_documents استخدِم حقل طلب البحث للبحث عن مستندات مطوّري Google ذات الصلة.

SearchDocumentChunksRequest

تمثيل JSON 
{
  "query": string
}
الحقول
query

string

الحقل مطلوب. تمثّل هذه السمة سلسلة طلب البحث الأولي التي يقدّمها المستخدم، مثل "كيفية إنشاء حزمة Cloud Storage".

مخطط النتائج

مخطط الردّ الخاص بالدالة search_documents

SearchDocumentChunksResponse

تمثيل JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
الحقول
results[]

object (DocumentChunk)

نتائج البحث عن طلب البحث المحدّد يحتوي كل مستند في هذه القائمة على مقتطف من المحتوى ذي الصلة بطلب البحث. استخدِم الحقل DocumentChunk.name لكل نتيجة مع get_documents لاسترداد محتوى المستند الكامل.

DocumentChunk

تمثيل 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

النتائج فقط. محتوى جزء المستند

التعليقات التوضيحية للأدوات

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