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 bon téléchargement, vous devez trouver l'architecture de votre système.

  • Sur les appareils Mac OS X et Linux, vous pouvez identifier 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 trouver 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 de droits d'administrateur.
  • L'emplacement de téléchargement gactions doit se trouver dans votre variable d'environnement PATH.

Arguments acceptés

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

Argument Description
help, h Génère 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 Permet d'obtenir 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

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

gactions init --force
list Répertorie jusqu'à 10 versions récentes de votre projet Actions: en cours d'examen, en production, approuvées, etc., avec la syntaxe suivante : 
gactions list --project PROJECT_ID
test Transfère un package d'actions à la plate-forme Assistant à des fins de test 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'option
--disable_sandbox.

L'option --preview_mins est obsolète.
update Met à jour le package d'actions 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 des paramètres 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 langages, consultez la documentation du package d'actions.
selfupdate gactions recherche automatiquement les mises à jour avant l'exécution de chaque commande, mais vous pouvez forcer cette vérification avec selfupdate 
gactions selfupdate

Afficher la sortie détaillée

Pour afficher le résultat plus détaillé 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>"
}