MCP Tools Reference: ces.googleapis.com

Alat: delete_agent

Menghapus agen yang ditentukan.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP delete_agent.

Permintaan Curl 
curl --location 'https://ces.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "delete_agent",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk AgentService.DeleteAgent.

DeleteAgentRequest

Representasi JSON 
{
  "name": string,
  "force": boolean,
  "etag": string
}
Kolom
name

string

Wajib diisi. Nama resource agen yang akan dihapus.
force

boolean

Opsional. Menunjukkan apakah akan menghapus agen secara paksa, meskipun masih direferensikan oleh aplikasi/agen/contoh lain.

  • Jika force = false, penghapusan akan gagal jika agen/contoh lain mereferensikannya.
  • Jika force = true, hapus agen dan hapus dari semua aplikasi/agen/contoh yang mereferensikannya.
etag

string

Opsional. Etag agen saat ini. Jika etag tidak diberikan, penghapusan akan menimpa perubahan serentak. Jika etag diberikan dan tidak cocok dengan etag agen saat ini, penghapusan akan diblokir dan error ABORTED akan ditampilkan.

Skema Output

Pesan kosong generik yang dapat Anda gunakan kembali untuk menghindari definisi pesan kosong duplikat di API Anda. Contoh umumnya adalah menggunakannya sebagai jenis permintaan atau respons dari metode API. Misalnya:

service Foo {
  rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
}

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar (true), alat tidak mengubah lingkungannya. Default: salah (false).
  • destructiveHint: Jika benar (true), alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: benar (true).
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: salah (false).
  • openWorldHint: Jika benar (true), alat dapat berinteraksi dengan 'dunia terbuka' dari entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi dunia terbuka, sedangkan alat memori tidak akan menjadi dunia terbuka.

Petunjuk Destruktif: ✅ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌