gactions CLI (Dialogflow)

gactions رابط خط فرمانی است که برای آزمایش و به روز رسانی پروژه Actions خود استفاده می کنید.

معماری سیستم

برای انتخاب دانلود مناسب، باید معماری سیستم خود را پیدا کنید.

  • در دستگاه‌های Mac OS X و Linux، می‌توانید معماری CPU رایانه خود را با استفاده از دستور ترمینال uname -a پیدا کنید.

  • در دستگاه های ویندوز 10، مراحل زیر را برای یافتن معماری CPU انجام دهید:

    1. تنظیمات را باز کنید

    2. روی System کلیک کنید

    3. روی About کلیک کنید

دانلودها

می توانید gactions برای سیستم عامل خود دانلود کنید (در زیر).

سیستم عامل دانلودها
ویندوز
مک
لینوکس

الزامات

  • با تنظیم مجوزهای مناسب، فایل دانلود شده را قابل اجرا کنید.
    • در مک و لینوکس، chmod +x gactions را اجرا کنید تا باینری قابل اجرا باشد.
    • در ویندوز باید حقوق Administrator داشته باشید.
  • مکان دانلود 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 یک بسته اکشن را برای آزمایش با دستور زیر به پلتفرم دستیار فشار می دهد: 
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 بسته Action را برای پروژه داده شده با دستور زیر به روز می کند: 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

به عنوان مثال:

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

برای استفاده از آرگومان update ، باید از شناسه پروژه Action خود استفاده کنید. با کلیک کردن روی چرخ دنده تنظیمات در پروژه Actions on Google خود و سپس تنظیمات پروژه می توانید شناسه پروژه خود را دریافت کنید.

اگر پروژه Actions شما از چندین زبان پشتیبانی می کند، به مستندات بسته Action مراجعه کنید.

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