MCP Tools Reference: developerknowledge.googleapis.com

أداة: get_documents

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

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

مخطط الإدخال

مخطط الطلب لأداة get_documents

GetDocumentsRequest

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

string

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

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