MCP Tools Reference: ces.googleapis.com

כלי: list_changelogs

רשימת יומני השינויים באפליקציה הנתונה.

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

סכימת הקלט

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

ListChangelogsRequest

ייצוג ב-JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
שדות
parent

string

חובה. שם המשאב של האפליקציה שממנה רוצים להציג את יומני השינויים.
pageSize

integer

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

string

זה שינוי אופציונלי. הערך next_page_token שמוחזר מקריאה קודמת של AgentService.ListChangelogs.
filter

string

זה שינוי אופציונלי. המסנן שיוחל כשמציגים את יומני השינויים. פרטים נוספים זמינים בכתובת https://google.aip.dev/160.

אפשר להשתמש במחרוזת הסינון כדי לסנן לפי action, resource_type, resource_name, author וגם create_time. אפשר להשתמש באופרטור ההשוואה : להתאמה חלקית לא תלוית-רישיות בשדות מחרוזת, ואילו האופרטור = מבצע התאמה מדויקת תלוית-רישיות.

דוגמאות: * action:update (התאמה חלקית לא תלוית-רישיות) * action="Create" (התאמה מדויקת תלוית-רישיות) * resource_type:agent * resource_name:my-agent * author:me@example.com * create_time > "2025-01-01T00:00:00Z" * create_time <= "2025-01-01T00:00:00Z" AND resource_type:tool
orderBy

string

זה שינוי אופציונלי. השדה שלפיו יתבצע המיון. יש תמיכה רק בערכים name ו-create_time. פרטים נוספים זמינים בכתובת https://google.aip.dev/132#ordering.

סכימת הפלט

הודעת תגובה ל-AgentService.ListChangelogs.

ListChangelogsResponse

ייצוג ב-JSON 
{
  "changelogs": [
    {
      object (Changelog)
    }
  ],
  "nextPageToken": string
}
שדות
changelogs[]

object (Changelog)

רשימת יומני השינויים.
nextPageToken

string

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

יומן שינויים

ייצוג ב-JSON 
{
  "name": string,
  "author": string,
  "displayName": string,
  "description": string,
  "resource": string,
  "resourceType": string,
  "action": string,
  "originalResource": {
    object
  },
  "newResource": {
    object
  },
  "dependentResources": [
    {
      object
    }
  ],
  "createTime": string,
  "sequenceNumber": string
}
שדות
name

string

מזהה. המזהה הייחודי של יומן השינויים. פורמט: projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author

string

פלט בלבד. כתובת האימייל של כותב השינוי.
displayName

string

פלט בלבד. השם המוצג של השינוי. בדרך כלל זה צריך להיות השם המוצג של המשאב ששונה.
description

string

פלט בלבד. תיאור השינוי, שבדרך כלל כולל את השדות ששונו במשאב.
resource

string

פלט בלבד. המשאב שהשתנה.
resourceType

string

פלט בלבד. סוג המשאב שהשתנה.
action

string

פלט בלבד. הפעולה שבוצעה במשאב.
originalResource

object (Struct format)

פלט בלבד. מקור המידע המקורי לפני השינוי.
newResource

object (Struct format)

פלט בלבד. מקור המידע החדש אחרי השינוי.
dependentResources[]

object (Struct format)

פלט בלבד. מקורות המידע התלויים שהשתנו.
createTime

string (Timestamp format)

פלט בלבד. השעה שבה בוצע השינוי.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
sequenceNumber

string (int64 format)

פלט בלבד. מספר הרצף של יומן השינויים, שגדל באופן מונוטוני.

Struct

ייצוג ב-JSON 
{
  "fields": {
    string: value,
    ...
  }
}
שדות
fields

map (key: string, value: value (Value format))

מפה לא מסודרת של ערכים עם הקלדה דינמית.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

ייצוג ב-JSON 
{
  "key": string,
  "value": value
}
שדות
key

string
value

value (Value format)

ערך

ייצוג ב-JSON 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
שדות
שדה איחוד kind. סוג הערך. הערך kind יכול להיות רק אחד מהבאים:
nullValue

null

מייצג JSON null.
numberValue

number

מייצג מספר ב-JSON. הערך לא יכול להיות NaN, Infinity או -Infinity, כי אין תמיכה בערכים האלה ב-JSON. בנוסף, אי אפשר לייצג ערכי Int64 גדולים, כי פורמט JSON בדרך כלל לא תומך בהם בסוג המספר שלו.
stringValue

string

מייצג מחרוזת JSON.
boolValue

boolean

מייצג ערך בוליאני ב-JSON (הערכים true או false ב-JSON).
structValue

object (Struct format)

מייצג אובייקט JSON.
listValue

array (ListValue format)

מייצג מערך JSON.

ListValue

ייצוג ב-JSON 
{
  "values": [
    value
  ]
}
שדות
values[]

value (Value format)

שדה חוזר של ערכים עם הקלדה דינמית.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך צריך להיות בין ‎-62135596800 ל-253402300799 כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

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

NullValue

מייצג JSON null.

‫NullValue הוא ערך שמירה, שמשתמש בסוג enum עם ערך אחד בלבד כדי לייצג את ערך ה-null עבור איחוד הסוגים Value.

שדה מסוג NullValue עם ערך כלשהו שאינו 0 נחשב לא תקין. רוב הסריאליזטורים של ProtoJSON יפלטו Value עם null_value שמוגדר כ-JSON null בלי קשר לערך המספרי, ולכן יבצעו המרה הלוך ושוב לערך 0.

טיפוסים בני מנייה (enum)
NULL_VALUE ערך null.

הערות בכלי

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

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

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

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