MCP Tools Reference: developerknowledge.googleapis.com

כלי: get_documents

אתם יכולים להשתמש בכלי הזה כדי לאחזר את התוכן המלא של מסמך אחד או עד 20 מסמכים בשיחה אחת. שמות המסמכים צריכים להתקבל מהשדה parent בתוצאות של קריאה לכלי search_documents. מגדירים את הפרמטר names לרשימה של שמות מסמכים.

Aware.curlget_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 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, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌