MCP Tools Reference: developerknowledge.googleapis.com

الأداة: search_documents

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

  • ‫ADK: ‏adk.dev

  • ‫Android: ‏developer.android.com

  • ‫Apigee: ‏docs.apigee.com

  • ‫Chrome: ‏developer.chrome.com

  • ‫Firebase: ‏firebase.google.com

  • ‫Fuchsia: ‏fuchsia.dev

  • ‫Go: ‏go.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

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

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

تلميح مدمِّر: ❌ | تلميح متكرّر: ✅ | تلميح للقراءة فقط: ✅ | تلميح للعالم المفتوح: ❌