interfaccia a riga di comando gactions (Dialogflow)

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

Architettura di sistema

Per selezionare il download corretto, dovrai individuare 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, attieniti alla seguente procedura per trovare l'architettura della CPU:

    1. Apri Impostazioni.

    2. Fai clic su Sistema.

    3. Fai clic su Informazioni.

Download

Puoi scaricare gactions per il tuo sistema operativo (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 file binario.
    • Su Windows, devi disporre dei diritti di amministratore.
  • Il percorso di download gactions deve essere nella variabile di ambiente PATH.

Argomenti supportati

Nella tabella seguente vengono descritti gli argomenti supportati per gactions:

Argomento Descrizione
help, h Restituisce 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 Recupera i contenuti del progetto specificato (Azioni + metadati). Utilizza la seguente sintassi: 
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 il metodo Argomento --force, come mostrato nell'esempio seguente:

gactions init --force
list Elenca fino a 10 versioni recenti del progetto Actions: in revisione, produzione, approvato e così via, con la seguente sintassi: 
gactions list --project PROJECT_ID
test Esegue il push di un pacchetto di azioni alla piattaforma Assistant per eseguire test con quanto segue sintassi: 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

Ad esempio:

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

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

Il flag --preview_mins è deprecato.
update Aggiorna il pacchetto Action per il progetto specificato 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 del tuo ID progetto facendo clic sull'icona a forma di ingranaggio delle impostazioni Progetto Actions on Google seguito da Impostazioni progetto.

Se il progetto Actions supporta più lingue, consulta le Documentazione relativa al pacchetto Action.
selfupdate gactions verifica automaticamente la presenza di aggiornamenti prima dell'esecuzione di ciascun comando, ma puoi forzare che verifica 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 valore action.json file 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>"
}