gactions CLI (Dialogflow)
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
gactions رابط خط فرمانی است که برای آزمایش و به روز رسانی پروژه Actions خود استفاده می کنید.
معماری سیستم
برای انتخاب دانلود مناسب، باید معماری سیستم خود را پیدا کنید.
دانلودها
می توانید 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 خود استفاده کنید. با کلیک کردن روی settings چرخ دنده تنظیمات در پروژه 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>"
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]
