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

النتائج فقط. تمثّل هذه السمة عنوان المستند.

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

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