MCP Tools Reference: ces.googleapis.com

Strumento: start_import_app

Avvia l'importazione di un'app CES

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP start_import_app.

Richiesta 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": "start_import_app",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per McpService.StartImportApp.

StartImportAppRequest

Rappresentazione JSON 
{
  "projectId": string,
  "locationId": string,
  "appId": string,
  "content": string
}
Campi
projectId

string

L'ID progetto dell'app da importare.
locationId

string

L'ID località dell'app da importare.
appId

string

L'ID app dell'app da importare.
content

string (bytes format)

I byte del file ZIP dell'importazione dell'app compressa, ovvero una cartella contenente i file di configurazione dell'app in formato YAML.

Una stringa con codifica in base64.

Schema di output

L'operazione che importa un'app CES.

ImportAppOperation

Rappresentazione JSON 
{
  "name": string,
  "done": boolean,
  "status": {
    object (Status)
  }
}
Campi
name

string

Il nome della risorsa dell'operazione di importazione dell'app.
done

boolean

Indica se l'operazione è stata completata.
status

object (Status)

Se [done] è true, contiene lo stato dell'importazione.

Status

Rappresentazione JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campi
code

integer

Il codice di stato, che deve essere un valore enum di google.rpc.Code.
message

string

Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo google.rpc.Status.details o localizzato dal client.
details[]

object

Un elenco di messaggi contenenti i dettagli dell'errore. Esiste un insieme comune di tipi di messaggi da utilizzare per le API.

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

Any

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

string

Identifica il tipo del messaggio Protobuf serializzato con un riferimento URI composto da un prefisso che termina con una barra e il nome del tipo completo.

Esempio: type.googleapis.com/google.protobuf.StringValue

Questa stringa deve contenere almeno un carattere / e il contenuto dopo l'ultimo / deve essere il nome completo del tipo in formato canonico, senza un punto iniziale. Non scrivere uno schema su questi riferimenti URI in modo che i client non tentino di contattarli.

Il prefisso è arbitrario e le implementazioni di Protobuf dovrebbero semplicemente rimuovere tutto fino all'ultimo / incluso per identificare il tipo. type.googleapis.com/ è un prefisso predefinito comune richiesto da alcune implementazioni legacy. Questo prefisso non indica l'origine del tipo e non è previsto che gli URI che lo contengono rispondano a eventuali richieste.

Tutte le stringhe dell'URL del tipo devono essere riferimenti URI validi con la limitazione aggiuntiva (per il formato di testo) che il contenuto del riferimento deve essere composto solo da caratteri alfanumerici, escape con codifica percentuale e caratteri nel seguente insieme (senza includere i backtick esterni): /-.~_!$&()*+,;=. Nonostante consentiamo le codifiche percentuali, le implementazioni non devono decodificarle per evitare confusione con i parser esistenti. Ad esempio, type.googleapis.com%2FFoo deve essere rifiutato.

Nella progettazione originale di Any, è stata presa in considerazione la possibilità di avviare un servizio di risoluzione dei tipi a questi URL di tipo, ma Protobuf non ne ha mai implementato uno e considera problematico e un potenziale problema di sicurezza contattare questi URL. Non tentare di contattare gli URL di tipo.
value

string (bytes format)

Contiene una serializzazione Protobuf del tipo descritto da type_url.

Una stringa con codifica in base64.

Annotazioni dello strumento

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client tratta questi suggerimenti come non attendibili, ma possono essere utilizzati per decidere quando inviare una richiesta 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 le 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: ❌