Method: projects.locations.collections.dataConnector.invokeConnectorMcp

Effettua una chiamata a un connettore MCP.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. DataConnector risorsa.

Il connettore dati utilizzato per effettuare la chiamata MCP.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
Campi
method

string

Obbligatorio. Il metodo da richiamare (ad es. "tools/list", "tools/call", "resources/read", "prompts/get" e così via).
params

object (Struct format)

Facoltativo. Parametri strutturati arbitrari per il metodo.

L'utilizzo di google.protobuf.Struct mantiene lo schema del payload flessibile, in linea con il campo params in formato libero di JSON-RPC.
engine

string

Facoltativo. Il nome risorsa del motore (ad es. "projects/{project}/locations/{location}/collections/{collection}/engines/{engine}"). Utilizzato come ID motore di ricerca quando vengono richiamati strumenti del registry che inviano richieste al servizio di ricerca Discovery.
toolSpecVersion

string

Facoltativo. La versione delle specifiche dello strumento rispetto alla quale risolvere la superficie dello strumento del connettore. Corrisponde al nome del file delle specifiche dello strumento BAP del connettore (ad es. "v2", "v5.2"). Se non viene impostata, il server utilizza la specifica dello strumento predefinita (più recente) per il connettore. Si applica a tutti i metodi (ad es. "tools/list" e "tools/call").

Corpo della risposta

Messaggio di risposta che restituisce il risultato di una chiamata al connettore MCP. Contiene il payload di un risultato riuscito o i dettagli dell'errore.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
Campo unione payload. Deve essere impostato esattamente uno dei due valori: result o error. payload può essere solo uno dei seguenti tipi:
result

value (Value format)

Risultato riuscito: dati strutturati arbitrari.
error

object (McpError)

Dettagli dell'errore in caso di chiamata non riuscita.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti 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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • discoveryengine.dataConnectors.executeAction

Per saperne di più, consulta la documentazione di IAM.

McpError

McpError rappresenta i dettagli dell'errore quando una chiamata MCP non va a buon fine. Questa struttura segue la forma dell'oggetto di errore JSON-RPC 2.0.

Rappresentazione JSON 
{
  "code": integer,
  "message": string,
  "data": value
}
Campi
code

integer

Codice di errore numerico.
message

string

Breve descrizione dell'errore leggibile.
data

value (Value format)

Dati strutturati facoltativi con contesto di errore aggiuntivo.