Method: projects.locations.collections.dataConnector.invokeConnectorMcp

Führt einen Aufruf an einen MCP-Connector aus.

HTTP-Anfrage

:


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

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

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 beliebig formatierten params-Feld 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-Registrierungstools aufgerufen werden, die Anfragen an den Discovery Search Service senden.
toolSpecVersion

string

Optional. Die Tool-Spezifikationsversion, für die 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 Richtlinie 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 
{

  // 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.
}
Felder
Es sollte genau eines von result und error festgelegt sein. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
result

value (Value format)

Erfolgreiches Ergebnis – beliebige strukturierte Daten.
error

object (McpError)

Fehlerdetails, wenn der Aufruf fehlschlägt.
Ende der sich gegenseitig ausschließenden Felder.

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.