REST Resource: projects.locations.apps.toolsets

Risorsa: Toolset

Un insieme di strumenti rappresenta un gruppo di strumenti gestiti dinamicamente che possono essere utilizzati dall'agente.

Rappresentazione 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.
}
Campi
name

string

Identificatore. L'identificatore univoco del toolset. Formato: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
displayName

string

Facoltativo. Il nome visualizzato del toolset. Deve essere univoco all'interno della stessa app.
description

string

Facoltativo. La descrizione del toolset.
timeout

string (Duration format)

Facoltativo. Il timeout per l'esecuzione del toolset. Se non viene impostato, il timeout predefinito è di 30 secondi per i toolset SYNCHRONOUS e di 60 secondi per i toolset ASYNCHRONOUS.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
createTime

string (Timestamp format)

Solo output. Timestamp di creazione del toolset.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento del toolset.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
etag

string

ETag utilizzato per garantire che l'oggetto non sia stato modificato durante un'operazione di lettura, modifica e scrittura. Se l'etag è vuoto, l'aggiornamento sovrascriverà eventuali modifiche simultanee.
executionType

enum (ExecutionType)

Facoltativo. Il tipo di esecuzione degli strumenti nel toolset.
toolFakeConfig

object (ToolFakeConfig)

Facoltativo. Configurazione del comportamento degli strumenti in modalità fittizia.
Il tipo di toolset. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
mcpToolset

object (McpToolset)

Facoltativo. Un insieme di strumenti che contiene un elenco di strumenti offerti dal server MCP.
openApiToolset

object (OpenApiToolset)

Facoltativo. Un insieme di strumenti che contiene un elenco di strumenti definiti da uno schema OpenAPI.
connectorToolset

object (ConnectorToolset)

Facoltativo. Un insieme di strumenti che genera strumenti da una connessione Integration Connectors.
Fine dei campi che si escludono a vicenda.

McpToolset

Un insieme di strumenti che contiene un elenco di strumenti offerti dal server MCP.

Rappresentazione JSON 
{
  "serverAddress": string,
  "apiAuthentication": {
    object (ApiAuthentication)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "tlsConfig": {
    object (TlsConfig)
  },
  "customHeaders": {
    string: string,
    ...
  },
  "toolOverrides": [
    {
      object (McpToolOverride)
    }
  ]
}
Campi
serverAddress

string

Obbligatorio. L'indirizzo del server MCP, ad esempio "https://example.com/mcp/". Se il server è creato con l'SDK MCP, l'URL deve avere il suffisso "/mcp/". Sono supportati solo i server basati sul trasporto HTTP trasmissibile. Per ulteriori dettagli, visita https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http.
apiAuthentication

object (ApiAuthentication)

Facoltativo. Informazioni di autenticazione necessarie per accedere agli strumenti ed eseguire uno strumento sul server MCP. Per l'autenticazione con token di tipo bearer, il token si applica solo all'esecuzione dello strumento, non agli strumenti di listing. Ciò richiede che gli strumenti possano essere elencati senza autenticazione.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Facoltativo. Configurazione di Service Directory per VPC-SC, utilizzata per risolvere i nomi dei servizi all'interno di un perimetro.
tlsConfig

object (TlsConfig)

Facoltativo. La configurazione TLS. Include i certificati del server personalizzati che il client deve considerare attendibili.
customHeaders

map (key: string, value: string)

Facoltativo. Le intestazioni personalizzate da inviare nella richiesta al server MCP. I valori devono essere nel formato $context.variables.<name_of_variable> e possono essere impostati nelle variabili di sessione. Per maggiori dettagli, visita la pagina https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/tool/open-api#openapi-injection.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
toolOverrides[]

object (McpToolOverride)

Facoltativo. Override per i singoli strumenti all'interno di questo set di strumenti. Ciò consente di ignorare dettagli specifici come descrizioni, nomi o bloccare gli stati degli strumenti in modo che non siano completamente dinamici.

McpToolOverride

Override associati a un determinato strumento in un insieme di strumenti. Ciò consente di "bloccare" o "ignorare" le definizioni degli strumenti dal server dinamico esterno.

Rappresentazione JSON 
{
  "tool": string,
  "nameOverride": string,
  "descriptionOverride": string,
  "snapshot": {
    object (McpToolDefinition)
  }
}
Campi
tool

string

Obbligatorio. Il nome originale dello strumento così come viene emesso dal server MCP.
nameOverride

string

Facoltativo. Se presente, questo strumento utilizza questo nome nell'agente anziché il nome originale. Viene utilizzato principalmente come alias se il server MCP offre strumenti con nomi poco chiari.
descriptionOverride

string

Facoltativo. Se presente, questo strumento utilizza questa descrizione anziché la descrizione originale del server.
snapshot

object (McpToolDefinition)

Solo output. Se presente, questo strumento è "bloccato" e utilizza i valori dello snapshot come fallback se il server non è temporaneamente disponibile o se non è presente alcun override.

McpToolDefinition

Contenitore per gli elementi di definizione principali di uno strumento di cui viene creato uno snapshot. Gli schemi nello snapshot vengono utilizzati così come sono e non possono essere sostituiti.

Rappresentazione JSON 
{
  "description": string,
  "inputSchema": {
    object (Schema)
  },
  "outputSchema": {
    object (Schema)
  }
}
Campi
description

string

Solo output. La descrizione dello strumento MCP. Questa impostazione può essere sostituita da descriptionOverride in McpToolOverride.
inputSchema

object (Schema)

Solo output. Lo schema degli argomenti di input dello strumento MCP.
outputSchema

object (Schema)

Solo output. Lo schema degli argomenti di output dello strumento MCP.

OpenApiToolset

Un insieme di strumenti che contiene un elenco di strumenti definiti da uno schema OpenAPI.

Rappresentazione JSON 
{
  "openApiSchema": string,
  "apiAuthentication": {
    object (ApiAuthentication)
  },
  "tlsConfig": {
    object (TlsConfig)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "ignoreUnknownFields": boolean,
  "url": string
}
Campi
openApiSchema

string

Obbligatorio. Lo schema OpenAPI del set di strumenti.
apiAuthentication

object (ApiAuthentication)

Facoltativo. Informazioni di autenticazione richieste dall'API.
tlsConfig

object (TlsConfig)

Facoltativo. La configurazione TLS. Include i certificati del server personalizzati
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Facoltativo. Configurazione di Service Directory.
ignoreUnknownFields

boolean

Facoltativo. Se il valore è true, l'agente ignorerà i campi sconosciuti nella risposta API per tutte le operazioni definite nello schema OpenAPI.
url

string

Facoltativo. L'URL del server dello schema dell'API Open. Questo campo viene impostato solo nei toolset nelle dipendenze dell'ambiente durante il processo di esportazione se lo schema contiene un URL del server. Durante il processo di importazione, se questo URL è presente nelle dipendenze dell'ambiente e lo schema contiene il segnaposto $env_var, quest'ultimo verrà sostituito nello schema.

ConnectorToolset

Un insieme di strumenti che genera strumenti da una connessione Integration Connectors.

Rappresentazione JSON 
{
  "connection": string,
  "authConfig": {
    object (EndUserAuthConfig)
  },
  "connectorActions": [
    {
      object (Action)
    }
  ]
}
Campi
connection

string

Obbligatorio. Il nome completo della risorsa della connessione Integration Connectors a cui viene fatto riferimento. Formato: projects/{project}/locations/{location}/connections/{connection}
authConfig

object (EndUserAuthConfig)

Facoltativo. Configura la gestione dell'autenticazione in Integration Connectors. Per impostazione predefinita, un'autenticazione amministratore viene trasmessa nelle richieste dell'API Integration Connectors. Puoi sostituirlo con una configurazione di autenticazione dell'utente finale diversa. Nota: per specificare una configurazione EUC qui, l'override dell'autenticazione deve essere abilitato nella connessione. In caso contrario, la creazione del toolset non riuscirà. Consulta: https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override
connectorActions[]

object (Action)

Obbligatorio. L'elenco delle azioni/operazioni sulle entità del connettore per cui generare strumenti.

Metodi

create

 Crea un nuovo toolset nell'app specificata.

delete

 Elimina il set di strumenti specificato.

get

 Recupera i dettagli del toolset specificato.

list

 Elenca i toolset nell'app specificata.

patch

 Aggiorna il set di strumenti specificato.

retrieveTools

 Recupera l'elenco degli strumenti inclusi nel toolset specificato.