MCP Tools Reference: ces.googleapis.com

כלי: create_deployment

יצירת פריסה חדשה באפליקציה הנתונה.

בדוגמת הקוד הבאה מוצג שימוש בפקודה curl כדי להפעיל את הכלי create_deployment MCP.

בקשת Curl 
curl --location 'https://ces.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_deployment",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

בקשת הודעה עבור AgentService.CreateDeployment.

CreateDeploymentRequest

ייצוג ב-JSON 
{
  "parent": string,
  "deploymentId": string,
  "deployment": {
    object (Deployment)
  }
}
שדות
parent

string

חובה. האפליקציה הראשית. הפורמט: projects/{project}/locations/{location}/apps/{app}
deploymentId

string

זה שינוי אופציונלי. המזהה לשימוש בפריסה, שיהפוך לרכיב הסופי של שם המשאב של הפריסה. אם לא מציינים מזהה, המערכת מקצה מזהה ייחודי לפריסה באופן אוטומטי.
deployment

object (Deployment)

חובה. הפריסה שרוצים ליצור.

פריסה

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  },
  "whatsappCredentials": {
    object (WhatsAppCredentials)
  },
  "instagramCredentials": {
    object (InstagramCredentials)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "modality": enum (Modality),
  "agentRegistryDeployment": {
    object (AgentRegistryDeployment)
  }
}
שדות
name

string

מזהה. שם המשאב של הפריסה. פורמט: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

חובה. השם המוצג של הפריסה.
appVersion

string

זה שינוי אופציונלי. שם המשאב של גרסת האפליקציה שרוצים לפרוס. פורמט: projects/{project}/locations/{location}/apps/{app}/versions/{version} משתמשים ב-projects/{project}/locations/{location}/apps/{app}/versions/- כדי להשתמש באפליקציה בטיוטה.
channelProfile

object (ChannelProfile)

חובה. פרופיל הערוץ שבו נעשה שימוש בהטמעה.
createTime

string (Timestamp format)

פלט בלבד. חותמת זמן של מועד היצירה של הפריסה הזו.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון של הפריסה הזו.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
etag

string

פלט בלבד. תג Etag שמשמש כדי לוודא שהאובייקט לא השתנה במהלך פעולת קריאה-שינוי-כתיבה. אם ה-etag ריק, העדכון יחליף את כל השינויים המקבילים.
experimentConfig

object (ExperimentConfig)

זה שינוי אופציונלי. הגדרת הניסוי לפריסה.
whatsappCredentials

object (WhatsAppCredentials)

זה שינוי אופציונלי. קלט בלבד. כשמגדירים פרופיל של ערוץ וואטסאפ, צריך להזין פרטי כניסה זמניים לוואטסאפ.
instagramCredentials

object (InstagramCredentials)

זה שינוי אופציונלי. קלט בלבד. כשמגדירים פרופיל ערוץ באינסטגרם, צריך להזין פרטי כניסה זמניים לאינסטגרם.
modelSettings

object (ModelSettings)

זה שינוי אופציונלי. הגדרות המודל לפריסה. ההגדרה הזו מחליפה את הגדרות המודל שהוגדרו ברמת האפליקציה או הסוכן. הערה: כדי לבטל את הגדרות המודל ברמת הפריסה, צריך להיות ברשימת ההיתרים. כדי להפעיל את השדה הזה, צריך לפנות לצוות CXAS.
modality

enum (Modality)

זה שינוי אופציונלי. אופן הפריסה. הערה: כדי להשתמש בהחלפת מודאליות ברמת הפריסה, צריך להיות ברשימת ההיתרים. כדי להפעיל את השדה הזה, צריך לפנות לצוות CXAS.
agentRegistryDeployment

object (AgentRegistryDeployment)

זה שינוי אופציונלי. הגדרה לפריסת הפריסה הזו ב-Agent Registry. אם יש פריסה כזו, היא תפורסם ב-Agent Registry.

ChannelProfile

ייצוג ב-JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "whatsappConfig": {
    object (WhatsAppConfig)
  },
  "instagramConfig": {
    object (InstagramConfig)
  },

  // Union field _disable_dtmf can be only one of the following:
  "disableDtmf": boolean
  // End of list of possible types for union field _disable_dtmf.

  // Union field _disable_barge_in_control can be only one of the following:
  "disableBargeInControl": boolean
  // End of list of possible types for union field _disable_barge_in_control.

  // Union field _noise_suppression_level can be only one of the following:
  "noiseSuppressionLevel": string
  // End of list of possible types for union field _noise_suppression_level.
}
שדות
profileId

string

זה שינוי אופציונלי. המזהה הייחודי של פרופיל הערוץ.
channelType

enum (ChannelType)

זה שינוי אופציונלי. סוג פרופיל הערוץ.
personaProperty

object (PersonaProperty)

זה שינוי אופציונלי. מאפיין האישיות של פרופיל הערוץ.
webWidgetConfig

object (WebWidgetConfig)

זה שינוי אופציונלי. ההגדרה של הווידג'ט לאתר.
whatsappConfig

object (WhatsAppConfig)

זה שינוי אופציונלי. הגדרה ספציפית לפריסות בוואטסאפ.
instagramConfig

object (InstagramConfig)

זה שינוי אופציונלי. הגדרה ספציפית לפריסות באינסטגרם.

שדה איחוד _disable_dtmf.

הערך _disable_dtmf יכול להיות רק אחד מהבאים:
disableDtmf

boolean

זה שינוי אופציונלי. האם להשבית את DTMF (חיוג רב-תדרים).

שדה איחוד _disable_barge_in_control.

הערך _disable_barge_in_control יכול להיות רק אחד מהבאים:
disableBargeInControl

boolean

זה שינוי אופציונלי. האם להשבית את השליטה של המשתמשים בהצטרפות לשיחה. ‫- true: המשתמש לא יכול להפריע בזמן שהסוכן מדבר. ‫- false: הסוכן שומר על שליטה אוטומטית לגבי מתי המשתמש יכול להפריע.

שדה איחוד _noise_suppression_level.

הערך _noise_suppression_level יכול להיות רק אחד מהבאים:
noiseSuppressionLevel

string

זה שינוי אופציונלי. רמת ביטול הרעשים בפרופיל הערוץ. הערכים האפשריים הם low,‏ moderate,‏ high,‏ very_high.

PersonaProperty

ייצוג ב-JSON 
{
  "persona": enum (Persona)
}
שדות
persona

enum (Persona)

זה שינוי אופציונלי. הפרסונה של הערוץ.

WebWidgetConfig

ייצוג ב-JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
שדות
modality

enum (Modality)

זה שינוי אופציונלי. האופן שבו הווידג'ט מוצג באתר.
theme

enum (Theme)

זה שינוי אופציונלי. העיצוב של הווידג'ט לאתר.
webWidgetTitle

string

זה שינוי אופציונלי. השם של הווידג'ט לאתר.
securitySettings

object (SecuritySettings)

זה שינוי אופציונלי. הגדרות האבטחה של הווידג'ט לאינטרנט.

SecuritySettings

ייצוג ב-JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
שדות
enablePublicAccess

boolean

זה שינוי אופציונלי. מציין אם הגישה הציבורית לווידג'ט האינטרנט מופעלת. אם הערך הוא true, הווידג'ט לאתר יהיה נגיש לכולם. אם false, צריך לשלב את הווידג'ט לאינטרנט עם מערכת האימות וההרשאה שלכם כדי לקבל פרטי כניסה תקפים לגישה לסוכן CES.
enableOriginCheck

boolean

זה שינוי אופציונלי. המדיניות הזו מציינת אם בדיקת המקור של הווידג'ט לאתר מופעלת. אם הערך הוא true, הווידג'ט לאתר יבדוק את המקור של האתר שטוען את הווידג'ט לאתר, ויאפשר את הטעינה שלו רק באותו מקור או בכל אחד מהמקורות המותרים.
allowedOrigins[]

string

זה שינוי אופציונלי. המקורות שיכולים לארח את הווידג'ט לאינטרנט. מקור מוגדר על ידי RFC 6454. אם לא תציינו ערך בשדה הזה, כל המקורות יהיו מותרים. אפשר להוסיף עד 100 מקורות. דוגמה: "https://example.com"
enableRecaptcha

boolean

זה שינוי אופציונלי. התנאי מציין אם אימות מסוג reCAPTCHA של הווידג'ט לאתר מופעל.

WhatsAppConfig

ייצוג ב-JSON 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
שדות
wabaId

string

חובה. מספר החשבון ב-WhatsApp Business.
phoneNumberId

string

חובה. מזהה מספר הטלפון של Meta.
phoneNumber

string

זה שינוי אופציונלי. מספר הטלפון בפורמט E.164.
displayName

string

פלט בלבד. השם של הדף העסקי ב-מטא שאוחזר.
thumbnailUrl

string

פלט בלבד. כתובת ה-URL של התמונה הממוזערת של פרופיל העסק ב-Meta שאותרה.
description

string

פלט בלבד. התיאור של הדף או הפרופיל העסקי במטא.

InstagramConfig

ייצוג ב-JSON 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
שדות
instagramAccountId

string

חובה. מזהה החשבון באינסטגרם.
displayName

string

פלט בלבד. השם של הדף העסקי ב-מטא שאוחזר.
thumbnailUrl

string

פלט בלבד. כתובת ה-URL של התמונה הממוזערת של פרופיל העסק ב-Meta שאותרה.
description

string

פלט בלבד. התיאור של הדף או הפרופיל העסקי במטא.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך צריך להיות בין ‎-62135596800 ל-253402300799 כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

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

ExperimentConfig

ייצוג ב-JSON 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
שדות
versionRelease

object (VersionRelease)

זה שינוי אופציונלי. גרסת הפרסום של הניסוי.

VersionRelease

ייצוג ב-JSON 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
שדות
state

enum (State)

זה שינוי אופציונלי. המצב של פרסום הגרסה.
trafficAllocations[]

object (TrafficAllocation)

זה שינוי אופציונלי. הקצאות תנועה לגרסת ההפצה.

TrafficAllocation

ייצוג ב-JSON 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
שדות
id

string

זה שינוי אופציונלי. המזהה של הקצאת התנועה. מחרוזת בפורמט חופשי, עד 128 תווים.
trafficPercentage

integer

זה שינוי אופציונלי. אחוז התנועה בהקצאת התנועה. הערך צריך להיות בין 0 ל-100.
appVersion

string

זה שינוי אופציונלי. גרסת האפליקציה של הקצאת התנועה. פורמט: projects/{project}/locations/{location}/apps/{app}/versions/{version}

WhatsAppCredentials

ייצוג ב-JSON 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
שדות
authCode

string

חובה. קוד האימות של Meta שמופיע בתהליך ההרשמה המוטמע.
pin

string

חובה. קוד האימות בן 6 הספרות שנוצר על ידי המשתמש לאימות דו-שלבי.
phoneNumber

string

חובה. מספר הטלפון שרוצים להירשם איתו לוואטסאפ.
businessAccountId

string

חובה. מזהה החשבון העסקי שבו יש להשתמש עבור מספר הטלפון.
wabaId

string

חובה. מספר החשבון ב-WhatsApp Business.
conversationProfileId

string

זה שינוי אופציונלי. מזהה פרופיל השיחה שבו רוצים להשתמש לפריסה.

InstagramCredentials

ייצוג ב-JSON 
{
  "authCode": string,
  "conversationProfileId": string
}
שדות
authCode

string

חובה. קוד האימות של Meta שמופיע בתהליך ההרשמה המוטמע.
conversationProfileId

string

זה שינוי אופציונלי. מזהה פרופיל השיחה שבו רוצים להשתמש לפריסה.

ModelSettings

ייצוג ב-JSON 
{
  "model": string,
  "thinkingLevel": enum (ThinkingLevel),

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
שדות
model

string

זה שינוי אופציונלי. מודל ה-LLM שהסוכן צריך להשתמש בו. אם לא מגדירים מודל, הסוכן יקבל בירושה את המודל מהסוכן הראשי שלו.
thinkingLevel

enum (ThinkingLevel)

זה שינוי אופציונלי. רמת ההעמקה של המודל.

שדה איחוד _temperature.

הערך _temperature יכול להיות רק אחד מהבאים:
temperature

number

זה שינוי אופציונלי. אם המדיניות הזו מוגדרת, רמת האקראיות הזו תשמש את מודל ה-LLM. רמת האקראיות קובעת את רמת הרנדומיזציה של התשובות של המודל. טמפרטורות נמוכות יותר מפיקות תשובות צפויות יותר. טמפרטורות גבוהות יותר יוצרות תשובות יצירתיות יותר.

AgentRegistryDeployment

ייצוג ב-JSON 
{
  "agentRegistryServiceName": string
}
שדות
agentRegistryServiceName

string

זה שינוי אופציונלי. פלט בלבד. שם המשאב של שירות Agent Registry שנפרס. פורמט: projects/{project}/locations/{location}/services/{service}

ChannelType

סוג פרופיל הערוץ.

טיפוסים בני מנייה (enum)
UNKNOWN סוג הערוץ לא ידוע.
WEB_UI ערוץ בממשק המשתמש האינטרנטי.
API ערוץ API.
TWILIO ערוץ Twilio.
GOOGLE_TELEPHONY_PLATFORM ערוץ פלטפורמת הטלפוניה של Google.
CONTACT_CENTER_AS_A_SERVICE ערוץ Contact Center as a Service (CCaaS).
CONTACT_CENTER_AS_A_SERVICE_CHAT ערוץ Contact Center as a Service (CCaaS Chat).
FIVE9 ערוץ Five9.
CONTACT_CENTER_INTEGRATION ערוץ שילוב של מרכז תמיכה של צד שלישי.
WHATSAPP ערוץ וואטסאפ.
INSTAGRAM ערוץ באינסטגרם.

פרסונה

הפרסונה של הערוץ.

טיפוסים בני מנייה (enum)
UNKNOWN פרסונה לא ידועה.
CONCISE הסוכן שומר על תשובות תמציתיות וענייניות
CHATTY הסוכן מספק הקשר, הסברים ופרטים נוספים

מודליות

האופן שבו הווידג'ט מוצג באתר.

טיפוסים בני מנייה (enum)
MODALITY_UNSPECIFIED אמצעי לא ידוע.
CHAT_AND_VOICE הווידג'ט תומך גם בצ'אט וגם בקלט קולי.
VOICE_ONLY בווידג'ט יש תמיכה רק בקלט קולי.
CHAT_ONLY הווידג'ט תומך רק בהזנת צ'אט.
CHAT_VOICE_AND_VIDEO הווידג'ט תומך בקלט של צ'אט, קול ווידאו.

עיצוב

העיצוב של הווידג'ט לאתר.

טיפוסים בני מנייה (enum)
THEME_UNSPECIFIED עיצוב לא ידוע.
LIGHT עיצוב בהיר.
DARK עיצוב כהה.

מדינה

מצב הניסוי.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED מצב לא מוגדר.
PENDING הוצא משימוש: המצב הזה כבר לא בשימוש.
RUNNING מצב הפעלה. הניסוי פועל ותקף.
DONE הוצא משימוש: המצב הזה כבר לא בשימוש.
EXPIRED הוצא משימוש: המצב הזה כבר לא בשימוש.

ThinkingLevel

הגדרת רמת החשיבה של המודל.

טיפוסים בני מנייה (enum)
THINKING_LEVEL_UNSPECIFIED לא צוינה רמת ההעמקה.
DEFAULT רמת ההעמקה שמוגדרת כברירת מחדל.
LOW רמת העמקה נמוכה.
MEDIUM רמת העמקה בינונית.
HIGH רמת העמקה גבוהה.

מודליות

אופן הפריסה.

טיפוסים בני מנייה (enum)
MODALITY_UNSPECIFIED אמצעי לא ידוע.
MODALITY_TEXT אופן הצגת הטקסט.
MODALITY_VOICE אמצעי תקשורת קולי.
MODALITY_VIDEO שיטת הצגת הסרטון.

סכימת הפלט

פריסה מייצגת גרסה של האפליקציה שלא ניתן לשנות, שאפשר להריץ עליה שאילתות. היא משמשת לפריסת גרסה של האפליקציה עם פרופיל ערוץ ספציפי.

פריסה

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  },
  "whatsappCredentials": {
    object (WhatsAppCredentials)
  },
  "instagramCredentials": {
    object (InstagramCredentials)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "modality": enum (Modality),
  "agentRegistryDeployment": {
    object (AgentRegistryDeployment)
  }
}
שדות
name

string

מזהה. שם המשאב של הפריסה. פורמט: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

חובה. השם המוצג של הפריסה.
appVersion

string

זה שינוי אופציונלי. שם המשאב של גרסת האפליקציה שרוצים לפרוס. פורמט: projects/{project}/locations/{location}/apps/{app}/versions/{version} משתמשים ב-projects/{project}/locations/{location}/apps/{app}/versions/- כדי להשתמש באפליקציה בטיוטה.
channelProfile

object (ChannelProfile)

חובה. פרופיל הערוץ שבו נעשה שימוש בהטמעה.
createTime

string (Timestamp format)

פלט בלבד. חותמת זמן של מועד היצירה של הפריסה הזו.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון של הפריסה הזו.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
etag

string

פלט בלבד. תג Etag שמשמש כדי לוודא שהאובייקט לא השתנה במהלך פעולת קריאה-שינוי-כתיבה. אם ה-etag ריק, העדכון יחליף את כל השינויים המקבילים.
experimentConfig

object (ExperimentConfig)

זה שינוי אופציונלי. הגדרת הניסוי לפריסה.
whatsappCredentials

object (WhatsAppCredentials)

זה שינוי אופציונלי. קלט בלבד. כשמגדירים פרופיל של ערוץ וואטסאפ, צריך להזין פרטי כניסה זמניים לוואטסאפ.
instagramCredentials

object (InstagramCredentials)

זה שינוי אופציונלי. קלט בלבד. כשמגדירים פרופיל ערוץ באינסטגרם, צריך להזין פרטי כניסה זמניים לאינסטגרם.
modelSettings

object (ModelSettings)

זה שינוי אופציונלי. הגדרות המודל לפריסה. ההגדרה הזו מחליפה את הגדרות המודל שהוגדרו ברמת האפליקציה או הסוכן. הערה: כדי לבטל את הגדרות המודל ברמת הפריסה, צריך להיות ברשימת ההיתרים. כדי להפעיל את השדה הזה, צריך לפנות לצוות CXAS.
modality

enum (Modality)

זה שינוי אופציונלי. אופן הפריסה. הערה: כדי להשתמש בהחלפת מודאליות ברמת הפריסה, צריך להיות ברשימת ההיתרים. כדי להפעיל את השדה הזה, צריך לפנות לצוות CXAS.
agentRegistryDeployment

object (AgentRegistryDeployment)

זה שינוי אופציונלי. הגדרה לפריסת הפריסה הזו ב-Agent Registry. אם יש פריסה כזו, היא תפורסם ב-Agent Registry.

ChannelProfile

ייצוג ב-JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "whatsappConfig": {
    object (WhatsAppConfig)
  },
  "instagramConfig": {
    object (InstagramConfig)
  },

  // Union field _disable_dtmf can be only one of the following:
  "disableDtmf": boolean
  // End of list of possible types for union field _disable_dtmf.

  // Union field _disable_barge_in_control can be only one of the following:
  "disableBargeInControl": boolean
  // End of list of possible types for union field _disable_barge_in_control.

  // Union field _noise_suppression_level can be only one of the following:
  "noiseSuppressionLevel": string
  // End of list of possible types for union field _noise_suppression_level.
}
שדות
profileId

string

זה שינוי אופציונלי. המזהה הייחודי של פרופיל הערוץ.
channelType

enum (ChannelType)

זה שינוי אופציונלי. סוג פרופיל הערוץ.
personaProperty

object (PersonaProperty)

זה שינוי אופציונלי. מאפיין האישיות של פרופיל הערוץ.
webWidgetConfig

object (WebWidgetConfig)

זה שינוי אופציונלי. ההגדרה של הווידג'ט לאתר.
whatsappConfig

object (WhatsAppConfig)

זה שינוי אופציונלי. הגדרה ספציפית לפריסות בוואטסאפ.
instagramConfig

object (InstagramConfig)

זה שינוי אופציונלי. הגדרה ספציפית לפריסות באינסטגרם.

שדה איחוד _disable_dtmf.

הערך _disable_dtmf יכול להיות רק אחד מהבאים:
disableDtmf

boolean

זה שינוי אופציונלי. האם להשבית את DTMF (חיוג רב-תדרים).

שדה איחוד _disable_barge_in_control.

הערך _disable_barge_in_control יכול להיות רק אחד מהבאים:
disableBargeInControl

boolean

זה שינוי אופציונלי. האם להשבית את השליטה של המשתמשים בהצטרפות לשיחה. ‫- true: המשתמש לא יכול להפריע בזמן שהסוכן מדבר. ‫- false: הסוכן שומר על שליטה אוטומטית לגבי מתי המשתמש יכול להפריע.

שדה איחוד _noise_suppression_level.

הערך _noise_suppression_level יכול להיות רק אחד מהבאים:
noiseSuppressionLevel

string

זה שינוי אופציונלי. רמת ביטול הרעשים בפרופיל הערוץ. הערכים האפשריים הם low,‏ moderate,‏ high,‏ very_high.

PersonaProperty

ייצוג ב-JSON 
{
  "persona": enum (Persona)
}
שדות
persona

enum (Persona)

זה שינוי אופציונלי. הפרסונה של הערוץ.

WebWidgetConfig

ייצוג ב-JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
שדות
modality

enum (Modality)

זה שינוי אופציונלי. האופן שבו הווידג'ט מוצג באתר.
theme

enum (Theme)

זה שינוי אופציונלי. העיצוב של הווידג'ט לאתר.
webWidgetTitle

string

זה שינוי אופציונלי. השם של הווידג'ט לאתר.
securitySettings

object (SecuritySettings)

זה שינוי אופציונלי. הגדרות האבטחה של הווידג'ט לאינטרנט.

SecuritySettings

ייצוג ב-JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
שדות
enablePublicAccess

boolean

זה שינוי אופציונלי. מציין אם הגישה הציבורית לווידג'ט האינטרנט מופעלת. אם הערך הוא true, הווידג'ט לאתר יהיה נגיש לכולם. אם false, צריך לשלב את הווידג'ט לאינטרנט עם מערכת האימות וההרשאה שלכם כדי לקבל פרטי כניסה תקפים לגישה לסוכן CES.
enableOriginCheck

boolean

זה שינוי אופציונלי. המדיניות הזו מציינת אם בדיקת המקור של הווידג'ט לאתר מופעלת. אם הערך הוא true, הווידג'ט לאתר יבדוק את המקור של האתר שטוען את הווידג'ט לאתר, ויאפשר את הטעינה שלו רק באותו מקור או בכל אחד מהמקורות המותרים.
allowedOrigins[]

string

זה שינוי אופציונלי. המקורות שיכולים לארח את הווידג'ט לאינטרנט. מקור מוגדר על ידי RFC 6454. אם לא תציינו ערך בשדה הזה, כל המקורות יהיו מותרים. אפשר להוסיף עד 100 מקורות. דוגמה: "https://example.com"
enableRecaptcha

boolean

זה שינוי אופציונלי. התנאי מציין אם אימות מסוג reCAPTCHA של הווידג'ט לאתר מופעל.

WhatsAppConfig

ייצוג ב-JSON 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
שדות
wabaId

string

חובה. מספר החשבון ב-WhatsApp Business.
phoneNumberId

string

חובה. מזהה מספר הטלפון של Meta.
phoneNumber

string

זה שינוי אופציונלי. מספר הטלפון בפורמט E.164.
displayName

string

פלט בלבד. השם של הדף העסקי ב-מטא שאוחזר.
thumbnailUrl

string

פלט בלבד. כתובת ה-URL של התמונה הממוזערת של פרופיל העסק ב-Meta שאותרה.
description

string

פלט בלבד. התיאור של הדף או הפרופיל העסקי במטא.

InstagramConfig

ייצוג ב-JSON 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
שדות
instagramAccountId

string

חובה. מזהה החשבון באינסטגרם.
displayName

string

פלט בלבד. השם של הדף העסקי ב-מטא שאוחזר.
thumbnailUrl

string

פלט בלבד. כתובת ה-URL של התמונה הממוזערת של פרופיל העסק ב-Meta שאותרה.
description

string

פלט בלבד. התיאור של הדף או הפרופיל העסקי במטא.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך צריך להיות בין ‎-62135596800 ל-253402300799 כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

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

ExperimentConfig

ייצוג ב-JSON 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
שדות
versionRelease

object (VersionRelease)

זה שינוי אופציונלי. גרסת הפרסום של הניסוי.

VersionRelease

ייצוג ב-JSON 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
שדות
state

enum (State)

זה שינוי אופציונלי. המצב של פרסום הגרסה.
trafficAllocations[]

object (TrafficAllocation)

זה שינוי אופציונלי. הקצאות תנועה לגרסת ההפצה.

TrafficAllocation

ייצוג ב-JSON 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
שדות
id

string

זה שינוי אופציונלי. המזהה של הקצאת התנועה. מחרוזת בפורמט חופשי, עד 128 תווים.
trafficPercentage

integer

זה שינוי אופציונלי. אחוז התנועה בהקצאת התנועה. הערך צריך להיות בין 0 ל-100.
appVersion

string

זה שינוי אופציונלי. גרסת האפליקציה של הקצאת התנועה. פורמט: projects/{project}/locations/{location}/apps/{app}/versions/{version}

WhatsAppCredentials

ייצוג ב-JSON 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
שדות
authCode

string

חובה. קוד האימות של Meta שמופיע בתהליך ההרשמה המוטמע.
pin

string

חובה. קוד האימות בן 6 הספרות שנוצר על ידי המשתמש לאימות דו-שלבי.
phoneNumber

string

חובה. מספר הטלפון שרוצים להירשם איתו לוואטסאפ.
businessAccountId

string

חובה. מזהה החשבון העסקי שבו יש להשתמש עבור מספר הטלפון.
wabaId

string

חובה. מספר החשבון ב-WhatsApp Business.
conversationProfileId

string

זה שינוי אופציונלי. מזהה פרופיל השיחה שבו רוצים להשתמש לפריסה.

InstagramCredentials

ייצוג ב-JSON 
{
  "authCode": string,
  "conversationProfileId": string
}
שדות
authCode

string

חובה. קוד האימות של Meta שמופיע בתהליך ההרשמה המוטמע.
conversationProfileId

string

זה שינוי אופציונלי. מזהה פרופיל השיחה שבו רוצים להשתמש לפריסה.

ModelSettings

ייצוג ב-JSON 
{
  "model": string,
  "thinkingLevel": enum (ThinkingLevel),

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
שדות
model

string

זה שינוי אופציונלי. מודל ה-LLM שהסוכן צריך להשתמש בו. אם לא מגדירים מודל, הסוכן יקבל בירושה את המודל מהסוכן הראשי שלו.
thinkingLevel

enum (ThinkingLevel)

זה שינוי אופציונלי. רמת ההעמקה של המודל.

שדה איחוד _temperature.

הערך _temperature יכול להיות רק אחד מהבאים:
temperature

number

זה שינוי אופציונלי. אם המדיניות הזו מוגדרת, רמת האקראיות הזו תשמש את מודל ה-LLM. רמת האקראיות קובעת את רמת הרנדומיזציה של התשובות של המודל. טמפרטורות נמוכות יותר מפיקות תשובות צפויות יותר. טמפרטורות גבוהות יותר יוצרות תשובות יצירתיות יותר.

AgentRegistryDeployment

ייצוג ב-JSON 
{
  "agentRegistryServiceName": string
}
שדות
agentRegistryServiceName

string

זה שינוי אופציונלי. פלט בלבד. שם המשאב של שירות Agent Registry שנפרס. פורמט: projects/{project}/locations/{location}/services/{service}

ChannelType

סוג פרופיל הערוץ.

טיפוסים בני מנייה (enum)
UNKNOWN סוג הערוץ לא ידוע.
WEB_UI ערוץ בממשק המשתמש האינטרנטי.
API ערוץ API.
TWILIO ערוץ Twilio.
GOOGLE_TELEPHONY_PLATFORM ערוץ פלטפורמת הטלפוניה של Google.
CONTACT_CENTER_AS_A_SERVICE ערוץ Contact Center as a Service (CCaaS).
CONTACT_CENTER_AS_A_SERVICE_CHAT ערוץ Contact Center as a Service (CCaaS Chat).
FIVE9 ערוץ Five9.
CONTACT_CENTER_INTEGRATION ערוץ שילוב של מרכז תמיכה של צד שלישי.
WHATSAPP ערוץ וואטסאפ.
INSTAGRAM ערוץ באינסטגרם.

פרסונה

הפרסונה של הערוץ.

טיפוסים בני מנייה (enum)
UNKNOWN פרסונה לא ידועה.
CONCISE הסוכן שומר על תשובות תמציתיות וענייניות
CHATTY הסוכן מספק הקשר, הסברים ופרטים נוספים

מודליות

האופן שבו הווידג'ט מוצג באתר.

טיפוסים בני מנייה (enum)
MODALITY_UNSPECIFIED אמצעי לא ידוע.
CHAT_AND_VOICE הווידג'ט תומך גם בצ'אט וגם בקלט קולי.
VOICE_ONLY בווידג'ט יש תמיכה רק בקלט קולי.
CHAT_ONLY הווידג'ט תומך רק בהזנת צ'אט.
CHAT_VOICE_AND_VIDEO הווידג'ט תומך בקלט של צ'אט, קול ווידאו.

עיצוב

העיצוב של הווידג'ט לאתר.

טיפוסים בני מנייה (enum)
THEME_UNSPECIFIED עיצוב לא ידוע.
LIGHT עיצוב בהיר.
DARK עיצוב כהה.

מדינה

מצב הניסוי.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED מצב לא מוגדר.
PENDING הוצא משימוש: המצב הזה כבר לא בשימוש.
RUNNING מצב הפעלה. הניסוי פועל ותקף.
DONE הוצא משימוש: המצב הזה כבר לא בשימוש.
EXPIRED הוצא משימוש: המצב הזה כבר לא בשימוש.

ThinkingLevel

הגדרת רמת החשיבה של המודל.

טיפוסים בני מנייה (enum)
THINKING_LEVEL_UNSPECIFIED לא צוינה רמת ההעמקה.
DEFAULT רמת ההעמקה שמוגדרת כברירת מחדל.
LOW רמת העמקה נמוכה.
MEDIUM רמת העמקה בינונית.
HIGH רמת העמקה גבוהה.

מודליות

אופן הפריסה.

טיפוסים בני מנייה (enum)
MODALITY_UNSPECIFIED אמצעי לא ידוע.
MODALITY_TEXT אופן הצגת הטקסט.
MODALITY_VOICE אמצעי תקשורת קולי.
MODALITY_VIDEO שיטת הצגת הסרטון.

הערות בכלי

הערות על כלי נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כאל רמזים לא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש הנחיה לאישור.

בנוסף למחרוזת הכותרת, מוגדרים הרמזים הבוליאניים הבאים:

  • ‫readOnlyHint: אם הערך הוא true, הכלי לא משנה את הסביבה שלו. ברירת מחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא false, הכלי יכול לבצע רק פעולות של הוספה. ברירת מחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת מחדל: false.
  • ‫openWorldHint: אם הערך הוא true, הכלי יכול ליצור אינטראקציה עם 'עולם פתוח' של ישויות חיצוניות. אם הערך הוא false, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

רמז הרסני: ✅ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ❌ | רמז לעולם פתוח: ❌