Method: projects.locations.collections.dataConnector.invokeConnectorMcp

Melakukan panggilan ke konektor MCP.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib diisi. Resource DataConnector.

Konektor data yang digunakan untuk melakukan panggilan MCP.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
Kolom
method

string

Wajib diisi. Metode yang akan dipanggil (misalnya, "tools/list", "tools/call", "resources/read", "prompts/get", dll.).
params

object (Struct format)

Opsional. Parameter terstruktur arbitrer untuk metode ini.

Menggunakan google.protobuf.Struct membuat skema payload fleksibel, yang cocok dengan kolom params bentuk bebas JSON-RPC.
engine

string

Opsional. Nama resource mesin (misalnya, "projects/{project}/locations/{location}/collections/{collection}/engines/{engine}"). Digunakan sebagai ID mesin penelusuran saat memanggil alat registry alat yang mengeluarkan permintaan Discovery Search Service.
toolSpecVersion

string

Opsional. Versi spesifikasi alat untuk menyelesaikan platform alat konektor. Hal ini sesuai dengan nama file spesifikasi alat BAP konektor (misalnya, "v2", "v5.2"). Jika tidak ditetapkan, server akan menggunakan spesifikasi alat default (terbaru) untuk konektor. Berlaku untuk semua metode (misalnya, "tools/list" dan "tools/call").

Isi respons

Pesan respons yang menampilkan hasil pemanggilan konektor MCP. Pesan ini berisi payload hasil yang berhasil atau detail error.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
Kolom union payload. Tepat satu dari result atau error harus ditetapkan. payload hanya dapat berupa salah satu dari berikut:
result

value (Value format)

Hasil yang berhasil — data terstruktur arbitrer.
error

object (McpError)

Detail error saat panggilan gagal.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • discoveryengine.dataConnectors.executeAction

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.

McpError

McpError mewakili detail error saat panggilan MCP gagal. Struktur ini mengikuti bentuk objek error JSON-RPC 2.0.

Representasi JSON 
{
  "code": integer,
  "message": string,
  "data": value
}
Kolom
code

integer

Kode error numerik.
message

string

Deskripsi error yang singkat dan mudah dibaca.
data

value (Value format)

Data terstruktur opsional dengan konteks error tambahan.