MCP Reference: ces.googleapis.com

Gemini Enterprise for Customer Experience API 的 MCP 伺服器

Model Context Protocol (MCP) 伺服器可做為代理伺服器,在外部服務與大型語言模型 (LLM) 或 AI 應用程式之間傳遞脈絡、資料或功能。MCP 伺服器可將 AI 應用程式連結至資料庫和 Web 服務等外部系統,並將系統回覆轉換成 AI 應用程式可理解的格式。

伺服器設定

您必須先啟用 MCP 伺服器設定驗證,才能使用這項功能。如要進一步瞭解如何使用 Google 和 Google Cloud 遠端 MCP 伺服器,請參閱 Google Cloud MCP 伺服器總覽

伺服器端點

MCP 服務端點是 MCP 伺服器的網路位址和通訊介面 (通常是網址),AI 應用程式 (MCP 用戶端的主機) 會使用這個端點建立安全標準連線。這是 LLM 請求情境、呼叫工具或存取資源的聯絡點。Google MCP 端點可以是全域或區域性。

Gemini Enterprise for Customer Experience API MCP 伺服器具有下列全域 MCP 端點:

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

MCP 工具

MCP 工具是 MCP 伺服器向 LLM 或 AI 應用程式公開的函式或可執行功能,可在現實世界中執行動作。

工具

ces.googleapis.com MCP 伺服器提供下列工具:

MCP 工具
list_apps 列出指定專案和位置中的應用程式。
get_app 取得指定應用程式的詳細資料。
create_app 在指定專案和位置中建立新應用程式。
update_app 更新指定的應用程式。請務必在輸入內容中傳遞更新遮罩。
delete_app 刪除指定應用程式。
list_agents 列出指定應用程式中的代理程式。
get_agent 取得指定代理程式的詳細資料。
create_agent 在指定應用程式中建立新代理程式。
update_agent 更新指定的代理程式。請務必在輸入內容中一律傳遞更新遮罩。
delete_agent 刪除指定代理程式。
list_tools 列出指定應用程式中的工具。
get_tool 取得指定工具的詳細資料。
create_tool 在指定應用程式中建立新工具。
update_tool 更新指定的工具。請務必在輸入內容中一律傳遞更新遮罩。
delete_tool 刪除指定工具。
list_guardrails 列出指定應用程式中的防護措施。
get_guardrail 取得指定防護措施的詳細資料。
create_guardrail 在指定應用程式中建立新的防護措施。
update_guardrail 更新指定的防護措施。請務必在輸入內容中一律傳遞更新遮罩。
delete_guardrail 刪除指定的防護措施。
list_deployments 列出指定應用程式中的部署作業。
get_deployment 取得指定部署作業的詳細資料。
create_deployment 在指定應用程式中建立新的部署作業。
update_deployment 更新指定的部署作業。請務必在輸入內容中一律傳遞更新遮罩。
delete_deployment 刪除指定部署作業。
list_toolsets 列出指定應用程式中的工具集。
get_toolset 取得指定工具集的詳細資料。
create_toolset 在指定應用程式中建立新的工具集。
update_toolset 更新指定的工具集。請務必在輸入內容中一律傳遞更新遮罩。
delete_toolset 刪除指定的工具集。
list_app_versions 列出指定應用程式中的所有應用程式版本。
get_app_version 取得指定應用程式版本的詳細資料。
create_app_version 在指定應用程式中建立新版本。
delete_app_version 刪除指定的應用程式版本。
restore_app_version 還原指定的應用程式版本。
list_changelogs 列出指定應用程式的變更記錄。
get_changelog 取得指定變更記錄的詳細資料。
start_export_app 開始匯出 CES 應用程式
start_import_app 開始匯入 CES 應用程式
run_evaluation 執行 CES 應用程式的評估作業
create_evaluation 建立新的評估。
create_evaluation_dataset 建立新的評估資料集。
delete_evaluation 刪除指定評估。
delete_evaluation_dataset 刪除指定的評估資料集。
generate_evaluation_from_conversation 根據對話生成評估結果。
get_evaluation 取得指定評估的詳細資料。
get_evaluation_dataset 取得指定評估資料集的詳細資料。
get_evaluation_result 取得指定評估結果的詳細資料。
get_evaluation_run 取得指定評估執行的詳細資料。
list_evaluation_datasets 列出評估資料集。
list_evaluation_results 列出評估結果。
list_evaluation_runs 列出評估執行作業。
list_evaluations 列出評估項目。
update_evaluation 更新指定的評估作業。請務必在輸入內容中一律傳遞更新遮罩。
update_evaluation_dataset 更新指定的評估資料集。請務必在輸入內容中傳遞更新遮罩。
delete_evaluation_result 刪除指定的評估結果。
delete_evaluation_run 刪除指定的評估執行作業。
get_conversation 取得指定對話的詳細資料。
list_conversations 列出對話。
get_operation

取得長時間執行的作業狀態。

使用方式:部分工具 (例如 run_evaluation) 會傳回長時間執行的作業。您可以使用這項工具取得作業狀態。可以重複呼叫,輪詢長時間執行的作業狀態

參數 * name:要取得的作業名稱。 * name 應為啟動作業的工具傳回的名稱。* name 應採用 projects/{project}/locations/{location}/operations/{operation} 格式。

取得 MCP 工具規格

如要取得 MCP 伺服器中所有工具的 MCP 工具規格,請使用 tools/list 方法。以下範例說明如何使用 curl 列出 MCP 伺服器中目前可用的所有工具及其規格。

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
}'