REST Resource: projects.locations.apps.toolsets

리소스: Toolset

툴셋은 에이전트가 사용할 수 있는 동적으로 관리되는 도구 그룹을 나타냅니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "description": string,
  "timeout": string,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "executionType": enum (ExecutionType),
  "toolFakeConfig": {
    object (ToolFakeConfig)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "mcpToolset": {
    object (McpToolset)
  },
  "openApiToolset": {
    object (OpenApiToolset)
  },
  "connectorToolset": {
    object (ConnectorToolset)
  }
  // End of mutually exclusive fields.
}
필드
name

string

식별자. 툴셋의 고유 식별자입니다. 형식: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
displayName

string

(선택사항) 툴셋의 표시 이름입니다. 동일한 앱 내에서 고유해야 합니다.
description

string

(선택사항) 툴셋의 설명입니다.
timeout

string (Duration format)

(선택사항) 툴셋 실행 제한 시간입니다. 설정하지 않으면 SYNCHRONOUS 도구 모음의 기본 제한 시간은 30초이고 ASYNCHRONOUS 도구 모음의 기본 제한 시간은 60초입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
createTime

string (Timestamp format)

출력 전용입니다. 툴셋이 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 툴셋이 마지막으로 업데이트된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
etag

string

읽기-수정-쓰기 작업 중에 객체가 변경되지 않았는지 확인하는 데 사용되는 ETag입니다. etag가 비어 있으면 업데이트가 동시에 이루어진 변경사항을 덮어씁니다.
executionType

enum (ExecutionType)

(선택사항) 툴셋에 있는 도구의 실행 유형입니다.
toolFakeConfig

object (ToolFakeConfig)

(선택사항) 가짜 모드에서 도구 동작의 구성입니다.
툴셋의 유형입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
mcpToolset

object (McpToolset)

(선택사항) MCP 서버에서 제공하는 도구 목록이 포함된 도구 세트입니다.
openApiToolset

object (OpenApiToolset)

(선택사항) OpenAPI 스키마로 정의된 도구 목록이 포함된 도구 세트입니다.
connectorToolset

object (ConnectorToolset)

(선택사항) Integration Connectors 연결에서 도구를 생성하는 도구 모음입니다.
상호 배타적 필드의 끝입니다.

McpToolset

MCP 서버에서 제공하는 도구 목록이 포함된 도구 세트입니다.

JSON 표현 
{
  "serverAddress": string,
  "apiAuthentication": {
    object (ApiAuthentication)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "tlsConfig": {
    object (TlsConfig)
  },
  "customHeaders": {
    string: string,
    ...
  },
  "toolOverrides": [
    {
      object (McpToolOverride)
    }
  ]
}
필드
serverAddress

string

필수 항목입니다. MCP 서버의 주소입니다(예: 'https://example.com/mcp/'). 서버가 MCP SDK로 빌드된 경우 URL에 '/mcp/'가 접미사로 붙어야 합니다. 스트리밍 가능한 HTTP 전송 기반 서버만 지원됩니다. 자세한 내용은 https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http를 참고하세요.
apiAuthentication

object (ApiAuthentication)

(선택사항) 도구에 액세스하고 MCP 서버에 대해 도구를 실행하는 데 필요한 인증 정보입니다. 베어러 토큰 인증의 경우 토큰은 도구 실행에만 적용되며 도구 나열에는 적용되지 않습니다. 이를 위해서는 인증 없이 도구를 나열할 수 있어야 합니다.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

(선택사항) 경계 내에서 서비스 이름을 확인하는 데 사용되는 VPC-SC용 서비스 디렉터리 구성입니다.
tlsConfig

object (TlsConfig)

(선택사항) TLS 구성입니다. 클라이언트가 신뢰해야 하는 맞춤 서버 인증서가 포함됩니다.
customHeaders

map (key: string, value: string)

(선택사항) MCP 서버에 대한 요청에서 전송할 맞춤 헤더입니다. 값은 $context.variables.<name_of_variable> 형식이어야 하며 세션 변수에 설정할 수 있습니다. 자세한 내용은 https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection을 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
toolOverrides[]

object (McpToolOverride)

(선택사항) 이 도구 세트 내 개별 도구의 재정의입니다. 이를 통해 설명, 이름과 같은 특정 세부정보를 재정의하거나 도구의 상태를 고정하여 완전히 동적이지 않도록 할 수 있습니다.

McpToolOverride

툴셋의 특정 도구와 연결된 재정의입니다. 이를 통해 외부 동적 서버에서 도구 정의를 '고정'하거나 '재정의'할 수 있습니다.

JSON 표현 
{
  "tool": string,
  "nameOverride": string,
  "descriptionOverride": string,
  "snapshot": {
    object (McpToolDefinition)
  }
}
필드
tool

string

필수 항목입니다. MCP 서버에서 내보낸 도구의 원래 이름입니다.
nameOverride

string

(선택사항) 이름이 있으면 이 도구는 원래 이름 대신 상담사에서 이 이름을 사용합니다. 이는 MCP 서버에서 이름이 잘못 지정된 도구를 제공하는 경우 주로 별칭으로 사용됩니다.
descriptionOverride

string

(선택사항) 이 설명이 있으면 이 도구는 서버의 원래 설명 대신 이 설명을 사용합니다.
snapshot

object (McpToolDefinition)

출력 전용입니다. 이 도구가 있으면 '고정'되고 서버를 일시적으로 사용할 수 없거나 재정의가 없는 경우 스냅샷 값을 대체로 사용합니다.

McpToolDefinition

스냅샷이 생성된 도구의 핵심 정의 요소의 컨테이너입니다. 스냅샷의 스키마는 있는 그대로 사용되며 재정의할 수 없습니다.

JSON 표현 
{
  "description": string,
  "inputSchema": {
    object (Schema)
  },
  "outputSchema": {
    object (Schema)
  }
}
필드
description

string

출력 전용입니다. MCP 도구의 설명입니다. 이는 McpToolOverride의 descriptionOverride로 재정의될 수 있습니다.
inputSchema

object (Schema)

출력 전용입니다. MCP 도구의 입력 인수 스키마입니다.
outputSchema

object (Schema)

출력 전용입니다. MCP 도구의 출력 인수 스키마입니다.

OpenApiToolset

OpenAPI 스키마로 정의된 도구 목록이 포함된 도구 세트입니다.

JSON 표현 
{
  "openApiSchema": string,
  "apiAuthentication": {
    object (ApiAuthentication)
  },
  "tlsConfig": {
    object (TlsConfig)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "ignoreUnknownFields": boolean,
  "url": string
}
필드
openApiSchema

string

필수 항목입니다. 툴셋의 OpenAPI 스키마입니다.
apiAuthentication

object (ApiAuthentication)

(선택사항) API에 필요한 인증 정보입니다.
tlsConfig

object (TlsConfig)

(선택사항) TLS 구성입니다. 맞춤 서버 인증서를 포함합니다.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

(선택사항) 서비스 디렉터리 구성입니다.
ignoreUnknownFields

boolean

(선택사항) true인 경우 에이전트는 OpenAPI 스키마에 정의된 모든 작업의 API 응답에서 알 수 없는 필드를 무시합니다.
url

string

(선택사항) Open API 스키마의 서버 URL입니다. 이 필드는 스키마에 서버 URL이 포함된 경우 내보내기 프로세스 중에 환경 종속 항목의 툴셋에만 설정됩니다. 가져오기 프로세스 중에 이 URL이 환경 종속 항목에 있고 스키마에 $env_var 자리표시자가 있으면 스키마의 자리표시자를 대체합니다.

ConnectorToolset

Integration Connectors 연결에서 도구를 생성하는 도구 모음입니다.

JSON 표현 
{
  "connection": string,
  "authConfig": {
    object (EndUserAuthConfig)
  },
  "connectorActions": [
    {
      object (Action)
    }
  ]
}
필드
connection

string

필수 항목입니다. 참조된 Integration Connectors Connection의 전체 리소스 이름입니다. 형식: projects/{project}/locations/{location}/connections/{connection}
authConfig

object (EndUserAuthConfig)

(선택사항) Integration Connectors에서 인증이 처리되는 방식을 구성합니다. 기본적으로 관리자 인증은 Integration Connectors API 요청에 전달됩니다. 다른 최종 사용자 인증 구성으로 재정의할 수 있습니다. 참고: 여기에 EUC 구성을 지정하려면 연결에 인증 재정의가 사용 설정되어 있어야 합니다. 그렇지 않으면 도구 모음 생성이 실패합니다. 참고: https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override
connectorActions[]

object (Action)

필수 항목입니다. 도구를 생성할 커넥터 작업/엔티티 작업 목록입니다.

메서드

create

 지정된 앱에 새 도구 모음을 만듭니다.

delete

 지정된 도구 모음을 삭제합니다.

get

 지정된 도구 모음의 세부정보를 가져옵니다.

list

 지정된 앱의 툴셋을 나열합니다.

patch

 지정된 도구 모음을 업데이트합니다.

retrieveTools

 지정된 도구 모음에 포함된 도구 목록을 가져옵니다.