gactions CLI (Dialogflow)

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

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

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

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

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

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

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

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

הורדות

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

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

דרישות

• מגדירים את ההרשאות המתאימות כדי שהקובץ שהורדתם יהיה ניתן להפעלה.
  • ב-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 גרסאות אחרונות של פרויקט הפעולות: בבדיקה, בסביבת ייצור, אושרו וכו', עם התחביר הבא: 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. אם הפרויקט ב-Actions תומך במספר שפות, עיינו בתיעוד של חבילת הפעולות.
selfupdate	אינטראקציות ראשוניות בודקות באופן אוטומטי אם יש עדכונים לפני כל פקודה, אבל אפשר לאלץ את הבדיקה באמצעות 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>"
}