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인 경우 도구는 내부 엔티티와만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ✅ | 멱등성 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ❌