Method: projects.locations.collections.dataConnector.invokeConnectorMcp

Ruft einen MCP-Connector auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressource DataConnector.

Der Daten-Connector, der für den MCP-Aufruf verwendet wird.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
Felder
method

string

Erforderlich. Die aufzurufende Methode (z.B. „tools/list“, „tools/call“, „resources/read“, „prompts/get“ usw.).
params

object (Struct format)

Optional. Beliebige strukturierte Parameter für die Methode.

Durch die Verwendung von google.protobuf.Struct bleibt das Nutzlastschema flexibel und entspricht dem Freiformfeld params von JSON-RPC.
engine

string

Optional. Der Ressourcenname der Engine (z.B. „projects/{project}/locations/{location}/collections/{collection}/engines/{engine}“). Wird als Suchmaschinen-ID verwendet, wenn Tool-Registry-Tools aufgerufen werden, die Discovery Search Service-Anfragen senden.
toolSpecVersion

string

Optional. Die Tool-Spezifikationsversion, anhand der die Tool-Oberfläche des Connectors aufgelöst werden soll. Dies entspricht dem Dateinamen der BAP-Tool-Spezifikation des Connectors (z.B. „v2“, „v5.2“). Wenn diese Option nicht festgelegt ist, verwendet der Server die Standard-Tool-Spezifikation (die neueste) für den Connector. Gilt für alle Methoden, z.B. „tools/list“ und „tools/call“.

Antworttext

Antwortnachricht, die das Ergebnis eines MCP-Connector-Aufrufs zurückgibt. Sie enthält entweder eine Nutzlast mit einem erfolgreichen Ergebnis oder Fehlerdetails.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld payload. Es sollte genau eines von result und error festgelegt sein. Für payload ist nur einer der folgenden Werte zulässig:
result

value (Value format)

Erfolgreiches Ergebnis – beliebige strukturierte Daten.
error

object (McpError)

Fehlerdetails, wenn der Aufruf fehlschlägt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • discoveryengine.dataConnectors.executeAction

Weitere Informationen finden Sie in der IAM-Dokumentation.

McpError

McpError stellt Fehlerdetails dar, wenn ein MCP-Aufruf fehlschlägt. Diese Struktur entspricht dem JSON-RPC 2.0-Fehlerobjekt.

JSON-Darstellung 
{
  "code": integer,
  "message": string,
  "data": value
}
Felder
code

integer

Numerischer Fehlercode.
message

string

Kurze, menschenlesbare Beschreibung des Fehlers.
data

value (Value format)

Optionale strukturierte Daten mit zusätzlichem Fehlerkontext.