gactions CLI (Dialogflow)

gactions הוא ממשק שורת הפקודה שבו אתם משתמשים כדי לבדוק ולעדכן את פרויקט פעולות.

ארכיטקטורת המערכת

כדי לבחור את ההורדה המתאימה, עליכם למצוא את ארכיטקטורת המערכת.

  • במכשירי Mac OS X ו-Linux, אפשר לראות את ארכיטקטורת המעבד (CPU) של המחשב באמצעות הפקודה בטרמינל uname -a

  • במכשירי Windows 10, צריך לפעול לפי השלבים הבאים כדי למצוא את הארכיטקטורה של המעבד (CPU):

    1. פותחים את ההגדרות.

    2. לוחצים על מערכת.

    3. לוחצים על מידע כללי.

הורדות

אפשר להוריד את gactions בהתאם למערכת ההפעלה (בהמשך).

מערכת ההפעלה הורדות
Windows
Mac
Linux

דרישות

  • מגדירים את ההרשאות המתאימות כדי להפוך את הקובץ להורדה לניתן להפעלה.
    • ב-Mac וב-Linux, מריצים את chmod +x gactions כדי ליצור את קובץ ההפעלה הבינארי.
    • ב-Windows, צריכות להיות לכם הרשאות אדמין.
  • מיקום ההורדה gactions חייב להיות במשתנה הסביבה PATH.

ארגומנטים נתמכים

בטבלה הבאה מתוארים הארגומנטים הנתמכים של gactions:

ארגומנט תיאור
help, h יוצר את טקסט העזרה של הכלי הזה. מוצרים לדוגמה: 
gactions help

כדי להציג את טקסט העזרה עבור ארגומנט ספציפי, השתמשו בתחביר הבא:

gactions help argument

לדוגמה:

gactions help test
get הצגת התוכן של הפרויקט הנתון (פעולות + מטא-נתונים). צריך להשתמש בתחביר הבא: 
gactions get --project PROJECT_ID
init ייווצר קובץ action.json שמוגדר כברירת מחדל בספרייה הנוכחית עם התחביר הבא: 
gactions init

אם כבר יש קובץ action.json, אפשר להחליף אותו על ידי הוספת הארגומנט --force, כמו בדוגמה הבאה:

gactions init --force
list הרשימה כוללת עד 10 גרסאות אחרונות של פרויקט Actions: בבדיקה, ייצור, מאושר וכו', עם התחביר הבא: 
gactions list --project PROJECT_ID
test דוחפת חבילת פעולה ל-Assistant Platform כדי לבצע בדיקה עם הדברים הבאים תחביר: 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

לדוגמה:

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

אפשר להשבית את הבדיקה בסביבת Sandbox עם הדגל
--disable_sandbox.

הדגל --preview_mins הוצא משימוש.
update עדכון חבילת הפעולה של הפרויקט הנתון עם התחביר הבא: 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

לדוגמה:

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

כדי להשתמש בארגומנט update, צריך להשתמש במזהה הפרויקט של הפעולה. אפשר לקבל את מזהה הפרויקט שלך על ידי לחיצה על סמל גלגל השיניים פרויקט Actions on Google ולאחר מכן Project Settings.

אם בפרויקט 'פעולות' יש תמיכה בכמה שפות, מסמכים של חבילות פעולות.
selfupdate gactions בודק באופן אוטומטי אם יש עדכונים לפני שכל פקודה רצה, אבל אפשר לאלץ מבצעים בדיקה עם selfupdate 
gactions selfupdate

הצגת פלט מפורט

כדי להציג פלט מפורט יותר במהלך העיבוד, צריך להוסיף את הדגל --verbose. לדוגמה:

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

דוגמה לברירת מחדל של action.json

כשמריצים את הפקודה gactions init בספריית הפרויקט, יוצרים ברירת מחדל הקובץ action.json בספרייה הזו:

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