gactions CLI (Dialogflow)

gactions هي واجهة سطر الأوامر التي تستخدمها لاختبار وتحديث مشروع الإجراءات.

بنية النظام

لاختيار عملية التنزيل المناسبة، ستحتاج إلى العثور على بنية النظام.

  • في أجهزة Mac OS X وLinux، يمكنك العثور على بنية وحدة المعالجة المركزية (CPU) لجهاز الكمبيوتر باستخدام الأمر الطرفي uname -a

  • على أجهزة Windows 10، اتّبِع الخطوات التالية للعثور على بنية وحدة المعالجة المركزية (CPU):

    1. افتح الإعدادات.

    2. انقر على System (النظام).

    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 إصدارات حديثة من مشروع "المهام": قيد المراجعة، أو الإنتاج أو المُوافَق عليه أو غير ذلك باستخدام البنية التالية: 
gactions list --project PROJECT_ID
test إرسال حزمة إجراءات إلى منصة "مساعد Google" للاختبار باستخدام ما يلي بناء الجملة: 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

على سبيل المثال:

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

يمكنك اختياريًا إيقاف الاختبار في بيئة وضع الحماية باستخدام العلامة
--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، يجب استخدام رقم تعريف مشروع الإجراء الخاص بك. يمكنك الحصول على رقم تعريف المشروع من خلال النقر على رمز ترس الإعدادات في مشروع "المهام مع مساعد Google" متبوعًا بإعدادات المشروع.

إذا كان مشروع الإجراءات يتيح استخدام لغات متعددة، راجِع مستندات حزمة الإجراءات:
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>"
}