MCP Tools Reference: paydeveloper.googleapis.com

الأداة: search_documentation

تبحث هذه الأداة عن أحدث الأقسام وأكثرها صلةً من مستندات المطوّرين الرسمية ونماذج الرموز البرمجية في Google Pay و"محفظة Google" وتستردّها.

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

طلب Curl 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_documentation",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة الطلب للبحث في المستندات

SearchDocumentationRequest

تمثيل JSON 
{
  "userQuery": string,
  "languageCode": string
}
الحقول
userQuery

string

الحقل مطلوب. طلب البحث الذي تريد البحث عنه
languageCode

string

اختياريّ. رمز اللغة IETF BCP-47 لطلب البحث

مخطط النتائج

رسالة الرد للبحث في المستندات

SearchDocumentationResponse

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

object (DocumentChunk)

أجزاء المستندات المطابقة لطلب البحث، والتي تم ترتيبها باستخدام درجة ملاءمة تقيِّم مدى التشابه بين طلب بحث المستخدم ومحتوى الجزء

DocumentChunk

تمثيل JSON 
{
  "title": string,
  "uri": string,
  "content": string
}
الحقول
title

string

يحدّد عنوان المستند الذي ينتمي إليه الجزء
uri

string

يحدّد عنوان URI للمستند الذي ينتمي إليه الجزء
content

string

يحتوي على محتوى الجزء

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

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

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

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

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