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 نُسخ حديثة من مشروع المهام: قيد المراجعة، والإنتاج، وموافَق عليه، وما إلى ذلك، باستخدام البنية التالية:
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 تبحث الأدوات تلقائيًا عن التحديثات قبل تشغيل كل أمر، ولكن يمكنك فرض البحث باستخدام 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>"
}