MCP Tools Reference: ces.googleapis.com

כלי: get_evaluation_run

קבלת פרטים על הפעלת ההערכה שצוינה.

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

סכימת הקלט

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

GetEvaluationRunRequest

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

string

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

סכימת הפלט

הרצת הערכה מייצגת את כל תוצאות ההערכה מהרצת הערכה.

EvaluationRun

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "evaluationResults": [
    string
  ],
  "createTime": string,
  "initiatedBy": string,
  "appVersion": string,
  "appVersionDisplayName": string,
  "changelog": string,
  "changelogCreateTime": string,
  "evaluations": [
    string
  ],
  "evaluationDataset": string,
  "evaluationType": enum (EvaluationType),
  "state": enum (EvaluationRunState),
  "progress": {
    object (Progress)
  },
  "config": {
    object (EvaluationConfig)
  },
  "error": {
    object (Status)
  },
  "errorInfo": {
    object (EvaluationErrorInfo)
  },
  "evaluationRunSummaries": {
    string: {
      object (EvaluationRunSummary)
    },
    ...
  },
  "latencyReport": {
    object (LatencyReport)
  },
  "runCount": integer,
  "personaRunConfigs": [
    {
      object (PersonaRunConfig)
    }
  ],
  "optimizationConfig": {
    object (OptimizationConfig)
  },
  "scheduledEvaluationRun": string,
  "goldenRunMethod": enum (GoldenRunMethod),
  "operation": string
}
שדות
name

string

מזהה. המזהה הייחודי של הרצת ההערכה. פורמט: projects/{project}/locations/{location}/apps/{app}/evaluationRuns/{evaluationRun}
displayName

string

זה שינוי אופציונלי. השם המוצג של הרצת ההערכה שהוגדר על ידי המשתמש. ברירת מחדל: run - .
evaluationResults[]

string

פלט בלבד. תוצאות ההערכה שקשורות להרצה הזו. פורמט: projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}/results/{result}
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".
initiatedBy

string

פלט בלבד. המשתמש שהפעיל את הרצת ההערכה.
appVersion

string

פלט בלבד. גרסת האפליקציה להערכה. פורמט: projects/{project}/locations/{location}/apps/{app}/versions/{version}
appVersionDisplayName

string

פלט בלבד. השם המוצג של app_version שההערכה הופעלה לגביו.
changelog

string

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

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".
evaluations[]

string

פלט בלבד. ההערכות שכלולות בהרצה הזו. הרשימה יכולה להכיל הערכות מכל אחד מהסוגים. השדה הזה לא יכול להופיע יחד עם השדה evaluation_dataset. פורמט: projects/{project}/locations/{location}/apps/{app}/evaluations/{evaluation}
evaluationDataset

string

פלט בלבד. מערך נתוני ההערכה שהריצה הזו משויכת אליו. השדה הזה לא יכול להופיע יחד עם השדה evaluations. פורמט: projects/{project}/locations/{location}/apps/{app}/evaluationDatasets/{evaluationDataset}
evaluationType

enum (EvaluationType)

פלט בלבד. סוג ההערכות בהרצה הזו.
state

enum (EvaluationRunState)

פלט בלבד. המצב של ההרצה של ההערכה.
progress

object (Progress)

פלט בלבד. ההתקדמות של הרצת ההערכה.
config

object (EvaluationConfig)

פלט בלבד. ההגדרה שבה נעשה שימוש בהרצה.
error
(deprecated)

object (Status)

פלט בלבד. המאפיין הזה הוצא משימוש. במקומו צריך להשתמש ב-error_info. שגיאות שאירעו במהלך הביצוע.
errorInfo

object (EvaluationErrorInfo)

פלט בלבד. פרטי השגיאה של הרצת ההערכה.
evaluationRunSummaries

map (key: string, value: object (EvaluationRunSummary))

פלט בלבד. מיפוי של שם ההערכה ל-EvaluationRunSummary.

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

object (LatencyReport)

פלט בלבד. דוח השהיה של הרצת ההערכה.
runCount

integer

פלט בלבד. מספר הפעמים שההערכות בתוך ההרצה הופעלו.
personaRunConfigs[]

object (PersonaRunConfig)

פלט בלבד. ההגדרה שתשמש להרצה לכל פרסונה.
optimizationConfig

object (OptimizationConfig)

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

string

פלט בלבד. שם המשאב של ההפעלה המתוזמנת של ההערכה שיצרה את הפעלת ההערכה הזו. השדה הזה מוגדר רק אם ההרצה של ההערכה נוצרה על ידי הרצה מתוזמנת של הערכה. פורמט: projects/{project}/locations/{location}/apps/{app}/scheduledEvaluationRuns/{scheduled_evaluation_run}
goldenRunMethod

enum (GoldenRunMethod)

פלט בלבד. השיטה שבה נעשה שימוש להרצת ההערכה.
operation

string

פלט בלבד. הפעולה שיצרה את ההרצה הזו של ההערכה. פורמט: projects/{project}/locations/{location}/operations/{operation}

חותמת הזמן

ייצוג ב-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, כולל.

התקדמות

ייצוג ב-JSON 
{
  "totalCount": integer,
  "failedCount": integer,
  "errorCount": integer,
  "completedCount": integer,
  "passedCount": integer,
  "cancelledCount": integer
}
שדות
totalCount

integer

פלט בלבד. המספר הכולל של תוצאות ההערכה בהרצה הזו.
failedCount

integer

פלט בלבד. מספר התוצאות של בדיקות שהושלמו עם התוצאה FAIL. ‫(EvaluationResult.execution_state הוא COMPLETED ו-EvaluationResult.evaluation_status הוא FAIL).
errorCount

integer

פלט בלבד. מספר התוצאות של ההערכה שנכשלו בהרצה. ‫(EvaluationResult.execution_state is ERROR).
completedCount

integer

פלט בלבד. מספר התוצאות של ההערכה שהושלמו בהצלחה. ‫(EvaluationResult.execution_state is COMPLETED).
passedCount

integer

פלט בלבד. מספר התוצאות של הערכות שהושלמו עם תוצאה של PASS. ‫(EvaluationResult.execution_state הוא COMPLETED ו-EvaluationResult.evaluation_status הוא PASS).
cancelledCount

integer

פלט בלבד. מספר התוצאות של הערכות שבוטלו. ‫(EvaluationResult.execution_state הוא CANCELLED).

EvaluationConfig

ייצוג ב-JSON 
{
  "inputAudioConfig": {
    object (InputAudioConfig)
  },
  "outputAudioConfig": {
    object (OutputAudioConfig)
  },
  "evaluationChannel": enum (EvaluationChannel),
  "toolCallBehaviour": enum (EvaluationToolCallBehaviour)
}
שדות
inputAudioConfig

object (InputAudioConfig)

זה שינוי אופציונלי. הגדרות לעיבוד האודיו שמתקבל.
outputAudioConfig

object (OutputAudioConfig)

זה שינוי אופציונלי. הגדרות ליצירת פלט האודיו.
evaluationChannel

enum (EvaluationChannel)

זה שינוי אופציונלי. הערוץ שרוצים לבדוק.
toolCallBehaviour

enum (EvaluationToolCallBehaviour)

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

InputAudioConfig

ייצוג ב-JSON 
{
  "audioEncoding": enum (AudioEncoding),
  "sampleRateHertz": integer,
  "noiseSuppressionLevel": string
}
שדות
audioEncoding

enum (AudioEncoding)

חובה. הקידוד של נתוני האודיו של הקלט.
sampleRateHertz

integer

חובה. תדירות הדגימה (בהרץ) של נתוני האודיו של הקלט.
noiseSuppressionLevel

string

זה שינוי אופציונלי. האם להפעיל סינון רעשים באודיו של הקלט. הערכים האפשריים הם low,‏ moderate,‏ high,‏ very_high.

OutputAudioConfig

ייצוג ב-JSON 
{
  "audioEncoding": enum (AudioEncoding),
  "sampleRateHertz": integer
}
שדות
audioEncoding

enum (AudioEncoding)

חובה. הקידוד של נתוני האודיו של הפלט.
sampleRateHertz

integer

חובה. תדירות הדגימה (בהרץ) של נתוני האודיו של הפלט.

סטטוס

ייצוג ב-JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
שדות
code

integer

קוד הסטטוס, שצריך להיות ערך enum של google.rpc.Code.
message

string

הודעת שגיאה שמוצגת למפתח, שצריכה להיות באנגלית. כל הודעת שגיאה שמוצגת למשתמש צריכה להיות מותאמת לשפה המקומית ולהישלח בשדה google.rpc.Status.details, או להיות מותאמת לשפה המקומית על ידי הלקוח.
details[]

object

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

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI שמזהה את הסוג. לדוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }.

הכול

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

string

מזהה את הסוג של הודעת Protobuf שעברה סריאליזציה באמצעות הפניה ל-URI שכוללת קידומת שמסתיימת בקו נטוי ואת שם הסוג שמוגדר במלואו.

דוגמה: type.googleapis.com/google.protobuf.StringValue

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

הקידומת היא שרירותית, וההטמעות של Protobuf אמורות פשוט להסיר את כל מה שמופיע עד הסימן / האחרון, כולל הסימן עצמו, כדי לזהות את הסוג. ‫type.googleapis.com/ היא תחילית ברירת מחדל נפוצה שנדרשת בחלק מההטמעות מדור קודם. הקידומת הזו לא מציינת את המקור של הסוג, ולא צפוי שמזהי URI שמכילים אותה יגיבו לבקשות כלשהן.

כל מחרוזות כתובות ה-URL של הסוג חייבות להיות הפניות URI חוקיות, עם הגבלה נוספת (בפורמט הטקסט) שלפיה התוכן של ההפניה חייב לכלול רק תווים אלפאנומריים, תווים מוברחים בקידוד אחוזים ותווים בערכה הבאה (לא כולל הגרשיים החיצוניים): /-.~_!$&()*+,;=. למרות שאנחנו מאפשרים קידודים באחוזים, בהטמעות לא צריך לבטל את הקידוד שלהם כדי למנוע בלבול עם מנתחים קיימים. לדוגמה, בקשה עם הערך type.googleapis.com%2FFoo צריכה להידחות.

בתכנון המקורי של Any נשקלה האפשרות להפעיל שירות לפתרון סוגים בכתובות ה-URL האלה של הסוגים, אבל ב-Protobuf אף פעם לא בוצעה הטמעה של שירות כזה, והפנייה לכתובות ה-URL האלה נחשבת לבעייתית ועלולה לגרום לבעיות אבטחה. אל תנסו ליצור קשר עם כתובות URL מהסוג הזה.
value

string (bytes format)

מכיל סריאליזציה של Protobuf של הסוג שמתואר על ידי type_url.

מחרוזת בקידוד Base64.

EvaluationErrorInfo

ייצוג ב-JSON 
{
  "errorType": enum (ErrorType),
  "errorMessage": string,
  "sessionId": string,
  "userFacingErrorMessage": string
}
שדות
errorType

enum (ErrorType)

פלט בלבד. סוג השגיאה.
errorMessage

string

פלט בלבד. הודעת השגיאה.
sessionId

string

פלט בלבד. מזהה הסשן של השיחה שגרמה לשגיאה.
userFacingErrorMessage

string

פלט בלבד. הודעת השגיאה שמוצגת למשתמש.

EvaluationRunSummariesEntry

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

string
value

object (EvaluationRunSummary)

EvaluationRunSummary

ייצוג ב-JSON 
{
  "passedCount": integer,
  "failedCount": integer,
  "errorCount": integer
}
שדות
passedCount

integer

פלט בלבד. מספר התוצאות שעברו בבדיקה המשויכת בהרצה הזו.
failedCount

integer

פלט בלבד. מספר התוצאות שנכשלו בהרצה הזו של ההערכה המשויכת.
errorCount

integer

פלט בלבד. מספר תוצאות השגיאה להערכה המשויכת בהרצה הזו.

LatencyReport

ייצוג ב-JSON 
{
  "toolLatencies": [
    {
      object (ToolLatency)
    }
  ],
  "callbackLatencies": [
    {
      object (CallbackLatency)
    }
  ],
  "guardrailLatencies": [
    {
      object (GuardrailLatency)
    }
  ],
  "llmCallLatencies": [
    {
      object (LlmCallLatency)
    }
  ],
  "sessionCount": integer
}
שדות
toolLatencies[]

object (ToolLatency)

פלט בלבד. רשימה לא ממוינת. מדדי זמן האחזור של כל כלי.
callbackLatencies[]

object (CallbackLatency)

פלט בלבד. רשימה לא ממוינת. מדדי זמן האחזור של כל קריאה חוזרת.
guardrailLatencies[]

object (GuardrailLatency)

פלט בלבד. רשימה לא ממוינת. מדדי השהיה לכל אמצעי הגנה.
llmCallLatencies[]

object (LlmCallLatency)

פלט בלבד. רשימה לא ממוינת. מדדי זמן האחזור לכל קריאה למודל שפה גדול.
sessionCount

integer

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

ToolLatency

ייצוג ב-JSON 
{
  "toolDisplayName": string,
  "latencyMetrics": {
    object (LatencyMetrics)
  },

  // Union field tool_identifier can be only one of the following:
  "tool": string,
  "toolsetTool": {
    object (ToolsetTool)
  }
  // End of list of possible types for union field tool_identifier.
}
שדות
toolDisplayName

string

פלט בלבד. השם המוצג של הכלי.
latencyMetrics

object (LatencyMetrics)

פלט בלבד. מדדי זמן האחזור של הכלי.
שדה איחוד tool_identifier. המזהה של הכלי. הערך tool_identifier יכול להיות רק אחד מהבאים:
tool

string

פלט בלבד. פורמט: projects/{project}/locations/{location}/apps/{app}/tools/{tool}
toolsetTool

object (ToolsetTool)

פלט בלבד. מזהה הכלי בערכת הכלים.

ToolsetTool

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

string

חובה. שם המשאב של ערכת הכלים שממנה נגזר הכלי הזה. פורמט: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
toolId

string

זה שינוי אופציונלי. מזהה הכלי לסינון הכלים כדי לאחזר את הסכימה שלהם.

LatencyMetrics

ייצוג ב-JSON 
{
  "p50Latency": string,
  "p90Latency": string,
  "p99Latency": string,
  "callCount": integer
}
שדות
p50Latency

string (Duration format)

פלט בלבד. זמן האחזור באחוזון ה-50.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
p90Latency

string (Duration format)

פלט בלבד. זמן האחזור באחוזון ה-90.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
p99Latency

string (Duration format)

פלט בלבד. זמן האחזור באחוזון ה-99.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".
callCount

integer

פלט בלבד. מספר הפעמים שהייתה קריאה למשאב.

משך

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

string (int64 format)

מספר השניות עם סימן של טווח הזמן. הערך חייב להיות בין ‎-315,576,000,000 לבין ‎+315,576,000,000, כולל. הערה: הגבולות האלה מחושבים לפי: 60 שניות בדקה * 60 דקות בשעה * 24 שעות ביממה * 365.25 ימים בשנה * 10,000 שנים
nanos

integer

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

CallbackLatency

ייצוג ב-JSON 
{
  "stage": string,
  "latencyMetrics": {
    object (LatencyMetrics)
  }
}
שדות
stage

string

פלט בלבד. השלב של הקריאה החוזרת.
latencyMetrics

object (LatencyMetrics)

פלט בלבד. מדדי זמן האחזור של הקריאה החוזרת.

GuardrailLatency

ייצוג ב-JSON 
{
  "guardrail": string,
  "guardrailDisplayName": string,
  "latencyMetrics": {
    object (LatencyMetrics)
  }
}
שדות
guardrail

string

פלט בלבד. השם של אמצעי הבקרה. פורמט: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
guardrailDisplayName

string

פלט בלבד. השם המוצג של אמצעי הבקרה.
latencyMetrics

object (LatencyMetrics)

פלט בלבד. מדדי זמן האחזור של אמצעי הבקרה.

LlmCallLatency

ייצוג ב-JSON 
{
  "model": string,
  "latencyMetrics": {
    object (LatencyMetrics)
  }
}
שדות
model

string

פלט בלבד. שם המודל.
latencyMetrics

object (LatencyMetrics)

פלט בלבד. מדדי זמן הטעינה של קריאת ה-LLM.

PersonaRunConfig

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

string

זה שינוי אופציונלי. הפרסונה שבה צריך להשתמש לצורך ההערכה. פורמט: projects/{project}/locations/{location}/apps/{app}/evaluationPersonas/{evaluationPersona}
taskCount

integer

זה שינוי אופציונלי. מספר המשימות להרצה עבור האישיות.

OptimizationConfig

ייצוג ב-JSON 
{
  "generateLossReport": boolean,
  "assistantSession": string,
  "reportSummary": string,
  "shouldSuggestFix": boolean,
  "status": enum (OptimizationStatus),
  "errorMessage": string,
  "lossReport": {
    object
  }
}
שדות
generateLossReport

boolean

זה שינוי אופציונלי. האם ליצור דוח על אובדן.
assistantSession

string

פלט בלבד. הסשן של העוזר הדיגיטלי שבו יש להשתמש לאופטימיזציה על סמך הרצת ההערכה הזו. פורמט: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
reportSummary

string

פלט בלבד. סיכום דוח האובדן.
shouldSuggestFix

boolean

פלט בלבד. האם להציע תיקון להפסדים.
status

enum (OptimizationStatus)

פלט בלבד. הסטטוס של תהליך האופטימיזציה.
errorMessage

string

פלט בלבד. הודעת השגיאה אם הפעלת האופטימיזציה נכשלה.
lossReport

object (Struct 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)

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

EvaluationType

סוג ההערכות בהרצה הזו. יכול להיות שבעתיד נוסיף עוד ערכים.

טיפוסים בני מנייה (enum)
EVALUATION_TYPE_UNSPECIFIED לא צוין סוג הערכה.
GOLDEN הערכה מוזהבת.
SCENARIO הערכת התרחיש.
MIXED מציין שההרצה כוללת שילוב של הערכות של תשובות מוזהבות ושל תרחישים.

EvaluationRunState

המצב של ההרצה של ההערכה.

טיפוסים בני מנייה (enum)
EVALUATION_RUN_STATE_UNSPECIFIED לא צוין מצב של הפעלת הערכה.
QUEUED המשמעות היא שהרצת ההערכה ממתינה בתור.
RUNNING הפעלת ההערכה מתבצעת.
COMPLETED ההרצה של ההערכה הושלמה.
ERROR יש שגיאה בהרצת ההערכה.
CANCELLED הפעלת ההערכה בוטלה.

AudioEncoding

התג AudioEncoding מציין את פורמט הקידוד של נתוני האודיו.

טיפוסים בני מנייה (enum)
AUDIO_ENCODING_UNSPECIFIED קידוד אודיו שלא צוין.
LINEAR16 קידוד אודיו PCM ליניארי של 16 ביט.
MULAW דגימות של 8 ביט שמרחיבות דגימות של אודיו של 14 ביט באמצעות G.711 PCMU/mu-law.
ALAW דגימות של 8 ביט שמרחיבות דגימות אודיו של 14 ביט באמצעות G.711 PCMU/A-law.

EvaluationChannel

הערוץ שרוצים לבדוק.

טיפוסים בני מנייה (enum)
EVALUATION_CHANNEL_UNSPECIFIED ערוץ הערכה לא צוין.
TEXT ערוץ הערכה עם טקסט בלבד.
AUDIO ערוץ להערכת אודיו.

EvaluationToolCallBehaviour

הגדרת אופן הפעולה של קריאות לכלי בהרצות של הערכה.

טיפוסים בני מנייה (enum)
EVALUATION_TOOL_CALL_BEHAVIOUR_UNSPECIFIED התנהגות לא מוגדרת של קריאה לכלי. ברירת המחדל תהיה הפעלת כלים אמיתיים.
REAL להשתמש בקריאות אמיתיות לכלים.
FAKE שימוש בקריאות מזויפות לכלים.

ErrorType

סוג השגיאה

טיפוסים בני מנייה (enum)
ERROR_TYPE_UNSPECIFIED סוג שגיאה לא מזוהה.
RUNTIME_FAILURE ההרצה נכשלה במהלך זמן הריצה.
CONVERSATION_RETRIEVAL_FAILURE הייתה בעיה והשיחה לא אוחזרה מ-CES Runtime.
METRIC_CALCULATION_FAILURE לא הצליח לחשב מדד או תוצאה.
EVALUATION_UPDATE_FAILURE העדכון של ההערכה נכשל.
QUOTA_EXHAUSTED הגעתם למכסה.
USER_SIMULATION_FAILURE כשל במהלך סימולציית משתמש.

OptimizationStatus

הסטטוס של תהליך האופטימיזציה.

טיפוסים בני מנייה (enum)
OPTIMIZATION_STATUS_UNSPECIFIED לא צוין סטטוס האופטימיזציה.
RUNNING האופטימיזציה פועלת.
COMPLETED האופטימיזציה הושלמה.
ERROR האופטימיזציה נכשלה בגלל שגיאה פנימית.

NullValue

מייצג JSON null.

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

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

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

GoldenRunMethod

השיטה שבה נעשה שימוש להרצת ההערכה.

טיפוסים בני מנייה (enum)
GOLDEN_RUN_METHOD_UNSPECIFIED לא צוינה שיטת הפעלה.
STABLE מריצים את ההערכה כהפעלה חוזרת יציבה, שבה כל תור הוא סשן ייחודי עם התורים הקודמים הצפויים שמוזרקים כהקשר.
NAIVE מריצים את ההערכה כהפעלה חוזרת פשוטה, שבה ההפעלה היא סשן יחיד ללא הקשר מוזרק.

הערות בכלי

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

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

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

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