Kể từ ngày 13 tháng 6 năm 2023, Hành động trò chuyện không còn được dùng nữa. Để biết thêm thông tin, hãy xem phần Hành động trò chuyện ngừng hoạt động.
Hướng dẫn bắt đầu nhanh SDK và Trình tạo hành động
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này chỉ cho bạn cách thiết lập môi trường để tạo các Hành động bằng cách sử dụng
cả SDK Actions (SDK Hành động) và Trình tạo hành động. Bạn sẽ phải thực hiện các tác vụ sau:
Cài đặt Node.js: Bạn cần có môi trường thời gian chạy này để sử dụng Node.js của chúng tôi
thư viện phương thức thực hiện.
Cài đặt Firebase CLI: Công cụ dòng lệnh này cho phép bạn phát triển và
triển khai các phần phụ thuộc của Firebase, chẳng hạn như ứng dụng web cho Canvas tương tác để
Lưu trữ Firebase.
Cài đặt công cụ dòng lệnh g actions:Khi phát triển bằng Actions
SDK, bạn sẽ sử dụng công cụ này để tạo, quản lý và triển khai Gói hành động cho
Hành động của bạn.
Tạo dự án Actions:Dự án Actions là vùng chứa logic
cho Hành động trò chuyện. Bạn phải tạo một hành động trong Bảng điều khiển Actions trước khi
có thể bắt đầu xây dựng.
Khởi động và triển khai một mẫu: Mẫu đơn giản này cho bạn biết cách để
đã bắt đầu tạo Actions hoạt động dựa trên Interactive Canvas.
Sau khi hoàn tất bước bắt đầu nhanh này, bạn có thể đồng bộ hoá dự án Actions của mình giữa
môi trường phát triển tại địa phương của bạn và trải nghiệm web của Actions Builder.
Cài đặt Node.js và Firebase CLI
Tải xuống và cài đặt Node.js theo Node.js
để sử dụng thư viện phương thức thực hiện của chúng tôi. Bạn cũng có thể cài đặt Node.js
cho phép bạn cài đặt Firebase CLI với npm và sau đó, để chạy
cục bộ phương thức thực hiện trò chuyện.
Cài đặt và thiết lập Firebase CLI theo
tài liệu về Firebase. Firebase CLI cho phép bạn triển khai báo cáo Tương tác
Ứng dụng web Canvas sang tính năng Lưu trữ Firebase và nếu cần, hãy triển khai theo cách thủ công
phương thức thực hiện cho Cloud Functions cho Firebase.
Cài đặt công cụ dòng lệnh gaction
Cài đặt công cụ giao diện dòng lệnh gHành động (CLI) bằng cách tải một
cài đặt gói, giải nén gói đó và định cấu hình đường dẫn thực thi.
Để cài đặt và định cấu hình gHành động, hãy làm theo các bước sau:
Giải nén gói đó vào vị trí bạn chọn rồi thêm tệp nhị phân vào
biến PATH của môi trường. Ngoài ra, hãy trích xuất gói vào một
vị trí đã có trong biến PATH (ví dụ: /usr/local/bin).
Trên Linux và Mac, hãy bật quyền thực thi nếu cần:
chmod +x PATH_TO/gactions
Chạy lệnh sau để xác thực CLI. Lệnh này
bắt đầu quy trình xác thực và yêu cầu trình duyệt web:
gactions login
Khi luồng hoàn tất, CLI sẽ tự động xác thực.
Tạo và thiết lập dự án
Trước khi có thể sử dụng công cụ dòng lệnh gaction, bạn phải tạo một dự án trong
bảng điều khiển Actions và cấp quyền truy cập cho các hành động khác vào dự án. Để tạo và thiết lập
cho một dự án, hãy làm như sau:
Nhấp vào New project (Dự án mới), nhập tên dự án rồi nhấp vào Create project (Tạo dự án).
Chọn một danh mục rồi nhấp vào Tiếp theo.
Chọn Dự án trống rồi nhấp vào Bắt đầu tạo bản dựng.
Bật Actions API trong bảng điều khiển Google Cloud bằng cách làm theo hướng dẫn sau:
các hướng dẫn trong bài viết Bật và tắt
API.
Thao tác này cho phép các gHành động tương tác với dự án của bạn.
Tải mẫu Hello World
Mẫu tương tác Hello world (Xin chào thế giới) sẽ hướng dẫn bạn cách tạo một Thao tác đơn giản
dự án bằng một Hành động được hỗ trợ bởi Interactive Canvas.
Tạo một thư mục trống và khởi chạy mẫu Canvas tương tác trong
thư mục đó. Ví dụ: mã sau đây khởi chạy mẫu trong một
Thư mục interactive-canvas-sample/, được dùng làm ví dụ
trong tài liệu này:
Mở tệp interactive-canvas-sample/sdk/settings/settings.yaml và
thay đổi giá trị của trường projectId thành mã dự án.
Triển khai và kiểm thử mẫu
Sau khi thiết lập mẫu, bạn có thể triển khai ứng dụng web tương tác Canvas và
dự án Actions của bạn. Quá trình này sẽ tạo một phiên bản nháp của Hành động
dự án mà bạn có thể triển khai cho Trình mô phỏng hành động để xem trước và thử nghiệm:
Từ thư mục interactive-canvas-sample/, hãy chạy lệnh sau
để triển khai ứng dụng web Canvas tương tác (nội dung của public/
thư mục).
Bạn có thể xem phiên bản được hiển thị của ứng dụng web tại URL do
Firebase CLI trong trình duyệt:
https://PROJECT_ID.web.app.
Mở tệp interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js và
thay đổi giá trị của biến CANVAS_URL thành URL ứng dụng web của dự án.
const CANVAS_URL = 'https://PROJECT_ID.web.app';
Từ thư mục interactive-canvas-sample/sdk/, hãy chạy lệnh sau
dùng để đẩy phiên bản cục bộ của dự án Actions vào bảng điều khiển dưới dạng
phiên bản nháp:
gactions push
Từ thư mục interactive-canvas-sample/sdk/, hãy chạy lệnh sau
để kiểm thử dự án Actions trong trình mô phỏng:
gactions deploy preview
Mở đường liên kết mà công cụ dòng lệnh trả về để chuyển đến trình mô phỏng.
Trong trình mô phỏng, hãy nhập "Trò chuyện với mẫu canvas tương tác" để bắt đầu Hành động. Bạn
sẽ thấy một hình tam giác đang quay được hỗ trợ bởi ứng dụng web được triển khai lúc
https://PROJECT_ID.web.app
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eThis guide helps you set up your environment for building Google Actions using the Actions SDK and Actions Builder.\u003c/p\u003e\n"],["\u003cp\u003eYou'll install necessary tools like Node.js, Firebase CLI, and the \u003ccode\u003egactions\u003c/code\u003e command-line tool.\u003c/p\u003e\n"],["\u003cp\u003eThe guide includes steps to create an Actions project, initialize a sample, and deploy it for testing in the Actions simulator.\u003c/p\u003e\n"],["\u003cp\u003eYou'll learn to deploy the Interactive Canvas web app to Firebase Hosting and push your local Actions project to the console.\u003c/p\u003e\n"],["\u003cp\u003eAfter completing the setup, you can preview and test your Action in the Actions simulator by invoking it with a specific phrase.\u003c/p\u003e\n"]]],["To set up for building Actions, install Node.js and the Firebase CLI for fulfillment and web app deployment. Install the `gactions` CLI by downloading and configuring the appropriate package, then authenticate using `gactions login`. In the Actions console, create a new project, enable the Actions API, and use `gactions init` to set up the Interactive Canvas sample. Deploy the web app with `firebase deploy`, update the `CANVAS_URL` and push the Action using `gactions push`. Finally, preview and test the action in the simulator using `gactions deploy preview`.\n"],null,["# Actions SDK and Builder quick start guide\n\nThis guide walks you through setting up your environment to build Actions using\nboth the Actions SDK and Actions Builder. You'll carry out the following tasks:\n\n- **Install Node.js:** You need this runtime environment to use our Node.js fulfillment library.\n- **Install the Firebase CLI:** This command-line tool lets you develop and deploy Firebase dependencies, such as web apps for [Interactive Canvas](/assistant/interactivecanvas), to Firebase Hosting.\n- **Install the gactions command-line tool:** When developing with the Actions SDK, you use this tool to create, manage, and deploy the Action package for your Action.\n- **Create an Actions project:** An [Actions project](/assistant/conversational/build/projects) is the logical container for your Conversational Actions. You have to create one in the Actions console before you can start building.\n- **Initialize and deploy a sample:** This simple sample shows you how to get started building Actions powered by Interactive Canvas.\n\nOnce you complete this quick start, you can sync your Actions project between\nyour local development environment and the web experience of Actions Builder.\n\nInstall Node.js and the Firebase CLI\n------------------------------------\n\nDownload and install [Node.js](https://nodejs.org/) according to the Node.js\ndocumentation to use our fulfillment library. Your installation of Node.js also\nallows you to install the Firebase CLI with [npm](https://www.npmjs.com/), and later, to run your\nconversational fulfillment implementation locally.\n\nInstall and set up the [Firebase CLI](https://firebase.google.com/docs/cli#setup_update_cli) according\nto the Firebase documentation. The Firebase CLI lets you deploy an Interactive\nCanvas web app to Firebase Hosting and, if necessary, manually deploy\nfulfillment to Cloud Functions for Firebase.\n\nInstall the gactions command-line tool\n--------------------------------------\n\nInstall the gactions command line interface (CLI) tool by downloading an\ninstallation package, unpacking it, and configuring your execution path.\n\nTo install and configure gactions, follow these steps:\n\n1. Download the appropriate package for your operating system:\n\n | Platform | Package | Checksum |\n |----------|----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|\n | Windows | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_windows.zip) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_windows.zip.sha256) |\n | Linux | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_linux.tar.gz) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_linux.tar.gz.sha256) |\n | Mac OS | [Download](https://dl.google.com/gactions/v3/release/gactions-sdk_darwin.tar.gz) | [SHA256](https://dl.google.com/gactions/v3/release/gactions-sdk_darwin.tar.gz.sha256) |\n\n2. Extract the package to a location of your choice and add the binary to your\n environment's `PATH` variable. Alternatively, extract the package to a\n location that's already in your `PATH` variable (for example, `/usr/local/bin`).\n\n3. On Linux and Mac, enable execute permissions if necessary:\n\n ```scdoc\n chmod +x PATH_TO/gactions\n ```\n4. Run the following command to authenticate the CLI. This command\n starts an authentication flow and requires a web browser:\n\n ```text\n gactions login\n ```\n\n When the flow is complete, the CLI automatically authenticates.\n\nCreate and set up a project\n---------------------------\n\n| **Note:** Actions project creation is not supported in the gactions CLI.\n\nBefore you can use the gactions command-line tool, you must create a project in\nthe Actions console and give gactions access to the project. To create and set\nup a project, do the following:\n\n1. Go to the [Actions console](https://console.actions.google.com).\n2. Click **New project** , enter a project name, and click **Create project**.\n3. Select a category and click **Next**.\n4. Select **Blank project** and click **Start building**.\n5. Enable the **Actions API** in the Google Cloud console by following the instructions in [Enable and disable\n APIs](https://support.google.com/googleapi/answer/6158841). This allows gactions to interact with your project.\n\nGet the hello world sample\n--------------------------\n\nThe hello world interactive sample shows you how to build a simple Actions\nproject with a single Action powered by Interactive Canvas.\n\n1. Create an empty directory and initialize the Interactive Canvas sample in\n that directory. For example, the following code initializes the sample in an\n `interactive-canvas-sample/` directory, which is used as an example\n throughout this document:\n\n gactions init interactive-canvas --dest interactive-canvas-sample\n cd interactive-canvas-sample\n\n2. Open the `interactive-canvas-sample/sdk/settings/settings.yaml` file and\n change the value of the `projectId` field to your project's ID.\n\n | **Note:** To get your project's ID, first open your project in the Actions console and click the more *more_vert* icon. Then, select **Project settings** and copy the string in the **Project ID** field.\n\nDeploy and test the sample\n--------------------------\n\nAfter you set up the sample, you can deploy the Interactive Canvas web app and\nyour Actions project. This process creates a draft version of your Actions\nproject that you can deploy to the Actions simulator for previewing and testing:\n\n1. From the `interactive-canvas-sample/` directory, run the following command\n to deploy the Interactive Canvas web app (the contents of the `public/`\n directory).\n\n firebase deploy --project \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e --only hosting\n\n You can see a rendered version of the web app at the URL returned by the\n Firebase CLI in a browser:\n `https://`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.web.app`.\n2. Open the `interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js` file and\n change the value of the `CANVAS_URL` variable to your project's web app URL.\n\n const CANVAS_URL = 'https://\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e.web.app';\n\n3. From the `interactive-canvas-sample/sdk/` directory, run the following\n command to push the local version of your Actions project to the console as a\n draft version:\n\n gactions push\n\n | **Note:** You'll see some warnings related to not having some project settings and resources defined. You can safely ignore them or now.\n4. From the `interactive-canvas-sample/sdk/` directory, run the following\n command to test your Actions project in the simulator:\n\n gactions deploy preview\n\n | **Note:** If you are using a new project, you need to enable the [Cloud Functions\n | API](https://console.cloud.google.com/apis/library/cloudfunctions.googleapis.com) and associate a billing account with your project in Google Cloud. You can enable the Cloud Functions API by visiting the [Cloud Console](https://console.cloud.google.com/billing).\n5. Open the link that the command-line tool returns to go to the simulator.\n\n6. In the simulator, enter *\"Talk to Interactive canvas sample\"* to start the Action. You\n should see a spinning triangle powered by the web app deployed at\n `https://`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.web.app`\n\n **Figure 1**. The simulator previewing the Actions project"]]
