Tạo Hành động tùy chỉnh cho Trợ lý Google: 12 bước

2024 Tác giả: John Day | [email protected]. Sửa đổi lần cuối: 2024-01-30 13:32

Nhìn thấy tiềm năng của Trợ lý Google khi nó được trình bày trong Google I / O 18 cũng như Volvo Cars trong hệ thống thông tin giải trí của họ, tôi không thể cưỡng lại việc dùng thử nó. Tôi đã sử dụng lại một trong những dự án cũ hơn của mình, VasttraPi và giao diện nó với Trợ lý Google. Nếu bạn muốn đọc thêm về dự án, tôi sẽ rất vui nếu bạn xem bài viết liên quan trên blog của tôi: Hành động tùy chỉnh cho Trợ lý Google.

Trong Có thể hướng dẫn này, chúng tôi sẽ thực hiện các bước cần thiết để khởi chạy Hành động trợ lý Google của riêng bạn. Hành động này sẽ liên lạc với máy chủ của bạn và nói chuyện lại với bạn, liệt kê các chuyến khởi hành sắp tới. Xin lưu ý rằng chúng tôi sẽ không sử dụng SDK vì chúng tôi đang chạy điều này hoàn toàn trong Trợ lý Google chứ không phải thiết bị của riêng chúng tôi. Nhìn chung, nó sẽ được giữ đơn giản. Hành động của bạn sẽ có thể sử dụng được trên các thiết bị hỗ trợ Trợ lý Google như điện thoại, máy tính bảng, trợ lý tại nhà và thiết bị đeo được và bạn thậm chí có thể chia sẻ hành động đó như cách bạn làm với một ứng dụng trên Cửa hàng Play!

Một trong những lợi thế chính của việc tạo thứ gì đó như thế này so với việc sử dụng các dịch vụ như IFTTT là bạn có thể tạo phản hồi tùy chỉnh trong máy chủ của mình mà Trợ lý Google sẽ đọc. Trong IFTTT, giao tiếp theo tôi là một chiều.

Các chủ đề sau sẽ được đề cập:

• Tạo dự án hành động đầu tiên của bạn
• Tạo Ý định tùy chỉnh của bạn
• Tạo thực thể tùy chỉnh của bạn
• Đặt webhook để thực hiện hành động của bạn
• Thiết lập một máy chủ REST đơn giản, được viết bằng Python với Flask, sẽ cung cấp các phản hồi hoặc "thực hiện"
• Kiểm tra dự án Hành động của bạn
• Phát hành dự án hành động của bạn

Tại đây, bạn sẽ không tìm thấy nhiều chi tiết hoặc lý thuyết về các chức năng và khái niệm khác nhau của Trợ lý Google. Nếu bạn quan tâm đến chúng, tôi thực sự khuyên bạn nên làm theo hướng dẫn chính thức hoặc xem video này.

Bước 1: Đặt quyền cho tài khoản Google của bạn

Trước khi bắt đầu, chúng tôi cần đảm bảo Trợ lý Google có các quyền thích hợp.

1. Đi tới Kiểm soát hoạt động

2. Đảm bảo rằng những điều sau được bật:

   1. Hoạt động web và ứng dụng
   2. Thông tin thiết bị
   3. Hoạt động âm thanh và giọng nói

Bước 2: Tạo hành động của bạn

1. Đi tới Bảng điều khiển hành động và nhấp vào "Thêm / nhập dự án"
2. Hãy gọi dự án Hành động này là "local-traffic-planner".
3. Nhấp vào "Tạo dự án".
4. Trên trang tiếp theo, không chọn một danh mục và nhấp vào "Bỏ qua".
5. Bây giờ, bạn sẽ ở trang Bảng điều khiển hành động chính.

Bước 3: Lời mời hành động

Xác định cách bạn muốn kích hoạt Trợ lý Google để bắt đầu hành động của mình.

1. Nhấp vào "Quyết định cách Hành động của bạn được gọi" trong "Thiết lập nhanh".
2. Gọi nó là "Công cụ lập kế hoạch giao thông địa phương của tôi" và nhấp vào "Lưu".

3. Nhấp vào lời nhắc "CẬP NHẬT MẪU MẪU MẪU" bật lên sau khi nhấp vào lưu.

   Bạn cũng có thể tìm thấy tùy chọn này trong "Thông tin thư mục"

4. Thêm "Hỏi người lập kế hoạch giao thông địa phương của tôi" làm lời gọi mới và nhấp vào "Lưu".

Bước 4: Thêm hành động đầu tiên của bạn

1. Nhấp vào "Tác vụ" trên thanh bên trái.
2. Nhấp vào "THÊM HÀNH ĐỘNG ĐẦU TIÊN CỦA BẠN".
3. Chọn "Mục đích tùy chỉnh" và sau đó nhấp vào "Xây dựng".
4. Bạn sẽ được đưa đến trang Dialogflow, đây là nơi bạn sẽ triển khai logic chính.

Bước 5: Các cụm từ đào tạo cho ý định của bạn

1. Chọn múi giờ của bạn và nhấp vào "Tạo".
2. Trên trang tiếp theo, giữ nguyên ý định hiện có và nhấp vào "TẠO NỘI DUNG".
3. Đặt cho ý định một cái tên hợp lý, tức là "khởi hành".
4. Đi tới "Cụm từ đào tạo" và nhấp vào "Thêm cụm từ đào tạo".

5. Sử dụng các cụm từ sau để đào tạo mô hình của bạn để mô hình có thể diễn giải những gì bạn đang nói với nó:

   1. Tôi đang ở nhà ngay bây giờ
   2. Tạm thời tôi đang ở nhà
   3. Tôi đang ở căn hộ của chúng tôi vào lúc này
   4. Tôi đang ngồi ở nhà
   5. Hiện tại tôi đang ở gần nơi làm việc
   6. tôi đang ở chỗ làm
   7. tôi đang ở văn phòng
   8. Công việc
   9. Nhà

Bước 6: Thực thể

Bây giờ bạn đã chỉ định những gì nên được mong đợi nhiều hơn hoặc ít hơn như một đầu vào, chúng tôi cần xác định những phần nào của đầu vào quan tâm đến logic kinh doanh của chúng tôi để chúng có thể được trích xuất và đánh dấu vào máy chủ của chúng tôi. Trong trường hợp của chúng tôi, chúng tôi muốn biết liệu người dùng đang ở nhà hay đang làm việc, vì vậy chúng tôi có thể phản hồi lại các chuyến khởi hành từ nhà ga cụ thể. Hãy xem làm thế nào chúng tôi có thể làm điều đó.

1. Nếu bạn nhấp đúp vào một hoặc nhiều từ của cụm từ đào tạo, bạn sẽ nhận được danh sách các thực thể được xác định trước. Bạn có thể đọc thêm về từng thực thể trong số chúng tại đây. Nhìn chung, cái phù hợp nhất sẽ là @ sys.location tuy nhiên tôi nghĩ tốt nhất và dễ nhất nếu chúng ta tạo thực thể của riêng mình mà chúng ta nên gọi là @ current-location.
2. Nhấp vào tùy chọn "Thực thể" ở phía bên trái.
3. Nhấp vào "TẠO ENTITY".

4. Đặt tên thành "current-location" và xác định hai giá trị tham chiếu cùng với các từ đồng nghĩa của chúng:

   1. Trang Chủ

      nhà, nhà, căn hộ, cũi

   2. công việc

      công việc, văn phòng, Aptiv, mỏ mã (chỉ đùa thôi)

5. Nhấp vào "Lưu. Để có thêm hiệu ứng, bạn cũng có thể nhấp vào" Cho phép mở rộng tự động "để cho Trợ lý Google thêm quyền tự do để thử và so khớp nhiều từ đồng nghĩa hơn với các giá trị tham chiếu của bạn.

Bước 7: Hành động và Tham số

Đã đến lúc cung cấp một số ý nghĩa cho các từ khóa bên trong các cụm từ đào tạo của bạn.

1. Nhấp vào "Ý định" và sau đó điều hướng đến Ý định tùy chỉnh của bạn, tức là "khởi hành" nếu bạn đã làm theo các đề xuất tên của tôi.
2. Cuộn xuống "Cụm từ đào tạo".
3. Nhấp đúp vào các từ cho biết vị trí hiện tại của bạn và chọn thẻ @ current-location từ cửa sổ bật lên.
4. Cuộn xuống "Hành động và thông số", nhấp vào "quản lý"
5. Nếu mọi thứ được thực hiện chính xác, bạn sẽ thấy thực thể mới của mình được liệt kê ở đó.
6. Chọn hộp "Bắt buộc" để xuất hiện cột mới, "Lời nhắc". Lời nhắc là những gì người dùng sẽ nghe nếu không có gì phù hợp với mong đợi đã được cung cấp.
7. Nhấp vào "Xác định lời nhắc" và chèn một cái gì đó như "Tôi không hiểu vị trí của bạn. Hiện tại bạn đang ở đâu?".

Bước 8: Hoàn thành

Bây giờ đã đến lúc kết nối dịch vụ web của bạn với Hành động của Trợ lý Google. Hook của bạn sẽ được gọi khi ý định cụ thể này được kích hoạt và sẽ tạo ra việc thực hiện hành động này. Trước đó, chúng tôi cũng muốn thiết lập ý định của mình để kết thúc hành động sau khi hoàn thành.

1. Đi tới "Câu trả lời" và nhấp vào "THÊM PHẢN HỒI".
2. Không thêm bất kỳ câu trả lời nào, chỉ cần bật "Đặt mục đích này là kết thúc cuộc trò chuyện".
3. Cuộn xuống "Hoàn thành" nhấp vào "BẬT ĐẦY ĐỦ" và sau đó bật "Bật lệnh gọi webhook cho mục đích này".
4. Nhấp vào "Lưu" và sau đó chuyển đến tùy chọn "Hoàn thành" ở phía bên trái.

5. Bật tùy chọn "Webhook" và chèn URL đang được máy chủ web của bạn "lắng nghe".

   Bất cứ khi nào ý định được kích hoạt, nó sẽ gửi một yêu cầu ĐĂNG đến trang web của bạn với nội dung yêu cầu chứa một đối tượng JSON với vị trí hiện tại của người dùng

6. Nhấp vào để lưu.
7. Bây giờ chúng tôi đã sẵn sàng tạo dịch vụ web của mình, nhưng trước đó, hãy đảm bảo rằng Hành động của chúng tôi chào đón chúng tôi một cách thích hợp.

Bước 9: Ý định chào mừng

Để tùy chỉnh trải nghiệm người dùng, chúng tôi nên tạo lời chào thích hợp cho chúng tôi bất cứ khi nào chúng tôi kích hoạt hành động của mình.

1. Đi tới "Ý định" và sau đó nhấp vào "Ý định chào mừng mặc định".
2. Cuộn xuống "Câu trả lời", xóa những câu trả lời hiện có và chèn những gì bạn muốn hành động của mình như thế nào để chào đón bạn sau khi nó được bắt đầu.
3. Nhấp vào để lưu".

Bước 10: Dịch vụ web Python của bạn

Hãy tạo một máy chủ Python nhanh chóng và bẩn thỉu bằng Flask. Không có ảnh chụp màn hình cho bước này, nhưng nó sẽ khá thẳng về phía trước.

1. Mở tab mới và tạo tài khoản trên pythonanywhere.com
2. Xác nhận email của bạn.
3. Thiết lập ứng dụng web của bạn bằng cách nhấp vào "Mở tab web".
4. Nhấp vào "Thêm ứng dụng web mới" và chọn "Flask" làm khuôn khổ web Python của bạn.
5. Chọn Python 3.6 và nhấp vào "Tiếp theo".
6. Chọn đường dẫn mà bạn muốn "flask_app.py" của bạn cư trú. Tôi đã đặt nó ngay bên trong thư mục chính của tôi là "/home/your-username/flask_app.py".
7. Quay lại trang chính bằng cách nhấp vào biểu tượng Python ở góc trên bên trái.
8. Trong các tệp, nhấp vào "flask_app.py" để bắt đầu chỉnh sửa nó.
9. Khi trình chỉnh sửa văn bản web mở ra, hãy dán đoạn mã sau và nhấp vào "Lưu". Ý tưởng tổng thể là tùy thuộc vào JSON được phân tích cú pháp đến từ Google Asssistant, máy chủ của chúng tôi sẽ thực hiện một hành động (ví dụ: đọc hoặc ghi) và báo cáo lại dưới dạng phản hồi / sự hoàn thành cần được đọc cho người dùng.
10. Nhấp vào "Mở tab web" một lần nữa và sau đó nhấp vào "Tải lại nút" màu xanh lá cây.
11. Bây giờ bạn sẽ có máy chủ web Python của riêng mình đang chạy tại "https://your-username.pythonanywhere.com/departures".

Bước 11: Kiểm tra hành động của bạn

OK, bây giờ bạn đã hoàn thành khá nhiều việc. Hãy kiểm tra toàn bộ ngăn xếp ngay bây giờ và làm cho ví dụ "Hello world" này hoạt động!

1. Nhấp vào "Tích hợp" từ thanh bên trái.
2. Nhấp vào "Cài đặt tích hợp" trong tùy chọn Trợ lý Google.
3. Trong "Lời kêu gọi ngầm, hãy thêm tên ý định của bạn, tức là" chuyến khởi hành "để nó có thể được kích hoạt trực tiếp bằng cách nói điều gì đó như" Này Google, hãy nói chuyện với người lập kế hoạch giao thông địa phương của tôi về các chuyến khởi hành từ nhà ".
4. Bật các thay đổi "Tự động xem trước".
5. Nhấp vào "Kiểm tra" sẽ mở ra một trang mới.
6. Nhập "Nói chuyện với người lập kế hoạch giao thông địa phương của tôi".
7. Hành động của bạn nên được gọi, hành động này sẽ chào đón bạn bằng một trong các phản hồi ý định chào mừng đã đặt trước đó.
8. Sau đó gõ "Tôi đang ở nơi làm việc". Máy chủ Python của bạn sẽ được liên hệ và Trợ lý Google sẽ đọc phản hồi.

Thật tuyệt phải không? Bây giờ, hãy tưởng tượng những gì bạn có thể làm khi tương tác với cảm biến, thiết bị truyền động và các API khác thông qua Trợ lý Google.

Bước 12: Đưa ra hành động của bạn

Sau khi bạn kiểm tra xong Hành động của mình và nó ở trạng thái tốt, đã đến lúc bạn chia sẻ tình yêu với thế giới hoặc, nếu điều đó không có ý nghĩa, với bạn bè và gia đình của bạn.

1. Quay lại bảng điều khiển Actions của bạn và chọn hành động của công cụ lập kế hoạch lưu lượng truy cập địa phương của bạn.
2. Trong "Sẵn sàng triển khai", nhấp vào "Nhập thông tin cần thiết để liệt kê Hành động của bạn trong thư mục Hành động".
3. Nhập mô tả ngắn, mô tả dài hơn, biểu trưng nhỏ, chi tiết liên hệ của bạn, liên kết chính sách bảo mật (nếu bạn không chia sẻ công khai điều này, chỉ cần đặt liên kết đến trang web của bạn hoặc thứ gì đó) và danh mục.
4. Cuộn lên và nhấp vào "Lưu".
5. Nhấp vào tùy chọn "Phát hành" từ thanh bên trái.
6. Tại đây, bạn có thể chọn Hành động của mình đang ở trạng thái nào. Nếu bạn không muốn nghe phản hồi "Hãy tải phiên bản thử nghiệm của My local traffic planner", bạn phải phát hành công khai chính thức. Tuy nhiên, điều đó yêu cầu Google đánh giá và sẽ không được đề cập trong hướng dẫn này. Thay vào đó, bạn vẫn có thể chia sẻ điều này với tối đa 20 người bằng cách chọn bản phát hành Alpha và thêm họ làm người thử nghiệm Alpha.
7. Thêm bất kỳ người thử nghiệm alpha nào bằng cách gửi cho họ liên kết hoặc thêm email của họ.
8. Click vào "SUBMIT FOR ALPHA", đánh dấu vào các ô, click "SUBMIT" và bạn đã hoàn tất!

Giờ đây, Hành động của bạn đang hoạt động và bạn và bạn bè của bạn có thể truy cập. Chúc vui vẻ!

Nếu bạn quan tâm đến mã tôi đã sử dụng, hãy xem dự án trên GitHub.