Method: projects.locations.collections.dataConnector.invokeConnectorMcp

ביצוע שיחה למחבר MCP.

בקשת HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector}:invokeConnectorMcp

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. DataConnector משאב.

מחבר הנתונים שמשמש ליצירת הקריאה ל-MCP.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
שדות
method

string

חובה. השיטה להפעלת הפונקציה (לדוגמה, tools/list,‏ tools/call,‏ resources/read,‏ prompts/get וכו').
params

object (Struct format)

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

השימוש ב-google.protobuf.Struct מאפשר לשמור על גמישות בסכימת המטען הייעודי (payload), בהתאם לשדה params החופשי של JSON-RPC.
engine

string

זה שינוי אופציונלי. שם המשאב של המנוע (למשל, projects/{project}/locations/{location}/collections/{collection}/engines/{engine}). משמש כמזהה מנוע החיפוש כשמפעילים כלים לרישום כלים ששולחים בקשות לשירות החיפוש של Discovery.
toolSpecVersion

string

זה שינוי אופציונלי. גרסת מפרט הכלי שמשמשת לפתרון בעיות בממשק הכלי של המחבר. הערך הזה תואם לשם הקובץ של מפרט כלי ה-BAP של המחבר (למשל, v2,‏ v5.2). אם לא מגדירים את המדיניות הזו, השרת משתמש במפרט ברירת המחדל (העדכני ביותר) של הכלי עבור המחבר. ההגדרה חלה על כל השיטות (לדוגמה, tools/list ו-tools/call).

גוף התשובה

הודעת תגובה שמחזירה את התוצאה של הפעלת מחבר MCP. הוא מכיל מטען ייעודי (payload) של תוצאה מוצלחת או פרטי שגיאה.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{

  // Union field payload can be only one of the following:
  "result": value,
  "error": {
    object (McpError)
  }
  // End of list of possible types for union field payload.
}
שדות
שדה איחוד payload. צריך להגדיר בדיוק אחד מהמאפיינים result או error. הערך payload יכול להיות רק אחד מהבאים:
result

value (Value format)

תוצאה מוצלחת – נתונים מובְנים שרירותיים.
error

object (McpError)

פרטי השגיאה אם השיחה נכשלת.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב name:

  • discoveryengine.dataConnectors.executeAction

מידע נוסף מופיע במאמרי העזרה בנושא IAM.

McpError

‫McpError מייצג פרטי שגיאה כשקריאת MCP נכשלת. המבנה הזה תואם לצורת אובייקט השגיאה של JSON-RPC 2.0.

ייצוג JSON 
{
  "code": integer,
  "message": string,
  "data": value
}
שדות
code

integer

קוד שגיאה מספרי.
message

string

תיאור קצר של השגיאה, שכתוב בצורה שקריאה לאנשים.
data

value (Value format)

נתונים מובְנים אופציונליים עם הקשר נוסף לשגיאה.