MCP Reference: ces.googleapis.com

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

伺服器設定

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

Gemini Enterprise for Customer Experience API 的 MCP 伺服器

伺服器端點

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

ces.googleapis.com MCP 伺服器具有下列 MCP 端點:

  • https://ces.[REGION].rep.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.[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
}'