تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
gactions CLI (Dialogflow)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
gactions هي واجهة سطر الأوامر التي تستخدمها لاختبار وتحديث
مشروع الإجراءات.
بنية النظام
لاختيار عملية التنزيل المناسبة، ستحتاج إلى العثور على بنية النظام.
في أجهزة Mac OS X وLinux، يمكنك العثور على بنية وحدة المعالجة المركزية (CPU) لجهاز الكمبيوتر باستخدام الأمر الطرفي
uname -a
على أجهزة Windows 10، اتّبِع الخطوات التالية للعثور على بنية وحدة المعالجة المركزية (CPU):
افتح الإعدادات.
انقر على System (النظام).
انقر على لمحة.
عمليات التنزيل
يمكنك تنزيل 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، يجب استخدام رقم تعريف مشروع الإجراء الخاص بك. يمكنك الحصول على
رقم تعريف المشروع من خلال النقر على رمز ترس الإعدادات settings في
مشروع "المهام مع مساعد 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>"
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003egactions\u003c/code\u003e is a command-line interface used to test and manage Actions projects, providing functionalities like updating, testing, and retrieving project data.\u003c/p\u003e\n"],["\u003cp\u003eDownloads for \u003ccode\u003egactions\u003c/code\u003e are available for Windows, Mac, and Linux operating systems, with options for different system architectures like x86_64, i386, and arm.\u003c/p\u003e\n"],["\u003cp\u003eBefore using \u003ccode\u003egactions\u003c/code\u003e, ensure it is executable and its location is added to your system's \u003ccode\u003ePATH\u003c/code\u003e environment variable.\u003c/p\u003e\n"],["\u003cp\u003eKey functionalities include \u003ccode\u003einit\u003c/code\u003e to create an \u003ccode\u003eaction.json\u003c/code\u003e file, \u003ccode\u003etest\u003c/code\u003e to deploy for testing, \u003ccode\u003eupdate\u003c/code\u003e to push updates, and \u003ccode\u003eget\u003c/code\u003e to retrieve project content.\u003c/p\u003e\n"],["\u003cp\u003eFor detailed information about \u003ccode\u003egactions\u003c/code\u003e usage and available arguments, use the \u003ccode\u003ehelp\u003c/code\u003e command or consult the provided documentation.\u003c/p\u003e\n"]]],[],null,["# gactions CLI (Dialogflow)\n\n`gactions` is the command line interface that you use to test and update your\nActions project.\n\nSystem architecture\n-------------------\n\nTo select the proper download, you'll need to find your system architecture.\n\n- On Mac OS X and Linux devices, you can find your computer's CPU architecture using the terminal command\n `uname -a`.\n\n- On Windows 10 devices, take the following steps to find the CPU architecture:\n\n 1. Open **Settings**\n\n 2. Click **System**\n\n 3. Click **About**\n\nDownloads\n---------\n\nYou can download `gactions` for your operating system (below).\n\n| OS | Downloads |\n|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Windows | - [x86_64](https://dl.google.com/gactions/updates/bin/windows/amd64/gactions.exe/gactions.exe) - [i386](https://dl.google.com/gactions/updates/bin/windows/386/gactions.exe/gactions.exe) |\n| Mac | - [x86_64](https://dl.google.com/gactions/updates/bin/darwin/amd64/gactions/gactions) - [i386](https://dl.google.com/gactions/updates/bin/darwin/386/gactions/gactions) |\n| Linux | - [x86_64](https://dl.google.com/gactions/updates/bin/linux/amd64/gactions/gactions) - [i386](https://dl.google.com/gactions/updates/bin/linux/386/gactions/gactions) - [arm](https://dl.google.com/gactions/updates/bin/linux/arm/gactions) |\n\nRequirements\n------------\n\n- Make the downloaded file executable by setting the appropriate permissions.\n - On Mac and Linux, run `chmod +x gactions` to make the binary executable.\n - On Windows, you must have Administrator rights.\n- The `gactions` download location must be in your `PATH` environment variable.\n\nSupported arguments\n-------------------\n\nThe following table describes the supported arguments for `gactions`:\n\n| Argument | Description |\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `help`, `h` | Outputs the help text for this tool. For example: ``` gactions help ``` To view the help text for a specific argument, use the following syntax: ``` gactions help argument ``` For example: ``` gactions help test ``` |\n| `get` | Get the content of the given project (Actions + metadata). Use the following syntax: ``` gactions get --project PROJECT_ID ``` |\n| `init` | Creates a default `action.json` file in the current directory with the following syntax: ``` gactions init ``` If there is already an existing `action.json` file, you can overwrite it by adding the `--force` argument, as the following example shows: ``` gactions init --force ``` |\n| `list` | Lists up to 10 recent versions of your Actions project: in review, production, approved, etc, with the following syntax: ``` gactions list --project PROJECT_ID ``` |\n| `test` | Pushes an action package to the Assistant Platform for testing with the following syntax: ``` gactions test --action_package PACKAGE_NAME --project PROJECT_ID ``` For example: ``` gactions test --action_package mypackage.json --project my-project-1234567 ``` You can optionally disable testing in the sandbox environment with the `--disable_sandbox` flag. `--preview_mins` flag is deprecated. |\n| `update` | Updates the Action package for the given project with the following syntax: ``` gactions update --action_package PACKAGE_NAME --project PROJECT_ID ``` For example: ``` gactions update --action_package action.json --project my-project-1234567 ``` To use the `update` argument, you must use your Action's Project ID. You can get your project ID by clicking the settings gear *settings* in your Actions on Google project followed by **Project Settings**. If your Actions project supports multiple languages, see the [Action package documentation.](/assistant/df-asdk/localization/action-packages) |\n| `selfupdate` | gactions automatically checks for updates before each command runs, but you can force that check with `selfupdate` ``` gactions selfupdate ``` |\n\nView verbose output\n-------------------\n\nTo view more detailed output during processing, add the `--verbose` flag. For example: \n\n```\ngactions --verbose test --action_package action.json --project my-project-1234567\n```\n\nDefault action.json example\n---------------------------\n\nWhen you run `gactions init` in your project directory, you generate a default\n`action.json` file in that directory: \n\n```text\n{\n \"actions\": [\n {\n \"description\": \"Default Welcome Intent\",\n \"name\": \"MAIN\",\n \"fulfillment\": {\n \"conversationName\": \"\u003cINSERT YOUR CONVERSATION NAME HERE\u003e\"\n },\n \"intent\": {\n \"name\": \"actions.intent.MAIN\",\n \"trigger\": {\n \"queryPatterns\": [\n \"talk to \u003cINSERT YOUR NAME HERE\u003e\"\n ]\n }\n }\n }\n ],\n \"conversations\": {\n \"\u003cINSERT YOUR CONVERSATION NAME HERE\u003e\": {\n \"name\": \"\u003cINSERT YOUR CONVERSATION NAME HERE\u003e\",\n \"url\": \"\u003cINSERT YOUR FULLFILLMENT URL HERE\u003e\"\n }\n },\n \"locale\": \"\u003cINSERT YOUR LANGUAGE HERE\u003e\"\n}\n```"]]
