MCP Tools Reference: paydeveloper.googleapis.com

כלי: search_documentation

מחפש ומאחזר את הקטעים הרלוונטיים והעדכניים ביותר מתוך התיעוד הרשמי למפתחים של Google Pay ו-Google Wallet ודוגמאות קוד.

בדוגמת הקוד הבאה מוצג שימוש בפקודה curl כדי להפעיל את הכלי search_documentation MCP.

בקשת Curl 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_documentation",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

בקשת הודעה לחיפוש תיעוד.

SearchDocumentationRequest

ייצוג JSON 
{
  "userQuery": string,
  "languageCode": string
}
שדות
userQuery

string

חובה. השאילתה לחיפוש.
languageCode

string

אופציונלי. קוד השפה של שאילתת החיפוש בתקן IETF BCP-47.

סכימת הפלט

הודעת תגובה לחיפוש מסמכים.

SearchDocumentationResponse

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

object (DocumentChunk)

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

DocumentChunk

ייצוג JSON 
{
  "title": string,
  "uri": string,
  "content": string
}
שדות
title

string

מציין את כותרת המסמך שאליו שייך ה-chunk.
uri

string

מציינים את ה-URI של המסמך שאליו שייך החלק.
content

string

מכיל את התוכן של החלק.

הערות על כלים

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

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

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

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