MCP Tools Reference: developerknowledge.googleapis.com

כלי: answer_query

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

אם מופיעה שגיאת 429 (חריגה מהמכסה), צריך להשתמש ב-search_documents במקום זאת.

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP‏ answer_query.

בקשת 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": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

הודעת בקשה עבור AnswerQuery.

AnswerQueryRequest

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

string

חובה. השאילתה שצריך לענות עליה.

סכימת הפלט

הודעת התשובה של AnswerQuery.

AnswerQueryResponse

ייצוג ב-JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
שדות
answerText

string

התשובה לשאילתה.
references[]

string

פלט בלבד. שמות המשאבים של המסמכים ששימשו ליצירת התשובה (למשל, documents/docs.cloud.google.com/storage/docs/creating-buckets). צריך לצטט את שמות המשאבים האלה בתשובה הסופית ולהעביר אותם אל get_documents אם נדרש תוכן מלא של המסמך.

הערות לגבי הכלים

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

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

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

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