interfaccia a riga di comando gactions (Dialogflow)

gactions è l'interfaccia a riga di comando che utilizzi per testare e aggiornare il progetto Actions.

Architettura di sistema

Per selezionare il download corretto, dovrai trovare l'architettura del tuo sistema.

  • Sui dispositivi Mac OS X e Linux, puoi trovare l'architettura della CPU del computer utilizzando il comando del terminale uname -a.

  • Sui dispositivi Windows 10, segui questi passaggi per trovare l'architettura della CPU:

    1. Apri le Impostazioni

    2. Fai clic su Sistema

    3. Fai clic su Informazioni

Download

Puoi scaricare gactions per il tuo sistema operativo (vedi di seguito).

Sistema operativo Download
Windows
Mac
Linux

Requisiti

  • Rendi eseguibile il file scaricato impostando le autorizzazioni appropriate.
    • Su Mac e Linux, esegui chmod +x gactions per rendere eseguibile il programma binario.
    • Su Windows, devi disporre dei diritti di amministratore.
  • Il percorso di download di gactions deve essere nella variabile di ambiente PATH.

Argomenti supportati

La tabella seguente descrive gli argomenti supportati per gactions:

Argomento Descrizione
help, h Restituisce come output il testo della guida per questo strumento. Ad esempio: 
gactions help

Per visualizzare il testo della guida per un argomento specifico, utilizza la seguente sintassi:

gactions help argument

Ad esempio:

gactions help test
get Ottieni i contenuti del progetto (azioni + metadati). Utilizza la sintassi seguente: 
gactions get --project PROJECT_ID
init Crea un file action.json predefinito nella directory corrente con la seguente sintassi: 
gactions init

Se esiste già un file action.json, puoi sovrascriverlo aggiungendo l'argomento --force, come illustrato nell'esempio seguente:

gactions init --force
list Elenca fino a 10 versioni recenti del tuo progetto Actions: in revisione, in produzione, approvate e così via, con la seguente sintassi: 
gactions list --project PROJECT_ID
test Esegue il push di un pacchetto di azioni ad Assistant Platform per i test con la seguente sintassi: 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

Ad esempio:

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

Facoltativamente, puoi disabilitare i test nell'ambiente sandbox con il flag
--disable_sandbox.

Il flag --preview_mins è deprecato.
update Aggiorna il pacchetto azioni per il progetto in questione con la seguente sintassi: 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

Ad esempio:

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

Per utilizzare l'argomento update, devi usare l'ID progetto dell'azione. Puoi ottenere l'ID progetto facendo clic sull'icona a forma di ingranaggio delle impostazioni nel progetto Actions on Google e poi su Impostazioni progetto.

Se il tuo progetto Actions supporta più lingue, consulta la documentazione del pacchetto Action.
selfupdate gactions controlla automaticamente la presenza di aggiornamenti prima dell'esecuzione di ogni comando, ma puoi forzare il controllo con selfupdate 
gactions selfupdate

Visualizza output dettagliato

Per visualizzare un output più dettagliato durante l'elaborazione, aggiungi il flag --verbose. Ad esempio:

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

Esempio di action.json predefinito

Quando esegui gactions init nella directory del progetto, generi un file action.json predefinito in quella directory:

{
  "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>"
}