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: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.

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