MCP Tools Reference: developerknowledge.googleapis.com

כלי: search_documents

אפשר להשתמש בכלי הזה כדי למצוא מאמרי עזרה על מוצרים של Google למפתחים. במסמכים מפורטים ממשקי API רשמיים, קטעי קוד, נתוני גרסה, שיטות מומלצות, מדריכים, פרטי ניפוי באגים ועוד. המאמר מתייחס למוצרים ולדומיינים הבאים:

  • ADK: adk.dev

  • ‫Android: developer.android.com

  • ‫Apigee: docs.apigee.com

  • ‫Chrome: developer.chrome.com

  • ‫Dart: ‏ dart.dev

  • ‫Firebase: firebase.google.com

  • ‫Flutter: docs.flutter.dev

  • ‫Fuchsia: ‏ fuchsia.dev

  • ‫Gemini CLI: ‏ geminicli.com

  • ‫Go: ‏ go.dev

  • ‫Google AI: ai.google.dev

  • ‫Google Antigravity: ‏ antigravity.google

  • ‫Google Cloud: ‏ cloud.google.com ו-docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, Youtube: developers.google.com

  • ‫Google Home: developers.home.google.com

  • Google Maps Platform: ‏ mapsplatform.google.com

  • ‫TensorFlow: www.tensorflow.org

  • אינטרנט: web.dev

הכלי הזה מחזיר נתחים של טקסט, שמות וכתובות URL של מסמכים תואמים. אם המקטעים שמוחזרים לא מספקים מספיק פרטים כדי לענות על השאלה של המשתמש, משתמשים ב-get_documents עם parent מהפלט של הכלי הזה כדי לאחזר את התוכן המלא של המסמך.

Aware.curlsearch_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": "search_documents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

סכמת הבקשה של search_documents. משתמשים בשדה השאילתה כדי לחפש מסמכים קשורים למפתחים של Google.

SearchDocumentChunksRequest

ייצוג ב-JSON 
{
  "query": string
}
שדות
query

string

חובה. מחרוזת השאילתה הגולמית שסופקה על ידי המשתמש, כמו "איך יוצרים קטגוריה של Cloud Storage?".

סכימת הפלט

סכמת התשובה של search_documents.

SearchDocumentChunksResponse

ייצוג ב-JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
שדות
results[]

object (DocumentChunk)

תוצאות החיפוש של השאילתה שצוינה. כל מסמך ברשימה הזו מכיל קטע תוכן שרלוונטי לשאילתת החיפוש. כדי לאחזר את התוכן המלא של המסמך, משתמשים בשדה DocumentChunk.name של כל תוצאה עם get_documents.

DocumentChunk

ייצוג ב-JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
שדות
parent

string

פלט בלבד. שם המשאב של המסמך שממנו נלקח החלק הזה. פורמט: documents/{uri_without_scheme} דוגמה: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

פלט בלבד. המזהה של החלק הזה במסמך. מזהה החלק ייחודי במסמך, אבל לא ייחודי באופן גלובלי בין מסמכים. מזהה החלק לא יציב ועשוי להשתנות עם הזמן.
content

string

פלט בלבד. התוכן של חלק המסמך.

הערות על כלים

הערות על כלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כאל רמזים לא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש הנחיה לאישור.

בנוסף למחרוזת הכותרת, מוגדרים הרמזים הבוליאניים הבאים:

  • ‫readOnlyHint: אם הערך הוא true, הכלי לא משנה את הסביבה שלו. ברירת מחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא false, הכלי יכול לבצע רק פעולות של הוספה. ברירת מחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת מחדל: false.
  • ‫openWorldHint: אם הערך הוא true, הכלי יכול ליצור אינטראקציה עם 'עולם פתוח' של ישויות חיצוניות. אם הערך הוא false, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

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