MCP Tools Reference: ces.googleapis.com

כלי: delete_evaluation

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

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

סכימת הקלט

בקשת הודעה עבור EvaluationService.DeleteEvaluation.

DeleteEvaluationRequest

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

string

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

boolean

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

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

string

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

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