MCP Tools Reference: ces.googleapis.com

כלי: delete_tool

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

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

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

סכימת הקלט

בקשת הודעה עבור AgentService.DeleteTool.

DeleteToolRequest

ייצוג JSON 
{
  "name": string,
  "force": boolean,
  "etag": string
}
שדות
name

string

חובה. שם המשאב של הכלי שרוצים למחוק.
force

boolean

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

  • אם force = false, המחיקה תיכשל אם סוכנים כלשהם עדיין מפנים לכלי.
  • אם force = true, כל ההפניות הקיימות מסוכנים יוסרו והכלי יימחק.
etag

string

זה שינוי אופציונלי. ה-etag הנוכחי של הכלי. אם לא מציינים etag, המחיקה תחליף את כל השינויים שמתבצעים בו-זמנית. אם מצוין etag והוא לא תואם ל-etag הנוכחי של הכלי, המחיקה תיחסם ותוחזר שגיאת ABORTED.

סכימת הפלט

הודעה ריקה כללית שאפשר להשתמש בה שוב כדי להימנע מהגדרה של הודעות ריקות כפולות בממשקי ה-API. דוגמה אופיינית היא שימוש בו כסוג הבקשה או התגובה של שיטת API. לדוגמה:

service Foo {
  rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
}

הערות על כלים

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

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

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

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