대화형 작업이 2023년 6월 13일에 지원 중단되었습니다. 자세한 내용은
대화 작업 지원 중단을 참고하세요.
gactions CLI (Dialogflow)
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
gactions는 API를 테스트하고 업데이트하는 데 사용하는 명령줄 인터페이스입니다.
작업 프로젝트
시스템 아키텍처
적절한 다운로드를 선택하려면 시스템 아키텍처를 찾아야 합니다.
다운로드
아래에서 사용 중인 운영체제에 gactions를 다운로드할 수 있습니다.
| OS |
다운로드 |
| 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 |
다음을 사용하여 테스트할 수 있도록 작업 패키지를 어시스턴트 플랫폼에 푸시합니다.
구문:
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 인수를 사용하려면 작업의 프로젝트 ID를 사용해야 합니다. 얻을 수 있는 혜택
설정 톱니바퀴 settings를 클릭하여 프로젝트 ID를
Actions on 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 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\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```"]]
