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 resource.

מחבר הנתונים שמשמש ליצירת קריאת ה-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}). משמש כמזהה מנוע החיפוש כשמפעילים כלים לרישום כלים ששולחים בקשות לשירותי החיפוש של Google של Discovery.
toolSpecVersion

string

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

גוף התשובה

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

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

ייצוג ב-JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "result": value,
  "error": {
    object (McpError)
  }
  // End of mutually exclusive fields.
}
שדות
צריך להגדיר בדיוק אחד מהערכים result או error. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
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)

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