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

  • ‫Genkit: ‏ genkit.dev

  • ‫Go: ‏ go.dev

  • تكنولوجيات الذكاء الاصطناعي من Google‏: 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

  • ‫Google Workspace: ‏ knowledge.workspace.google.com

  • ‫TensorFlow: ‏ www.tensorflow.org

  • الويب: web.dev

تعرض هذه الأداة أجزاء من النصوص والأسماء ومعرّفات الموارد المنتظمة (URI) للمستندات المطابقة. يُفضَّل استخدام search_documents متبوعًا بـ get_documents عندما تحتاج إلى عينات تعليمات برمجية دقيقة أو علامات واجهة سطر الأوامر (CLI) أو رسائل خطأ محدّدة أو جولات تفصيلية كاملة أو بحث حتمي عن الكلمات الرئيسية. إذا لم تكن الأجزاء المعروضة مفصّلة بما يكفي للإجابة عن سؤال المستخدم، استخدِم get_documents مع parent من نتائج هذه الأداة لاسترداد محتوى المستند بالكامل. عند الإجابة على المستخدم، يجب دائمًا ذكر أسماء مراجع المستندات المصدر الموثوقة (documents/...) أو معرّفات الموارد المنتظمة (URI).

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام curl لاستدعاء أداة MCP‏ search_documents.

طلب 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

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

SearchDocumentChunksRequest

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

string

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

مخطط النتائج

مخطط الاستجابة لـ search_documents

SearchDocumentChunksResponse

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

object (DocumentChunk)

نتائج البحث عن طلب البحث المحدّد يحتوي كل DocumentChunk في هذه القائمة على مقتطف من المحتوى ذي الصلة بطلب البحث. استخدِم حقل DocumentChunk.parent لكل نتيجة مع 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: ❌