MCP Tools Reference: developerknowledge.googleapis.com

الأداة: search_documents

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

  • ADK: adk.dev

  • ‫Android: developer.android.com

  • Apigee: ‏ docs.apigee.com

  • Chrome: developer.chrome.com

  • ‫Dart: dart.dev

  • ‫Firebase: firebase.google.com

  • ‫Flutter: docs.flutter.dev

  • ‫Fuchsia: fuchsia.dev

  • ‫Gemini CLI: geminicli.com

  • Go: go.dev

  • Google AI: ai.google.dev

  • ‫Google Antigravity: antigravity.google

  • ‫Google Cloud: ‏ cloud.google.com وdocs.cloud.google.com

  • Google Developers و"إعلانات Google" و"بحث Google" و"خرائط Google" وYouTube: developers.google.com

  • ‫Google Home: developers.home.google.com

  • منصة خرائط Google: ‏ mapsplatform.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

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

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

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

بالإضافة إلى سلسلة العنوان، يتم تحديد تلميحات القيم المنطقية التالية على النحو التالي:

  • ‫readOnlyHint: إذا كانت القيمة صحيحة، لن تعدّل الأداة بيئتها. القيمة التلقائية: false.
  • ‫destructiveHint: إذا كانت القيمة صحيحة، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة خطأ، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • idempotentHint: إذا كانت القيمة صحيحة، لن يكون لاستدعاء الأداة بشكل متكرر باستخدام الوسيطات نفسها أي تأثير إضافي على بيئتها. القيمة التلقائية: false.
  • openWorldHint: إذا كانت القيمة صحيحة، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة خطأ، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

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