MCP Tools Reference: ces.googleapis.com

Outil : start_import_app

Démarre l'importation d'une application CES

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP start_import_app.

Requête 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
}'

Schéma d'entrée

Message de requête pour McpService.StartImportApp.

StartImportAppRequest

Représentation JSON 
{
  "projectId": string,
  "locationId": string,
  "appId": string,
  "content": string
}
Champs
projectId

string

ID de projet de l'application à importer.
locationId

string

ID d'emplacement de l'application à importer.
appId

string

ID d'application de l'application à importer.
content

string (bytes format)

Octets du fichier ZIP de l'importation d'application compressée, qui est un dossier contenant les fichiers de configuration de l'application au format YAML.

Chaîne encodée en base64.

Schéma de sortie

Opération qui importe une application CES.

ImportAppOperation

Représentation JSON 
{
  "name": string,
  "done": boolean,
  "status": {
    object (Status)
  }
}
Champs
name

string

Nom de ressource de l'opération d'importation d'application.
done

boolean

Indique si l'opération est terminée.
status

object (Status)

Si [done] est défini sur "true", contient l'état de l'importation.

État

Représentation JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Champs
code

integer

Code d'état, qui doit être une valeur d'énumération de google.rpc.Code.
message

string

Message d'erreur destiné au développeur, qui doit être en anglais. Tout message d'erreur destiné aux utilisateurs doit être localisé et envoyé dans le champ google.rpc.Status.details, ou localisé par le client.
details[]

object

Liste de messages comportant les détails de l'erreur. Il existe un ensemble commun de types de message utilisable par les API.

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

Tous

Représentation JSON 
{
  "typeUrl": string,
  "value": string
}
Champs
typeUrl

string

Identifie le type du message Protobuf sérialisé avec une référence d'URI composée d'un préfixe se terminant par une barre oblique et du nom de type complet.

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

Cette chaîne doit contenir au moins un caractère /, et le contenu après le dernier / doit être le nom complet du type au format canonique, sans point au début. N'écrivez pas de schéma sur ces références d'URI afin que les clients ne tentent pas de les contacter.

Le préfixe est arbitraire et les implémentations Protobuf sont censées supprimer tout ce qui précède et inclut le dernier / pour identifier le type. type.googleapis.com/ est un préfixe par défaut courant requis par certaines implémentations héritées. Ce préfixe n'indique pas l'origine du type, et les URI qui le contiennent ne sont pas censés répondre aux requêtes.

Toutes les chaînes d'URL de type doivent être des références d'URI valides avec la restriction supplémentaire (pour le format texte) que le contenu de la référence ne doit être composé que de caractères alphanumériques, d'échappements encodés en pourcentage et de caractères de l'ensemble suivant (sans inclure les accents graves externes) : /-.~_!$&()*+,;=. Bien que nous autorisions les encodages en pourcentage, les implémentations ne doivent pas les déséchapper pour éviter toute confusion avec les analyseurs existants. Par exemple, type.googleapis.com%2FFoo doit être refusé.

Dans la conception d'origine de Any, la possibilité de lancer un service de résolution de type sur ces URL de type a été envisagée, mais Protobuf n'en a jamais implémenté et considère que contacter ces URL est problématique et constitue un problème de sécurité potentiel. N'essayez pas de contacter les URL de type.
value

string (bytes format)

Contient une sérialisation Protobuf du type décrit par type_url.

Chaîne encodée en base64.

Annotations d'outil

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces conseils comme non fiables, mais ils peuvent être utilisés pour déterminer quand une invite de confirmation peut être envoyée à un utilisateur.

Outre la chaîne de titre, les conseils booléens suivants sont définis comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions additives. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Conseil destructif : ✅ | Conseil idempotent : ❌ | Conseil en lecture seule : ❌ | Conseil en monde ouvert : ❌