MCP Tools Reference: developerknowledge.googleapis.com

الأداة: get_documents

استخدِم هذه الأداة لاسترداد المحتوى الكامل لمستند واحد أو ما يصل إلى 20 مستندًا في طلب واحد. يجب الحصول على أسماء المستندات إما من حقل parent للنتائج من طلب إلى أداة search_documents أو من حقل references الذي تعرضه أداة answer_query. اضبط المَعلمة names على قائمة بأسماء المستندات (documents/...)، واذكر مستندات المصادر الموثوقة المستخدَمة في ردّك النهائي.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام curl لاستدعاء أداة MCP‏ get_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": "get_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

مخطط الطلب لـ get_documents

GetDocumentsRequest

تمثيل JSON 
{
  "names": [
    string
  ]
}
الحقول
names[]

string

الحقل مطلوب. أسماء المستندات المطلوب استردادها، كما تم عرضها في حقل parent لنتائج search_documents أو حقل references في answer_query. يمكن استرداد 20 مستندًا كحد أقصى في طلب واحد. يتم عرض المستندات بالترتيب نفسه الذي تظهر به names في الطلب. التنسيق: documents/{uri_without_scheme} مثال: documents/docs.cloud.google.com/storage/docs/creating-buckets

مخطط النتائج

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

GetDocumentsResponse

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

object (Document)

تم طلب المستندات.

مستند

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

string

المعرّف. اسم المورد للمستند التنسيق: documents/{uri_without_scheme} مثال: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

للعرض فقط. معرّف الموارد المنتظم (URI) للمحتوى، مثل https://cloud.google.com/storage/docs/creating-buckets
content

string

للعرض فقط. محتوى المستند بتنسيق Markdown
description

string

للعرض فقط. وصف للمستند
title

string

للعرض فقط. عنوان المستند

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

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

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

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

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