MCP Tools Reference: ces.googleapis.com

ツール: delete_agent

指定されたエージェントを削除します。

次のコードサンプルは、curl を使用して delete_agent MCP ツールを呼び出す方法を示しています。

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
}'

入力スキーマ

AgentService.DeleteAgent のリクエスト メッセージです。

DeleteAgentRequest

JSON 表現 
{
  "name": string,
  "force": boolean,
  "etag": string
}
フィールド
name

string

必須。削除するエージェントのリソース名。
force

boolean

省略可。他のアプリ、エージェント、例で参照されている場合でも、エージェントを強制的に削除するかどうかを示します。

  • force = false の場合、他のエージェントや例が参照していると削除は失敗します。
  • force = true の場合、エージェントを削除し、参照しているすべてのアプリ、エージェント、例から削除します。
etag

string

省略可。エージェントの現在の ETag。ETag が指定されていない場合、削除によって同時変更が上書きされます。指定された ETag がエージェントの現在の ETag と一致しない場合、削除することはできず、ABORTED エラーが返されます。

出力スキーマ

API で重複する空のメッセージを定義しないように再利用できる汎用の空のメッセージ。一般的な例としては、API メソッドのリクエスト タイプまたはレスポンス タイプとして使用することが挙げられます。次に例を示します。

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

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープン ワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ✅ | べき等ヒント: ❌ | 読み取り専用ヒント: ❌ | オープン ワールド ヒント: ❌