MCP Reference: ces.googleapis.com

Server MCP per l'API Gemini Enterprise for Customer Experience

Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione AI. I server MCP connettono le applicazioni di AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione di AI può comprendere.

Configurazione del server

Prima dell'uso, devi abilitare i server MCP e configurare l'autenticazione. Per ulteriori informazioni sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.

Endpoint server

Un endpoint di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (di solito un URL) del server MCP che un'applicazione AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per l'LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa. Gli endpoint Google MCP possono essere globali o regionali.

Il server MCP dell'API Gemini Enterprise for Customer Experience ha il seguente endpoint MCP globale:

• https://ces.googleapis.com/mcp

Strumenti MCP

Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un LLM o a un'applicazione AI per eseguire un'azione nel mondo reale.

Strumenti

Il server MCP ces.googleapis.com dispone dei seguenti strumenti:

Strumenti MCP
list_apps	Elenca le app nel progetto e nella località specificati.
get_app	Recupera i dettagli dell'app specificata.
create_app	Crea una nuova app nel progetto e nella località specificati.
update_app	Aggiorna l'app specificata. Assicurati di passare sempre una maschera di aggiornamento nell'input.
delete_app	Elimina l'app specificata.
list_agents	Elenca gli agenti nell'app specificata.
get_agent	Recupera i dettagli dell'agente specificato.
create_agent	Crea un nuovo agente nell'app specificata.
update_agent	Aggiorna l'agente specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input.
delete_agent	Elimina l'agente specificato.
list_tools	Elenca gli strumenti nell'app specificata.
get_tool	Recupera i dettagli dello strumento specificato.
create_tool	Crea un nuovo strumento nell'app specificata.
update_tool	Aggiorna lo strumento specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input.
delete_tool	Elimina lo strumento specificato.
list_guardrails	Elenca i guardrail nell'app specificata.
get_guardrail	Recupera i dettagli della barriera protettiva specificata.
create_guardrail	Crea una nuova barriera protettiva nell'app specificata.
update_guardrail	Aggiorna la barriera di protezione specificata. Assicurati di passare sempre una maschera di aggiornamento nell'input.
delete_guardrail	Elimina la barriera di protezione specificata.
list_deployments	Elenca i deployment nell'app specificata.
get_deployment	Recupera i dettagli del deployment specificato.
create_deployment	Crea un nuovo deployment nell'app specificata.
update_deployment	Aggiorna il deployment specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input.
delete_deployment	Elimina il deployment specificato.
list_toolsets	Elenca i toolset nell'app specificata.
get_toolset	Recupera i dettagli del set di strumenti specificato.
create_toolset	Crea un nuovo set di strumenti nell'app specificata.
update_toolset	Aggiorna il set di strumenti specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input.
delete_toolset	Elimina il toolset specificato.
list_app_versions	Elenca tutte le versioni dell'app specificata.
get_app_version	Recupera i dettagli della versione dell'app specificata.
create_app_version	Crea una nuova versione dell'app nell'app specificata.
delete_app_version	Elimina la versione dell'app specificata.
restore_app_version	Ripristina la versione dell'app specificata.
list_changelogs	Elenca i log delle modifiche nell'app specificata.
get_changelog	Recupera i dettagli del changelog specificato.
start_export_app	Avvia l'esportazione di un'app CES
start_import_app	Inizia a importare un'app CES
run_evaluation	Esegue una valutazione per un'app CES
create_evaluation	Crea una nuova valutazione.
create_evaluation_dataset	Crea un nuovo set di dati di valutazione.
delete_evaluation	Elimina la valutazione specificata.
delete_evaluation_dataset	Elimina il set di dati di valutazione specificato.
generate_evaluation_from_conversation	Genera una valutazione da una conversazione.
get_evaluation	Recupera i dettagli della valutazione specificata.
get_evaluation_dataset	Recupera i dettagli del set di dati di valutazione specificato.
get_evaluation_result	Recupera i dettagli del risultato della valutazione specificato.
get_evaluation_run	Recupera i dettagli dell'esecuzione della valutazione specificata.
list_evaluation_datasets	Elenca i set di dati di valutazione.
list_evaluation_results	Elenca i risultati della valutazione.
list_evaluation_runs	Elenca le esecuzioni della valutazione.
list_evaluations	Elenca le valutazioni.
update_evaluation	Aggiorna la valutazione specificata. Assicurati di passare sempre una maschera di aggiornamento nell'input.
update_evaluation_dataset	Aggiorna il set di dati di valutazione specificato. Assicurati di passare sempre una maschera di aggiornamento nell'input.
delete_evaluation_result	Elimina il risultato della valutazione specificato.
delete_evaluation_run	Elimina l'esecuzione della valutazione specificata.
get_conversation	Recupera i dettagli della conversazione specificata.
list_conversations	Elenca le conversazioni.
get_operation	Recupera lo stato di un'operazione a lunga esecuzione. Utilizzo Alcuni strumenti (ad esempio run_evaluation) restituiscono un'operazione a lunga esecuzione. Puoi utilizzare questo strumento per ottenere lo stato dell'operazione. Può essere chiamato ripetutamente per eseguire il polling dello stato di un'operazione a lunga esecuzione Parametri * name: il nome dell'operazione da recuperare. * name deve essere il nome restituito dallo strumento che ha avviato l'operazione. * name deve essere nel formato projects/{project}/locations/{location}/operations/{operation}.

Ottenere le specifiche dello strumento MCP

Per ottenere le specifiche dello strumento MCP per tutti gli strumenti in un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili nel server MCP.

Richiesta curl
curl --location 'https://ces.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }'