gactions CLI (Dialogflow)

gactions은 작업 프로젝트를 테스트하고 업데이트하는 데 사용하는 명령줄 인터페이스입니다.

시스템 아키텍처

적절한 다운로드를 선택하려면 시스템 아키텍처를 찾아야 합니다.

  • Mac OS X 및 Linux 기기에서는 터미널 명령어 uname -a를 사용하여 컴퓨터의 CPU 아키텍처를 찾을 수 있습니다.

  • Windows 10 기기에서는 다음 단계에 따라 CPU 아키텍처를 찾습니다.

    1. 설정을 엽니다.

    2. 시스템을 클릭합니다.

    3. 정보를 클릭합니다.

오프라인 저장 동영상

운영체제에 맞는 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를 사용해야 합니다. Actions on Google 프로젝트에서 설정 톱니바퀴 를 클릭한 후 프로젝트 설정을 클릭하면 프로젝트 ID를 가져올 수 있습니다.

작업 프로젝트가 여러 언어를 지원하는 경우 작업 패키지 문서를 참고하세요.

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>"
}