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

  • ‫Genkit: ‏ genkit.dev

  • ‫Go: ‏ go.dev

  • ‫Google AI: ‏ ai.google.dev

  • ‫Google Antigravity: ‏ antigravity.google

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

  • ‫Google Developers, ‏ Ads, חיפוש, מפות Google, ‏ YouTube: ‏ developers.google.com

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

  • Google Maps Platform‏: mapsplatform.google.com

  • ‫Google Workspace: ‏ knowledge.workspace.google.com

  • ‫TensorFlow: ‏ www.tensorflow.org

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

הכלי הזה מחזיר קטעי טקסט, שמות וכתובות URI של מסמכים תואמים. עדיף להשתמש ב-search_documents ואז ב-get_documents כשצריך דוגמאות קוד מדויקות, דגלי CLI, הודעות שגיאה ספציפיות, מדריכים מפורטים או חיפוש מילות מפתח דטרמיניסטי. אם קטעי הטקסט שמוחזרים לא מפורטים מספיק כדי לענות על השאלה של המשתמש, צריך להשתמש ב-get_documents עם ה-parent מהפלט של הכלי הזה כדי לאחזר את תוכן המסמך המלא. כשעונים למשתמש, תמיד צריך לצטט את שמות המשאבים (documents/...) או את ה-URI של מסמכי המקור המהימנים.

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP‏ search_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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

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

SearchDocumentChunksRequest

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

string

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

סכימת הפלט

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

SearchDocumentChunksResponse

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

object (DocumentChunk)

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

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