MCP Tools Reference: ces.googleapis.com

Tool: `run_evaluation`

Führt eine Bewertung für eine CES-App durch

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool run_evaluation aufrufen.

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

Curl-Anfrage

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

Eingabeschema

Anfragenachricht für McpService.RunEvaluation.

RunEvaluationRequest

JSON-Darstellung
{ "app": string, "evaluations": [ string ], "evaluationDataset": string, "displayName": string, "appVersion": string }

Felder
`app`	`string` Der Ressourcenname der App, für die die Bewertung ausgeführt werden soll. Format: projects/{project}/locations/{location}/apps/{app}
`evaluations[]`	`string` Die Liste der auszuführenden Bewertungs-IDs.
`evaluationDataset`	`string` Die ID des Bewertungsdatasets, das für den Lauf verwendet werden soll.
`displayName`	`string` Der Anzeigename des Testlaufs.
`appVersion`	`string` Die App-Version, die für den Bewertungsdurchlauf verwendet werden soll.

Ausgabeschema

Diese Ressource steht für einen Vorgang mit langer Ausführungszeit, der das Ergebnis eines Netzwerk-API-Aufrufs ist.

Vorgang

JSON-Darstellung

JSON-Darstellung
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field `result` can be only one of the following: "error": { object (`Status`) }, "response": { "@type": string, field1: ..., ... } // End of list of possible types for union field `result`. }

{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}

Felder
`name`	`string` Der vom Server zugewiesene Name, der nur innerhalb des Dienstes eindeutig ist, der ihn ursprünglich zurückgibt. Wenn Sie die Standard-HTTP-Zuordnung verwenden, sollte `name` ein Ressourcenname sein, der auf `operations/{unique_id}` endet.
`metadata`	`object` Dienstspezifische Metadaten, die mit dem Vorgang verknüpft sind. Typischerweise enthalten sie Informationen zum Verlauf und gemeinsame Metadaten wie den Erstellungszeitpunkt. Solche Metadaten werden nicht von allen Diensten bereitgestellt. Jede Methode, die einen Vorgang mit langer Ausführungszeit zurückgibt, muss gegebenenfalls den Metadatentyp dokumentieren. Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld `"@type"` enthält einen URI zur Identifizierung des Typs. Beispiel: `{ "id": 1234, "@type": "types.example.com/standard/id" }`
`done`	`boolean` Ist der Wert `false`, bedeutet das, dass der Vorgang noch läuft. Ist der Wert hingegen `true`, ist der Vorgang abgeschlossen und entweder `error` oder `response` ist verfügbar.
Union-Feld `result`. Das Ergebnis des Vorgangs kann entweder ein `error` oder eine gültige `response` sein. Wenn `done` = `false` ist, wird weder `error` noch `response` festgelegt. Wenn `done` = `true` ist, kann genau ein `error` oder eine `response` festgelegt werden. Einige Dienste stellen das Ergebnis möglicherweise nicht bereit. Für `result` ist nur einer der folgenden Werte zulässig:
`error`	`object (Status)` Das Fehlerergebnis des Vorgangs im Fall eines Fehlers oder Abbruchs.
`response`	`object` Die normale, erfolgreiche Antwort des Vorgangs. Wenn die ursprüngliche Methode im Erfolgsfall keine Daten zurückgibt, wie bei `Delete`, lautet die Antwort `google.protobuf.Empty`. Ist die ursprüngliche Methode standardmäßig `Get`/`Create`/`Update`, sollte die Antwort die Ressource sein. Bei anderen Methoden sollte die Antwort vom Typ `XxxResponse` sein, wobei `Xxx` der Name der ursprünglichen Methode ist. Wenn zum Beispiel der Name der ursprünglichen Methode `TakeSnapshot()` ist, ist der gefolgerte Antworttyp `TakeSnapshotResponse`. Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld `"@type"` enthält einen URI zur Identifizierung des Typs. Beispiel: `{ "id": 1234, "@type": "types.example.com/standard/id" }`.

Beliebig

JSON-Darstellung
{ "typeUrl": string, "value": string }

Felder

Felder
`typeUrl`	`string` Gibt den Typ der serialisierten Protobuf-Nachricht mit einem URI-Verweis an, der aus einem Präfix, das mit einem Schrägstrich endet, und dem vollständig qualifizierten Typnamen besteht. Beispiel: type.googleapis.com/google.protobuf.StringValue Dieser String muss mindestens ein `/`-Zeichen enthalten. Der Inhalt nach dem letzten `/` muss der vollständig qualifizierte Name des Typs in kanonischer Form ohne führenden Punkt sein. Schreiben Sie kein Schema für diese URI-Referenzen, damit Clients nicht versuchen, sie zu kontaktieren. Das Präfix ist beliebig und Protobuf-Implementierungen sollen einfach alles bis zum letzten `/` (einschließlich) entfernen, um den Typ zu ermitteln. `type.googleapis.com/` ist ein häufiges Standardpräfix, das für einige ältere Implementierungen erforderlich ist. Dieses Präfix gibt nicht den Ursprung des Typs an und URIs, die es enthalten, werden voraussichtlich nicht auf Anfragen reagieren. Alle Typ-URL-Strings müssen gültige URI-Referenzen sein. Für das Textformat gilt die zusätzliche Einschränkung, dass der Inhalt der Referenz nur aus alphanumerischen Zeichen, prozentual codierten Escape-Sequenzen und Zeichen aus der folgenden Menge bestehen darf (ohne die äußeren Backticks): `/-.~_!$&()*+,;=`. Obwohl wir Prozentcodierungen zulassen, sollten Implementierungen sie nicht dekodieren, um Verwechslungen mit vorhandenen Parsern zu vermeiden. Beispiel: `type.googleapis.com%2FFoo` sollte abgelehnt werden. Im ursprünglichen Design von `Any` wurde die Möglichkeit in Betracht gezogen, einen Dienst zur Typauflösung unter diesen Typ-URLs zu starten. Protobuf hat jedoch nie einen solchen Dienst implementiert und betrachtet das Kontaktieren dieser URLs als problematisch und als potenzielles Sicherheitsproblem. Versuchen Sie nicht, URLs vom Typ „Kontakt“ aufzurufen.
`value`	`string (bytes format)` Enthält eine Protobuf-Serialisierung des Typs, der durch „type_url“ beschrieben wird. Ein base64-codierter String.

typeUrl

string

Gibt den Typ der serialisierten Protobuf-Nachricht mit einem URI-Verweis an, der aus einem Präfix, das mit einem Schrägstrich endet, und dem vollständig qualifizierten Typnamen besteht.

Beispiel: type.googleapis.com/google.protobuf.StringValue

Dieser String muss mindestens ein /-Zeichen enthalten. Der Inhalt nach dem letzten / muss der vollständig qualifizierte Name des Typs in kanonischer Form ohne führenden Punkt sein. Schreiben Sie kein Schema für diese URI-Referenzen, damit Clients nicht versuchen, sie zu kontaktieren.

Das Präfix ist beliebig und Protobuf-Implementierungen sollen einfach alles bis zum letzten / (einschließlich) entfernen, um den Typ zu ermitteln. type.googleapis.com/ ist ein häufiges Standardpräfix, das für einige ältere Implementierungen erforderlich ist. Dieses Präfix gibt nicht den Ursprung des Typs an und URIs, die es enthalten, werden voraussichtlich nicht auf Anfragen reagieren.

Alle Typ-URL-Strings müssen gültige URI-Referenzen sein. Für das Textformat gilt die zusätzliche Einschränkung, dass der Inhalt der Referenz nur aus alphanumerischen Zeichen, prozentual codierten Escape-Sequenzen und Zeichen aus der folgenden Menge bestehen darf (ohne die äußeren Backticks): /-.~_!$&()*+,;=. Obwohl wir Prozentcodierungen zulassen, sollten Implementierungen sie nicht dekodieren, um Verwechslungen mit vorhandenen Parsern zu vermeiden. Beispiel: type.googleapis.com%2FFoo sollte abgelehnt werden.

Im ursprünglichen Design von Any wurde die Möglichkeit in Betracht gezogen, einen Dienst zur Typauflösung unter diesen Typ-URLs zu starten. Protobuf hat jedoch nie einen solchen Dienst implementiert und betrachtet das Kontaktieren dieser URLs als problematisch und als potenzielles Sicherheitsproblem. Versuchen Sie nicht, URLs vom Typ „Kontakt“ aufzurufen.

value

string (bytes format)

Enthält eine Protobuf-Serialisierung des Typs, der durch „type_url“ beschrieben wird.

Ein base64-codierter String.

Status

JSON-Darstellung
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] }

Felder

Felder
`code`	`integer` Der Statuscode, der idealerweise ein ENUM-Wert von `google.rpc.Code` ist.
`message`	`string` Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede für Nutzer sichtbare Fehlermeldung sollte lokalisiert und im Feld `google.rpc.Status.details` gesendet werden. Sie kann auch clientseitig lokalisiert werden.
`details[]`	`object` Eine Auflistung aller Meldungen, die die Fehlerdetails enthalten. Es gibt einen gemeinsamen Satz von Nachrichtentypen, die APIs verwenden können. Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld `"@type"` enthält einen URI zur Identifizierung des Typs. Beispiel: `{ "id": 1234, "@type": "types.example.com/standard/id" }`.

code

integer

Der Statuscode, der idealerweise ein ENUM-Wert von google.rpc.Code ist.

message

string

Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede für Nutzer sichtbare Fehlermeldung sollte lokalisiert und im Feld google.rpc.Status.details gesendet werden. Sie kann auch clientseitig lokalisiert werden.

details[]

object

Eine Auflistung aller Meldungen, die die Fehlerdetails enthalten. Es gibt einen gemeinsamen Satz von Nachrichtentypen, die APIs verwenden können.

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

Tool-Annotationen

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌

MCP Tools Reference: ces.googleapis.com Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Tool: run_evaluation