MCP Reference: ces.googleapis.com

Ein Model Context Protocol (MCP)-Server fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung verstehen kann.

Server einrichten

Sie müssen MCP-Server aktivieren und die Authentifizierung einrichten, bevor Sie sie verwenden können. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Google Cloud-MCP-Server – Übersicht.

MCP-Server für die Gemini Enterprise for Customer Experience API

Serverendpunkte

Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (in der Regel eine URL) des MCP-Servers, über die eine KI-Anwendung (der Host für den MCP-Client) eine sichere, standardisierte Verbindung herstellt. Es ist der Kontaktpunkt für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google MCP-Endpunkte können global oder regional sein.

Der MCP-Server „ces.googleapis.com“ hat den folgenden MCP-Endpunkt:

  • https://ces.[REGION].rep.googleapis.com/mcp

MCP-Tools

Ein MCP-Tool ist eine Funktion oder ausführbare Funktion, die ein MCP-Server für ein LLM oder eine KI-Anwendung bereitstellt, um eine Aktion in der realen Welt auszuführen.

Der MCP-Server „ces.googleapis.com“ bietet die folgenden Tools:

MCP-Tools
list_apps Listet Apps im angegebenen Projekt und am angegebenen Standort auf.
get_app Ruft Details zur angegebenen App ab.
create_app Erstellt eine neue App im angegebenen Projekt und am angegebenen Standort.
update_app Aktualisiert die angegebene App. Achten Sie darauf, immer eine Aktualisierungsmaske in der Eingabe zu übergeben.
delete_app Löscht die angegebene App.
list_agents Listet Agenten in der angegebenen App auf.
get_agent Ruft Details zum angegebenen Agent ab.
create_agent Erstellt einen neuen Agent in der angegebenen App.
update_agent Aktualisiert den angegebenen Agent. Achten Sie darauf, dass Sie immer eine Aktualisierungsmaske in der Eingabe übergeben.
delete_agent Löscht den angegebenen Agent.
list_tools Listet Tools in der angegebenen App auf.
get_tool Ruft Details zum angegebenen Tool ab.
create_tool Erstellt ein neues Tool in der angegebenen App.
update_tool Aktualisiert das angegebene Tool. Achten Sie darauf, dass Sie immer eine Aktualisierungsmaske in der Eingabe übergeben.
delete_tool Löscht das angegebene Tool.
list_guardrails Listet die Richtlinien für die angegebene App auf.
get_guardrail Ruft Details zur angegebenen Richtlinie ab.
create_guardrail Erstellt eine neue Leitplanke in der angegebenen App.
update_guardrail Aktualisiert die angegebene Schutzvorrichtung. Achten Sie darauf, dass Sie immer eine Aktualisierungsmaske in der Eingabe übergeben.
delete_guardrail Löscht die angegebene Schutzleitplanke.
list_deployments Listet Bereitstellungen in der angegebenen App auf.
get_deployment Ruft Details zur angegebenen Bereitstellung ab.
create_deployment Erstellt ein neues Deployment in der angegebenen App.
update_deployment Aktualisiert die angegebene Bereitstellung. Achten Sie darauf, dass Sie immer eine Aktualisierungsmaske in der Eingabe übergeben.
delete_deployment Löscht die angegebene Bereitstellung.
list_toolsets Listet Toolsets in der angegebenen App auf.
get_toolset Ruft Details zum angegebenen Toolset ab.
create_toolset Erstellt ein neues Toolset in der angegebenen App.
update_toolset Aktualisiert das angegebene Toolset. Achten Sie darauf, dass Sie immer eine Aktualisierungsmaske in der Eingabe übergeben.
delete_toolset Löscht das angegebene Toolset.
list_app_versions Listet alle App-Versionen in der angegebenen App auf.
get_app_version Ruft Details zur angegebenen App-Version ab.
create_app_version Erstellt eine neue App-Version in der angegebenen App.
delete_app_version Löscht die angegebene App-Version.
restore_app_version Stellt die angegebene App-Version wieder her.
list_changelogs Listet Änderungsprotokolle in der angegebenen App auf.
get_changelog Ruft die Details des angegebenen Changelogs ab.
start_export_app Export einer CES-App starten
start_import_app Import einer CES-App wird gestartet
run_evaluation Führt eine Bewertung für eine CES-App durch
create_evaluation Erstellt eine neue Auswertung.
create_evaluation_dataset Erstellt ein neues Bewertungs-Dataset.
delete_evaluation Löscht die angegebene Bewertung.
delete_evaluation_dataset Löscht das angegebene Evaluierungs-Dataset.
generate_evaluation_from_conversation Generiert eine Bewertung aus einer Unterhaltung.
get_evaluation Ruft Details zur angegebenen Bewertung ab.
get_evaluation_dataset Ruft Details zum angegebenen Bewertungs-Dataset ab.
get_evaluation_result Ruft Details zum angegebenen Bewertungsergebnis ab.
get_evaluation_run Ruft Details zum angegebenen Ausführung der Auswertung ab.
list_evaluation_datasets Listet Bewertungs-Datasets auf.
list_evaluation_results Listet die Bewertungsergebnisse auf.
list_evaluation_runs Listet Bewertungsausführungen auf.
list_evaluations Listet Bewertungen auf.
update_evaluation Aktualisiert die angegebene Bewertung. Achten Sie darauf, dass Sie immer eine Aktualisierungsmaske in der Eingabe übergeben.
update_evaluation_dataset Aktualisiert das angegebene Bewertungs-Dataset. Achten Sie darauf, immer eine Aktualisierungsmaske in der Eingabe zu übergeben.
delete_evaluation_result Löscht das angegebene Bewertungsergebnis.
delete_evaluation_run Löscht den angegebenen Bewertungsdurchlauf.
get_conversation Ruft Details zur angegebenen Unterhaltung ab.
list_conversations Listet Unterhaltungen auf.
get_operation

Ruft den Status eines lange laufenden Vorgangs ab.

Verwendung: Einige Tools (z. B. run_evaluation) geben einen Vorgang mit langer Ausführungszeit zurück. Mit diesem Tool können Sie den Status des Vorgangs abrufen. Sie kann wiederholt aufgerufen werden, um den Status eines Vorgangs mit langer Ausführungszeit abzufragen.

Parameter * name: Der Name des abzurufenden Vorgangs. * name sollte der Name sein, der vom Tool zurückgegeben wird, das den Vorgang initiiert hat. * name muss das Format projects/{project}/locations/{location}/operations/{operation} haben.

Spezifikationen für MCP-Tools abrufen

Wenn Sie die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abrufen möchten, verwenden Sie die Methode tools/list. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.

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/list",
    "jsonrpc": "2.0",
    "id": 1
}'