MCP Tools Reference: developerconnect.googleapis.com

Strumento: list-connections

Elenca le connessioni in un progetto e una località specifici.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP list-connections.

Richiesta curl 
curl --location 'https://developerconnect.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list-connections",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio per la richiesta dell'elenco delle connessioni

ListConnectionsRequest

Rappresentazione JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campi
parent

string

Obbligatorio. Valore della risorsa padre per ListConnectionsRequest
pageSize

integer

Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
pageToken

string

Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
filter

string

Facoltativo. Filtro dei risultati.
orderBy

string

Facoltativo. Suggerimento su come ordinare i risultati.

Schema di output

Messaggio per la risposta alle risorse Connection

ListConnectionsResponse

Rappresentazione JSON 
{
  "connections": [
    {
      object (Connection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
connections[]

object (Connection)

L'elenco delle connessioni.
nextPageToken

string

Un token che identifica una pagina di risultati che il server deve restituire.
unreachable[]

string

Località non raggiungibili.

Connessione

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "installationState": {
    object (InstallationState)
  },
  "disabled": boolean,
  "reconciling": boolean,
  "annotations": {
    string: string,
    ...
  },
  "etag": string,
  "uid": string,
  "cryptoKeyConfig": {
    object (CryptoKeyConfig)
  },
  "gitProxyConfig": {
    object (GitProxyConfig)
  },

  // Union field connection_config can be only one of the following:
  "githubConfig": {
    object (GitHubConfig)
  },
  "githubEnterpriseConfig": {
    object (GitHubEnterpriseConfig)
  },
  "gitlabConfig": {
    object (GitLabConfig)
  },
  "gitlabEnterpriseConfig": {
    object (GitLabEnterpriseConfig)
  },
  "bitbucketDataCenterConfig": {
    object (BitbucketDataCenterConfig)
  },
  "bitbucketCloudConfig": {
    object (BitbucketCloudConfig)
  },
  "secureSourceManagerInstanceConfig": {
    object (SecureSourceManagerInstanceConfig)
  },
  "httpConfig": {
    object (GenericHTTPEndpointConfig)
  }
  // End of list of possible types for union field connection_config.
}
Campi
name

string

Identificatore. Il nome della risorsa della connessione, nel formato projects/{project}/locations/{location}/connections/{connection_id}.
createTime

string (Timestamp format)

Solo output. Timestamp creazione.

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 aggiornamento.

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".
deleteTime

string (Timestamp format)

Solo output. Elimina il timestamp.

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".
labels

map (key: string, value: string)

Facoltativo. Etichette come coppie chiave-valore

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

object (InstallationState)

Solo output. Stato di installazione della connessione.
disabled

boolean

Facoltativo. Se disabled è impostato su true, la funzionalità è disattivata per questa connessione. I metodi API basati su repository e l'elaborazione dei webhook per i repository in questa connessione verranno disabilitati.
reconciling

boolean

Solo output. Impostato su true quando la connessione viene configurata o aggiornata in background.
annotations

map (key: string, value: string)

Facoltativo. Consente ai client di archiviare piccole quantità di dati arbitrari.

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

string

Facoltativo. Questo checksum viene calcolato dal server in base al valore di altri campi e può essere inviato con le richieste di aggiornamento ed eliminazione per garantire che il client abbia un valore aggiornato prima di procedere.
uid

string

Solo output. Un identificatore univoco assegnato dal sistema per la connessione.
cryptoKeyConfig

object (CryptoKeyConfig)

Facoltativo. La configurazione della chiave di crittografia. Questo campo viene utilizzato dalla funzionalità Chiavi di crittografia gestite dal cliente (CMEK).
gitProxyConfig

object (GitProxyConfig)

Facoltativo. Configurazione della funzionalità proxy Git. L'abilitazione del proxy Git consente ai client di eseguire operazioni Git sui repository collegati nella connessione. Scopri di più.
Campo unione connection_config. Configurazione della connessione in base al tipo di provider. connection_config può essere solo uno dei seguenti tipi:
githubConfig

object (GitHubConfig)

Configurazione per le connessioni a github.com.
githubEnterpriseConfig

object (GitHubEnterpriseConfig)

Configurazione per le connessioni a un'istanza di GitHub Enterprise.
gitlabConfig

object (GitLabConfig)

Configurazione per le connessioni a gitlab.com.
gitlabEnterpriseConfig

object (GitLabEnterpriseConfig)

Configurazione per le connessioni a un'istanza di GitLab Enterprise.
bitbucketDataCenterConfig

object (BitbucketDataCenterConfig)

Configurazione per le connessioni a un'istanza di Bitbucket Data Center.
bitbucketCloudConfig

object (BitbucketCloudConfig)

Configurazione per le connessioni a un'istanza di Bitbucket Cloud.
secureSourceManagerInstanceConfig

object (SecureSourceManagerInstanceConfig)

Configurazione per le connessioni a un'istanza di Secure Source Manager.
httpConfig

object (GenericHTTPEndpointConfig)

Facoltativo. Configurazione per le connessioni a un fornitore di servizi HTTP.

GitHubConfig

Rappresentazione JSON 
{
  "githubApp": enum (GitHubApp),
  "authorizerCredential": {
    object (OAuthCredential)
  },
  "appInstallationId": string,
  "installationUri": string
}
Campi
githubApp

enum (GitHubApp)

Obbligatorio. Immutabile. L'applicazione GitHub installata nell'utente o nell'organizzazione GitHub.
authorizerCredential

object (OAuthCredential)

Facoltativo. Credenziale OAuth dell'account che ha autorizzato l'app GitHub. Ti consigliamo di utilizzare un account robot anziché un account utente umano. Il token OAuth deve essere associato all'app GitHub di questa configurazione.
appInstallationId

string (int64 format)

Facoltativo. ID installazione dell'app GitHub.
installationUri

string

Solo output. L'URI a cui accedere per gestire l'installazione associata a questo GitHubConfig.

OAuthCredential

Rappresentazione JSON 
{
  "oauthTokenSecretVersion": string,
  "username": string
}
Campi
oauthTokenSecretVersion

string

Obbligatorio. Una risorsa SecretManager contenente il token OAuth che autorizza la connessione. Formato: projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località).
username

string

Solo output. Il nome utente associato a questo token.

GitHubEnterpriseConfig

Rappresentazione JSON 
{
  "hostUri": string,
  "appId": string,
  "appSlug": string,
  "privateKeySecretVersion": string,
  "webhookSecretSecretVersion": string,
  "appInstallationId": string,
  "installationUri": string,
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "serverVersion": string,
  "sslCaCertificate": string,
  "organization": string
}
Campi
hostUri

string

Obbligatorio. L'URI dell'host GitHub Enterprise per cui è stata creata questa connessione.
appId

string (int64 format)

Facoltativo. ID dell'app GitHub creata dal manifest.
appSlug

string

Solo output. Il nome dell'app GitHub compatibile con gli URL.
privateKeySecretVersion

string

Facoltativo. Risorsa SecretManager contenente la chiave privata dell'app GitHub, formattata come projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località).
webhookSecretSecretVersion

string

Facoltativo. Risorsa SecretManager contenente il secret del webhook dell'app GitHub, formattato come projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località).
appInstallationId

string (int64 format)

Facoltativo. ID dell'installazione dell'app GitHub.
installationUri

string

Solo output. L'URI a cui accedere per gestire l'installazione associata a questo GitHubEnterpriseConfig.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Facoltativo. Configurazione per l'utilizzo di Service Directory per connettersi privatamente a un server GitHub Enterprise. Questo campo deve essere impostato solo se il server GitHub Enterprise è ospitato on-premise e non è raggiungibile tramite internet pubblico. Se questo campo viene lasciato vuoto, le chiamate al server GitHub Enterprise verranno effettuate tramite la rete internet pubblica.
serverVersion

string

Solo output. Versione di GitHub Enterprise installata in host_uri.
sslCaCertificate

string

Facoltativo. Certificato SSL da utilizzare per le richieste a GitHub Enterprise.
organization

string

Facoltativo. Immutabile. Organizzazione GitHub Enterprise in cui viene creata l'app GitHub.

ServiceDirectoryConfig

Rappresentazione JSON 
{
  "service": string
}
Campi
service

string

Obbligatorio. Il nome del servizio Service Directory. Formato: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.

GitLabConfig

Rappresentazione JSON 
{
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
Campi
webhookSecretSecretVersion

string

Obbligatorio. Immutabile. Risorsa SecretManager contenente il secret del webhook di un progetto GitLab, formattato come projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località). Viene utilizzato per convalidare i webhook.
readAuthorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso personale GitLab con accesso all'ambito minimo read_api e un ruolo minimo di reporter. I progetti GitLab visibili a questo token di accesso personale controlleranno i progetti a cui Developer Connect ha accesso.
authorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso personale GitLab con accesso all'ambito minimo api e un ruolo minimo di maintainer. I progetti GitLab visibili a questo token di accesso personale controlleranno i progetti a cui Developer Connect ha accesso.

UserCredential

Rappresentazione JSON 
{
  "userTokenSecretVersion": string,
  "username": string
}
Campi
userTokenSecretVersion

string

Obbligatorio. Una risorsa SecretManager contenente il token utente che autorizza la connessione di Developer Connect. Formato: projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località).
username

string

Solo output. Il nome utente associato a questo token.

GitLabEnterpriseConfig

Rappresentazione JSON 
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
Campi
hostUri

string

Obbligatorio. L'URI dell'host GitLab Enterprise per cui è stata creata questa connessione.
webhookSecretSecretVersion

string

Obbligatorio. Immutabile. Risorsa SecretManager contenente il secret del webhook di un progetto GitLab, formattato come projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località). Viene utilizzato per convalidare i webhook.
readAuthorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso personale GitLab con accesso all'ambito minimo read_api e un ruolo minimo di reporter. I progetti GitLab visibili a questo token di accesso personale controlleranno i progetti a cui Developer Connect ha accesso.
authorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso personale GitLab con accesso all'ambito minimo api e un ruolo minimo di maintainer. I progetti GitLab visibili a questo token di accesso personale controlleranno i progetti a cui Developer Connect ha accesso.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Facoltativo. Configurazione per l'utilizzo di Service Directory per la connessione privata a un'istanza GitLab Enterprise. Questo valore deve essere impostato solo se il server GitLab Enterprise è ospitato on-premise e non è raggiungibile tramite internet pubblico. Se questo campo viene lasciato vuoto, le chiamate al server GitLab Enterprise verranno effettuate tramite internet pubblico.
sslCaCertificate

string

Facoltativo. Certificato dell'autorità di certificazione SSL da utilizzare per le richieste all'istanza GitLab Enterprise.
serverVersion

string

Solo output. Versione del server GitLab Enterprise in esecuzione su host_uri.

BitbucketDataCenterConfig

Rappresentazione JSON 
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
Campi
hostUri

string

Obbligatorio. L'URI dell'host Bitbucket Data Center per cui è stata creata questa connessione.
webhookSecretSecretVersion

string

Obbligatorio. Immutabile. Risorsa SecretManager contenente il secret del webhook utilizzato per verificare gli eventi del webhook, formattato come projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località). Viene utilizzato per convalidare i webhook.
readAuthorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso HTTP con l'accesso minimo Repository read. Ti consigliamo di utilizzare un account di sistema per generare le credenziali.
authorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso HTTP con accesso all'ambito Repository admin minimo. Questo è necessario per creare webhook. Ti consigliamo di utilizzare un account di sistema per generare queste credenziali.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Facoltativo. Configurazione per l'utilizzo di Service Directory per connettersi privatamente a un'istanza Bitbucket Data Center. Questo campo deve essere impostato solo se Bitbucket Data Center è ospitato on-premise e non è raggiungibile tramite internet pubblico. Se questo campo viene lasciato vuoto, le chiamate al data center Bitbucket verranno effettuate tramite internet pubblico.
sslCaCertificate

string

Facoltativo. Autorità di certificazione SSL da considerare attendibile quando si effettuano richieste a Bitbucket Data Center.
serverVersion

string

Solo output. Versione del server Bitbucket Data Center in esecuzione su host_uri.

BitbucketCloudConfig

Rappresentazione JSON 
{
  "workspace": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
Campi
workspace

string

Obbligatorio. L'ID dell'area di lavoro Bitbucket Cloud da connettere alla Google Cloud Platform.
webhookSecretSecretVersion

string

Obbligatorio. Immutabile. Risorsa SecretManager contenente il secret del webhook utilizzato per verificare gli eventi del webhook, formattato come projects/*/secrets/*/versions/* o projects/*/locations/*/secrets/*/versions/* (se i secret regionali sono supportati in quella località). Viene utilizzato per convalidare e creare webhook.
readAuthorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso con l'accesso minimo a repository. Può essere un token di accesso all'area di lavoro, al progetto o al repository. Ti consigliamo di utilizzare un account di sistema per generare le credenziali.
authorizerCredential

object (UserCredential)

Obbligatorio. Un token di accesso con accesso minimo agli ambiti repository, pullrequest e webhook. Può essere un token di accesso a un'area di lavoro, a un progetto o a un repository. Questo è necessario per creare webhook. Ti consigliamo di utilizzare un account di sistema per generare queste credenziali.

SecureSourceManagerInstanceConfig

Rappresentazione JSON 
{
  "instance": string
}
Campi
instance

string

Obbligatorio. Immutabile. Risorsa dell'istanza Secure Source Manager, formattata come projects/*/locations/*/instances/*

GenericHTTPEndpointConfig

Rappresentazione JSON 
{
  "hostUri": string,
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,

  // Union field authentication can be only one of the following:
  "basicAuthentication": {
    object (BasicAuthentication)
  },
  "bearerTokenAuthentication": {
    object (BearerTokenAuthentication)
  }
  // End of list of possible types for union field authentication.
}
Campi
hostUri

string

Obbligatorio. Immutabile. L'endpoint HTTPS del fornitore di servizi.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

Facoltativo. Configurazione per l'utilizzo di Service Directory per la connessione privata a un fornitore di servizi HTTP. Questo valore deve essere impostato solo se il fornitore di servizi HTTP è ospitato on-premise e non è raggiungibile tramite internet pubblico. Se questo campo viene lasciato vuoto, le chiamate al fornitore di servizi HTTP verranno effettuate tramite la rete internet pubblica.
sslCaCertificate

string

Facoltativo. Il certificato SSL da utilizzare per le richieste al fornitore di servizi HTTP.
Campo unione authentication. Il meccanismo di autenticazione da utilizzare per le richieste al fornitore di servizi HTTP. authentication può essere solo uno dei seguenti tipi:
basicAuthentication

object (BasicAuthentication)

Facoltativo. Autenticazione di base con nome utente e password.
bearerTokenAuthentication

object (BearerTokenAuthentication)

Facoltativo. Autenticazione con token di connessione.

BasicAuthentication

Rappresentazione JSON 
{
  "username": string,

  // Union field password can be only one of the following:
  "passwordSecretVersion": string
  // End of list of possible types for union field password.
}
Campi
username

string

Obbligatorio. Il nome utente da utilizzare per l'autenticazione.
Campo unione password. La password con cui eseguire l'autenticazione. password può essere solo uno dei seguenti tipi:
passwordSecretVersion

string

La versione del secret SecretManager della password da utilizzare per l'autenticazione.

BearerTokenAuthentication

Rappresentazione JSON 
{

  // Union field token can be only one of the following:
  "tokenSecretVersion": string
  // End of list of possible types for union field token.
}
Campi
Campo unione token. Il token per l'autenticazione. token può essere solo uno dei seguenti tipi:
tokenSecretVersion

string

Facoltativo. La versione del secret SecretManager del token da utilizzare per l'autenticazione.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi dell'ora UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrisponde a un intervallo compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che avanzano nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

LabelsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

InstallationState

Rappresentazione JSON 
{
  "stage": enum (Stage),
  "message": string,
  "actionUri": string
}
Campi
stage

enum (Stage)

Solo output. Passaggio corrente del processo di installazione.
message

string

Solo output. Messaggio che indica all'utente cosa fare per continuare l'installazione. Stringa vuota se l'installazione è già stata completata.
actionUri

string

Solo output. Link da seguire per l'azione successiva. Stringa vuota se l'installazione è già stata completata.

AnnotationsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

CryptoKeyConfig

Rappresentazione JSON 
{
  "keyReference": string
}
Campi
keyReference

string

Obbligatorio. Il nome della chiave utilizzata per criptare/decriptare i dati dei clienti. Per la chiave in Cloud KMS, il formato della chiave deve essere projects/*/locations/*/keyRings/*/cryptoKeys/*.

GitProxyConfig

Rappresentazione JSON 
{
  "enabled": boolean,
  "httpProxyBaseUri": string
}
Campi
enabled

boolean

Facoltativo. Se impostato su true, il proxy Git può essere utilizzato per eseguire operazioni Git sui repository collegati nella connessione.
httpProxyBaseUri

string

Solo output. L'URI di base per l'endpoint del proxy HTTP. Ha il formato https://{generatedID}-c-h-{shortRegion}.developerconnect.dev. Viene compilato solo se l'opzione abilitata è impostata su true. Questo endpoint viene utilizzato da altri servizi Google che si integrano con Developer Connect.

GitHubApp

Rappresenta le varie applicazioni GitHub che possono essere installate su un utente o un'organizzazione GitHub e utilizzate con Developer Connect.

Enum
GIT_HUB_APP_UNSPECIFIED App GitHub non specificata.
DEVELOPER_CONNECT L'applicazione GitHub Developer Connect.
FIREBASE L'applicazione Firebase GitHub.
GEMINI_CODE_ASSIST L'applicazione Gemini Code Assist.
DATAFORM L'applicazione GitHub di Dataform.

Fase

Fase del processo di installazione.

Enum
STAGE_UNSPECIFIED Nessuna fase specificata.
PENDING_CREATE_APP Solo per GitHub Enterprise. È stata richiesta la creazione di un'app. L'utente deve confermare la creazione nel proprio host GitHub Enterprise.
PENDING_USER_OAUTH L'utente deve autorizzare l'app GitHub (o Enterprise) tramite OAuth.
PENDING_INSTALL_APP L'utente deve seguire il link per installare l'app GitHub (o Enterprise).
COMPLETE La procedura di installazione è stata completata.

Annotazioni dello strumento

Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare un prompt di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌