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

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