Actions SDK 및 빌더 빠른 시작 가이드

이 가이드에서는 환경을 설정하여 작업을 빌드하는 방법을 설명합니다. Actions SDK와 Actions Builder를 모두 사용할 수 있습니다. 다음 작업을 수행합니다.

  • Node.js 설치: Node.js를 사용하려면 이 런타임 환경이 필요합니다. fulfillment 라이브러리를 제공합니다.
  • Firebase CLI 설치: 이 명령줄 도구를 사용하면 Interactive Canvas용 웹 앱과 같은 Firebase 종속 항목을 배포하여 Firebase 호스팅으로 이동합니다.
  • gactions 명령줄 도구 설치: 작업을 사용하여 개발하는 경우 SDK를 사용한다면 이 도구를 사용하여 있습니다.
  • 작업 프로젝트 만들기: 작업 프로젝트는 논리적 컨테이너입니다. 확인할 수 있습니다. 먼저 Actions 콘솔에서 계정을 만들어야 합니다. 빌드를 시작할 수 있습니다
  • 샘플 초기화 및 배포: 이 간단한 샘플은 샘플 SDK를 Interactive Canvas로 작업을 빌드하기 시작했습니다

이 빠른 시작을 완료하면 로컬 개발 환경 및 Actions Builder의 웹 환경에 적응할 수 있습니다.

Node.js 및 Firebase CLI 설치

Node.js에 따라 Node.js 다운로드 및 설치 Google의 처리 라이브러리 사용 설명서를 참조하세요. Node.js 설치도 를 사용하면 npm으로 Firebase CLI를 설치하고 이상에서는 명령어를 실행하여 대화형 fulfillment 구현을 제공합니다.

요구사항에 따라 Firebase CLI를 설치 및 설정합니다. 참조하세요. Firebase CLI를 사용하면 양방향 캔버스 웹 앱을 Firebase 호스팅에 추가하고 필요한 경우 수동으로 배포 fulfillment를 Firebase용 Cloud Functions에 추가합니다.

gactions 명령줄 도구 설치

다음을 다운로드하여 gactions 명령줄 인터페이스 (CLI) 도구를 설치합니다. 실행 경로를 구성하고, 압축을 풀고, 실행 경로를 구성할 수 있습니다.

gactions를 설치하고 구성하려면 다음 단계를 따르세요.

  1. 운영체제에 적합한 패키지를 다운로드합니다.

    플랫폼 패키지 체크섬
    Windows 다운로드 SHA256
    Linux 다운로드 SHA256
    MacOS 다운로드 SHA256
  2. 원하는 위치에 패키지를 추출하고 환경의 PATH 변수입니다. 또는 패키지를 PATH 변수에 이미 있는 위치 (예: /usr/local/bin)

  3. Linux 및 Mac에서는 필요한 경우 실행 권한을 사용 설정합니다.

    chmod +x PATH_TO/gactions
  4. 다음 명령어를 실행하여 CLI를 인증합니다. 이 명령어는 인증 흐름을 시작하고 웹브라우저가 필요합니다.

    gactions login

    흐름이 완료되면 CLI가 자동으로 인증됩니다.

프로젝트 만들기 및 설정

gactions 명령줄 도구를 사용하려면 먼저 gactions에 프로젝트에 대한 액세스 권한을 부여합니다 생성 및 설정 시작하려면 다음을 실행하세요.

  1. Actions 콘솔로 이동합니다.
  2. 새 프로젝트를 클릭하고 프로젝트 이름을 입력한 다음 프로젝트 만들기를 클릭합니다.
  3. 카테고리를 선택하고 다음을 클릭합니다.
  4. Blank project를 선택하고 Start building을 클릭합니다.
  5. 다음 단계에 따라 Google Cloud 콘솔에서 Actions API를 사용 설정합니다. 자세한 내용은 사용 및 사용 중지 API를 참고하세요. 이렇게 하면 gaction이 프로젝트와 상호작용할 수 있습니다.

Hello World 샘플 가져오기

Hello World 대화형 샘플은 간단한 작업을 빌드하는 방법을 보여줍니다. Interactive Canvas로 구동되는 단일 작업으로 구성된 프로젝트를 빌드할 수 있습니다.

  1. 빈 디렉터리를 만들고 Interactive Canvas 샘플을 해당 디렉토리에 저장합니다 예를 들어 다음 코드는 예시로 사용된 interactive-canvas-sample/ 디렉터리 다음 사항을 참조하세요.

    gactions init interactive-canvas --dest interactive-canvas-sample
    cd interactive-canvas-sample
    
  2. interactive-canvas-sample/sdk/settings/settings.yaml 파일을 엽니다. projectId 필드의 값을 프로젝트 ID로 변경합니다.

샘플 배포 및 테스트

샘플을 설정한 후에는 Interactive Canvas 웹 앱을 배포하고 확인할 수 있습니다 이 과정에서 작업의 초안 버전이 생성됩니다. 다음과 같이 미리보기 및 테스트를 위해 작업 시뮬레이터에 배포할 수 있는 프로젝트입니다.

  1. interactive-canvas-sample/ 디렉터리에서 다음 명령어를 실행합니다. Interactive Canvas 웹 앱 (public/ 디렉터리 참조).

    firebase deploy --project PROJECT_ID --only hosting
    

    렌더링된 웹 앱 버전은 브라우저의 Firebase CLI: https://PROJECT_ID.web.app

  2. interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js 파일을 엽니다. CANVAS_URL 변수의 값을 프로젝트의 웹 앱 URL로 변경합니다.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';
    
  3. interactive-canvas-sample/sdk/ 디렉터리에서 다음을 실행합니다. 명령어를 사용하여 작업 프로젝트의 로컬 버전을 초안 버전:

    gactions push
    
    드림
  4. interactive-canvas-sample/sdk/ 디렉터리에서 다음을 실행합니다. 명령어를 사용하여 시뮬레이터에서 작업 프로젝트를 테스트합니다.

    gactions deploy preview
    
    드림
  5. 명령줄 도구에서 반환하는 링크를 열어 시뮬레이터로 이동합니다.

  6. 시뮬레이터에서 "Talk to Interactive canvas sample"을 입력하여 작업을 시작합니다. 나 다음 위치에 배포된 웹 앱이 제공하는 회전하는 삼각형이 표시됩니다. https://PROJECT_ID.web.app

    <ph type="x-smartling-placeholder">
    </ph>
    그림 1. 시뮬레이터의 작업 프로젝트 미리보기
    를 통해 개인정보처리방침을 정의할 수 있습니다.