MCP Tools Reference: ces.googleapis.com

כלי: delete_toolset

מוחק את ערכת הכלים שצוינה.

בדוגמת הקוד הבאה מוצג שימוש בפקודה curl כדי להפעיל את הכלי delete_toolset 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_toolset",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

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

DeleteToolsetRequest

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

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