MCP Tools Reference: developerknowledge.googleapis.com

כלי: answer_query

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

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

Aware.curlanswer_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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

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

AnswerQueryRequest

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

string

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

סכימת הפלט

הודעת תגובה ל-AnswerQuery.

AnswerQueryResponse

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

string

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

string

פלט בלבד. שמות המקורות של המסמכים ששימשו ליצירת התשובה.

הערות על כלים

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

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

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

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