CLI gactions (Dialogflow)

gactions est l'interface de ligne de commande que vous utilisez pour tester et mettre à jour votre projet Actions.

Architecture du système

Pour sélectionner le téléchargement approprié, vous devez rechercher l'architecture de votre système.

  • Sur les appareils Mac OS X et Linux, vous pouvez trouver l'architecture du processeur de votre ordinateur à l'aide de la commande de terminal uname -a.

  • Sur les appareils Windows 10, procédez comme suit pour rechercher l'architecture du processeur:

    1. Ouvrez Paramètres.

    2. Cliquez sur Système

    3. Cliquez sur À propos.

Téléchargements

Vous pouvez télécharger gactions pour votre système d'exploitation (ci-dessous).

OS Téléchargements
Windows
Mac
Linux

Conditions requises

  • Rendez le fichier téléchargé exécutable en définissant les autorisations appropriées.
    • Sous Mac et Linux, exécutez chmod +x gactions pour rendre le binaire exécutable.
    • Sous Windows, vous devez disposer des droits d'administrateur.
  • L'emplacement de téléchargement gactions doit se trouver dans la variable d'environnement PATH.

Arguments compatibles

Le tableau suivant décrit les arguments acceptés pour gactions:

Argument Description
help, h Affiche le texte d'aide de cet outil. Exemple : 
gactions help

Pour afficher le texte d'aide d'un argument spécifique, utilisez la syntaxe suivante:

gactions help argument

Exemple :

gactions help test
get Récupère le contenu du projet donné (Actions + métadonnées). Utilisez la syntaxe suivante : 
gactions get --project PROJECT_ID
init Crée un fichier action.json par défaut dans le répertoire actuel avec la syntaxe suivante : 
gactions init

Si un fichier action.json existe déjà, vous pouvez l'écraser en ajoutant l'argument --force, comme l'illustre l'exemple suivant:

gactions init --force
list Liste jusqu'à 10 versions récentes de votre projet Actions (en cours d'examen, de production, approuvée, etc.) avec la syntaxe suivante : 
gactions list --project PROJECT_ID
test Envoie un package d'actions à la plate-forme de l'Assistant pour le tester avec la syntaxe suivante : 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

Exemple :

gactions test --action_package mypackage.json --project my-project-1234567

Vous pouvez éventuellement désactiver les tests dans l'environnement de bac à sable avec l'indicateur
--disable_sandbox.

L'indicateur --preview_mins est obsolète.
update Met à jour le package d'action pour le projet donné avec la syntaxe suivante : 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

Exemple :

gactions update --action_package action.json --project my-project-1234567

Pour utiliser l'argument update, vous devez utiliser l'ID de projet de votre action. Pour obtenir l'ID de votre projet, cliquez sur l'icône en forme de roue dentée dans votre projet Actions on Google, puis sur Paramètres du projet.

Si votre projet Actions est disponible dans plusieurs langues, consultez la documentation sur le package d'action.
selfupdate gactions vérifie automatiquement les mises à jour avant l'exécution de chaque commande, mais vous pouvez forcer cette vérification avec selfupdate. 
gactions selfupdate

Afficher le résultat détaillé

Pour afficher des résultats plus détaillés lors du traitement, ajoutez l'indicateur --verbose. Exemple :

gactions --verbose test --action_package action.json --project my-project-1234567

Exemple de fichier action.json par défaut

Lorsque vous exécutez gactions init dans le répertoire de votre projet, vous générez un fichier action.json par défaut dans ce répertoire:

{
  "actions": [
    {
      "description": "Default Welcome Intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "<INSERT YOUR CONVERSATION NAME HERE>"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to <INSERT YOUR NAME HERE>"
          ]
        }
      }
    }
  ],
  "conversations": {
    "<INSERT YOUR CONVERSATION NAME HERE>": {
      "name": "<INSERT YOUR CONVERSATION NAME HERE>",
      "url": "<INSERT YOUR FULLFILLMENT URL HERE>"
    }
  },
  "locale": "<INSERT YOUR LANGUAGE HERE>"
}