Method: projects.locations.collections.dataConnector.invokeConnectorMcp

Chiama un connettore MCP.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. risorsa DataConnector.

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 di registrazione degli strumenti che emettono richieste del 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 un payload di risultati riusciti o i dettagli dell'errore.

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

Rappresentazione 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.
}
Campi
Deve essere impostato esattamente uno dei due valori: result o error. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
result

value (Value format)

Risultato riuscito: dati strutturati arbitrari.
error

object (McpError)

Dettagli dell'errore quando la chiamata non va a buon fine.
Fine dei campi che si escludono a vicenda.

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.