שרת 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 |
אחזור הסטטוס של פעולה ממושכת. שימוש חלק מהכלים (לדוגמה, פרמטרים * |
קבלת מפרטים של כלי ה-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 }' |