MCP Reference: ces.googleapis.com

שרת MCP ל-Gemini Enterprise for Customer Experience API

שרת Model Context Protocol‏ (MCP) פועל כשרת proxy בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.

הגדרת השרת

לפני שמשתמשים בשרתי MCP, צריך להפעיל אותם ולהגדיר אימות. מידע נוסף על שימוש בשרתי MCP מרוחקים של Google ו-Google Cloud זמין במאמר סקירה כללית על שרתי MCP של Google Cloud.

נקודות קצה של שרת

נקודת קצה של שירות MCP היא כתובת הרשת וממשק התקשורת (בדרך כלל כתובת URL) של שרת ה-MCP, שאפליקציית AI (המארח של לקוח ה-MCP) משתמשת בהם כדי ליצור חיבור מאובטח וסטנדרטי. הוא משמש כנקודת קשר למודל ה-LLM כדי לבקש הקשר, להפעיל כלי או לגשת למשאב. נקודות הקצה של Google MCP יכולות להיות גלובליות או אזוריות.

לשרת ה-MCP של Gemini Enterprise for Customer Experience API יש את נקודת הקצה הגלובלית הבאה של MCP:

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

כלי MCP

כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.

כלים

לשרת ה-MCP ‏ces.googleapis.com יש את הכלים הבאים:

כלי 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
}'