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 ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. DataConnector resource.

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. Metode yang akan dipanggil (misalnya, "tools/list", "tools/call", "resources/read", "prompts/get", dll.).
params

object (Struct format)

Opsional. Parameter terstruktur arbitrer untuk metode.

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

string

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

string

Opsional. Versi spesifikasi alat untuk menyelesaikan permukaan alat konektor. 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. Respons ini berisi payload hasil yang berhasil atau detail error.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
Tepatnya salah satu dari result atau error yang harus ditetapkan. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
result

value (Value format)

Hasil yang berhasil — data terstruktur arbitrer.
error

object (McpError)

Detail error saat panggilan gagal.
Akhir kolom yang saling eksklusif.

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 merepresentasikan 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 singkat error yang dapat dibaca manusia.
data

value (Value format)

Data terstruktur opsional dengan konteks error tambahan.