REST Resource: projects.locations.apps.toolsets

Recurso: Toolset

Un conjunto de herramientas representa un grupo de herramientas administradas de forma dinámica que el agente puede usar.

Representación 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.
}
Campos
name

string

Es el identificador. Es el identificador único del conjunto de herramientas. Formato: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
displayName

string

Es opcional. Es el nombre visible del conjunto de herramientas. Debe ser único dentro de la misma app.
description

string

Es opcional. Es la descripción del conjunto de herramientas.
timeout

string (Duration format)

Es opcional. Es el tiempo de espera para la ejecución del conjunto de herramientas. Si no se establece, el tiempo de espera predeterminado es de 30 segundos para los conjuntos de herramientas de SYNCHRONOUS y de 60 segundos para los conjuntos de herramientas de ASYNCHRONOUS.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de cuando se creó el conjunto de herramientas.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización del conjunto de herramientas.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
etag

string

ETag que se usa para garantizar que el objeto no haya cambiado durante una operación de lectura-modificación-escritura. Si el ETag está vacío, la actualización reemplazará cualquier cambio simultáneo.
executionType

enum (ExecutionType)

Es opcional. Es el tipo de ejecución de las herramientas en el conjunto de herramientas.
toolFakeConfig

object (ToolFakeConfig)

Es opcional. Es la configuración del comportamiento de las herramientas en el modo simulado.
Es el tipo de conjunto de herramientas. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
mcpToolset

object (McpToolset)

Es opcional. Es un conjunto de herramientas que contiene una lista de las herramientas que ofrece el servidor de MCP.
openApiToolset

object (OpenApiToolset)

Es opcional. Es un conjunto de herramientas que contiene una lista de herramientas definidas por un esquema de OpenAPI.
connectorToolset

object (ConnectorToolset)

Es opcional. Es un conjunto de herramientas que genera herramientas a partir de una conexión de Integration Connectors.
Fin de los campos mutuamente excluyentes.

McpToolset

Es un conjunto de herramientas que contiene una lista de las herramientas que ofrece el servidor de MCP.

Representación JSON 
{
  "serverAddress": string,
  "apiAuthentication": {
    object (ApiAuthentication)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "tlsConfig": {
    object (TlsConfig)
  },
  "customHeaders": {
    string: string,
    ...
  },
  "toolOverrides": [
    {
      object (McpToolOverride)
    }
  ]
}
Campos
serverAddress

string

Obligatorio. Es la dirección del servidor de MCP, por ejemplo, "https://example.com/mcp/". Si el servidor se compila con el SDK de MCP, la URL debe tener el sufijo "/mcp/". Solo se admiten servidores basados en el transporte HTTP transmisible. Consulta https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http para obtener más detalles.
apiAuthentication

object (ApiAuthentication)

Es opcional. Es la información de autenticación necesaria para acceder a las herramientas y ejecutar una herramienta en el servidor de MCP. En el caso de la autenticación con token de portador, el token solo se aplica a la ejecución de la herramienta, no a las herramientas de la ficha. Esto requiere que las herramientas se puedan enumerar sin autenticación.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Es opcional. Es la configuración del Directorio de servicios para los VPC-SC, que se usa para resolver nombres de servicios dentro de un perímetro.
tlsConfig

object (TlsConfig)

Es opcional. Es la configuración de TLS. Incluye los certificados de servidor personalizados en los que el cliente debe confiar.
customHeaders

map (key: string, value: string)

Es opcional. Son los encabezados personalizados que se enviarán en la solicitud al servidor de MCP. Los valores deben tener el formato $context.variables.<name_of_variable> y se pueden establecer en las variables de sesión. Consulta https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection para obtener más detalles.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
toolOverrides[]

object (McpToolOverride)

Es opcional. Son los reemplazos para las herramientas individuales dentro de este conjunto de herramientas. Esto permite anular detalles específicos, como descripciones o nombres, o fijar los estados de las herramientas para que no sean completamente dinámicos.

McpToolOverride

Son las anulaciones asociadas con una herramienta determinada en un conjunto de herramientas. Esto permite "fijar" o "anular" las definiciones de herramientas desde el servidor dinámico externo.

Representación JSON 
{
  "tool": string,
  "nameOverride": string,
  "descriptionOverride": string,
  "snapshot": {
    object (McpToolDefinition)
  }
}
Campos
tool

string

Obligatorio. Es el nombre original de la herramienta tal como lo emite el servidor de MCP.
nameOverride

string

Es opcional. Si está presente, esta herramienta usa este nombre en el agente en lugar del nombre original. Se usa principalmente como alias si el servidor de MCP ofrece herramientas con nombres poco claros.
descriptionOverride

string

Es opcional. Si está presente, esta herramienta usa esta descripción en lugar de la descripción original del servidor.
snapshot

object (McpToolDefinition)

Solo salida. Si está presente, esta herramienta se "fija" y usa los valores de la instantánea como alternativas si el servidor no está disponible temporalmente o si no hay ninguna anulación.

McpToolDefinition

Es un contenedor para los elementos de definición principales de una herramienta que se capturan. Los esquemas de la instantánea se usan tal como están y no se pueden anular.

Representación JSON 
{
  "description": string,
  "inputSchema": {
    object (Schema)
  },
  "outputSchema": {
    object (Schema)
  }
}
Campos
description

string

Solo salida. Es la descripción de la herramienta de MCP. descriptionOverride en McpToolOverride puede anular este valor.
inputSchema

object (Schema)

Solo salida. Es el esquema de los argumentos de entrada de la herramienta de MCP.
outputSchema

object (Schema)

Solo salida. Es el esquema de los argumentos de salida de la herramienta de MCP.

OpenApiToolset

Es un conjunto de herramientas que contiene una lista de herramientas definidas por un esquema de OpenAPI.

Representación JSON 
{
  "openApiSchema": string,
  "apiAuthentication": {
    object (ApiAuthentication)
  },
  "tlsConfig": {
    object (TlsConfig)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "ignoreUnknownFields": boolean,
  "url": string
}
Campos
openApiSchema

string

Obligatorio. Es el esquema de OpenAPI del conjunto de herramientas.
apiAuthentication

object (ApiAuthentication)

Es opcional. Es la información de autenticación que requiere la API.
tlsConfig

object (TlsConfig)

Es opcional. Es la configuración de TLS. Incluye los certificados de servidor personalizados
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Es opcional. Es la configuración del Directorio de servicios.
ignoreUnknownFields

boolean

Es opcional. Si es verdadero, el agente ignorará los campos desconocidos en la respuesta de la API para todas las operaciones definidas en el esquema de OpenAPI.
url

string

Es opcional. Es la URL del servidor del esquema de la API abierta. Este campo solo se establece en los conjuntos de herramientas de las dependencias del entorno durante el proceso de exportación si el esquema contiene una URL del servidor. Durante el proceso de importación, si esta URL está presente en las dependencias del entorno y el esquema tiene el marcador de posición $env_var, se reemplazará el marcador de posición en el esquema.

ConnectorToolset

Es un conjunto de herramientas que genera herramientas a partir de una conexión de Integration Connectors.

Representación JSON 
{
  "connection": string,
  "authConfig": {
    object (EndUserAuthConfig)
  },
  "connectorActions": [
    {
      object (Action)
    }
  ]
}
Campos
connection

string

Obligatorio. Es el nombre completo del recurso de la conexión de Integration Connectors a la que se hace referencia. Formato: projects/{project}/locations/{location}/connections/{connection}
authConfig

object (EndUserAuthConfig)

Es opcional. Configura cómo se controla la autenticación en Integration Connectors. De forma predeterminada, se pasa una autenticación de administrador en las solicitudes a la API de Integration Connectors. Puedes anularlo con una configuración de autenticación del usuario final diferente. Nota: La conexión debe tener habilitada la anulación de autenticación para especificar una configuración de EUC aquí. De lo contrario, fallará la creación del conjunto de herramientas. Consulta: https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override
connectorActions[]

object (Action)

Obligatorio. Es la lista de acciones del conector o de operaciones de la entidad para las que se generarán herramientas.

Métodos

create

 Crea un nuevo conjunto de herramientas en la app especificada.

delete

 Borra el conjunto de herramientas especificado.

get

 Obtiene detalles del conjunto de herramientas especificado.

list

 Enumera los conjuntos de herramientas de la app especificada.

patch

 Actualiza el conjunto de herramientas especificado.

retrieveTools

 Recupera la lista de herramientas incluidas en el conjunto de herramientas especificado.