Triển khai Slack gateway cho Amazon Q, chuyên gia kinh doanh của bạn

bởi Gary Benattar và Bob Strahan | vào ngày 09 THÁNG 01 NĂM 2024 |

Amazon Q là một ứng dụng mới được tạo ra bằng trí tuệ nhân tạo có khả năng tạo ra, giúp người dùng hoàn thành công việc của họ. Amazon Q có thể trở thành chuyên gia kinh doanh được tùy chỉnh của bạn, giúp bạn khám phá nội dung, nảy ra ý tưởng hoặc tạo bản tóm tắt bằng cách sử dụng dữ liệu của công ty một cách an toàn và bảo mật. Bạn có thể sử dụng Amazon Q để trò chuyện, giải quyết vấn đề, tạo nội dung, đạt được hiểu biết và thực hiện các hành động bằng cách kết nối với các kho thông tin, mã nguồn, dữ liệu và hệ thống doanh nghiệp của công ty. Để biết thêm thông tin, xem Introducing Amazon Q, một trợ lý mới được tạo ra bằng trí tuệ nhân tạo (xem trước).

Tổng quan về giải pháp

Amazon Q thực sự mạnh mẽ đến khó tin. Hãy kiểm tra bản demo sau đây – thấy là tin!

Trong bản demo, ứng dụng Amazon Q của chúng tôi được điền thông tin với một loạt các bản báo cáo trắng của AWS. Bạn có thể điền thông tin vào ứng dụng chuyên gia kinh doanh Amazon Q của riêng bạn với các tài liệu và bài viết cơ sở kiến thức của công ty bạn, từ đó nó sẽ có khả năng trả lời các câu hỏi của bạn!

Tất cả mọi thứ bạn cần được cung cấp dưới dạng mã nguồn mở trên GitHub repo của chúng tôi.

Trong bài viết này, chúng tôi sẽ hướng dẫn bạn qua quá trình triển khai Amazon Q trong  AWS account của bạn và thêm nó vào Slack workspace của bạn. Khi bạn hoàn tất, bạn sẽ tự hỏi làm sao bạn đã quản lý mà không có nó!

Dưới đây là một số tính năng nó có thể thực hiện:

  • Phản hồi cho các tin nhắn – Trong tin nhắn trực tiếp (DMs), nó phản hồi cho tất cả các tin nhắn. Trong các kênh, nó chỉ phản hồi khi được @mention và phản hồi trong một luồng trò chuyện.
  • Hiển thị câu trả lời chứa markdown – Điều này bao gồm tiêu đề, danh sách, chữ in đậm, chữ in nghiêng, bảng và nhiều hơn nữa.
  • Theo dõi tâm trạng – Nó cung cấp các nút “Thumbs Up” và “Thumbs Down” để theo dõi tâm trạng của người dùng.
  • Cung cấp nguồn gốc – Nó cung cấp tham chiếu và liên kết tới các nguồn được sử dụng bởi Amazon Q.
  • Hiểu bối cảnh cuộc trò chuyện – Nó theo dõi cuộc trò chuyện và phản hồi dựa trên ngữ cảnh.
  • Giữ ý thức về nhiều người dùng – Khi được đề cập trong một luồng, nó biết ai nói gì và khi nào, giúp nó có thể đóng góp trong ngữ cảnh và tóm tắt luồng một cách chính xác khi được yêu cầu.
  • Xử lý tệp đính kèm – Nó có thể xử lý đến năm tệp đính kèm để trả lời câu hỏi về tài liệu, tóm tắt và nhiều hơn nữa.
  • Bắt đầu cuộc trò chuyện mới – Bạn có thể đặt lại và bắt đầu cuộc trò chuyện mới trong các kênh tin nhắn trực tiếp bằng cách sử dụng /new_conversation.

Trong các phần tiếp theo, chúng tôi sẽ hướng dẫn bạn cách triển khai dự án vào AWS account và  Slack workspace của bạn, sau đó bắt đầu thử nghiệm!

Yêu cầu tiên quyết:

Bạn cần có một AWS account và AWS Identity and Access Management (IAM) role có quyền tạo và quản lý các tài nguyên và thành phần cần thiết cho ứng dụng này. Nếu bạn chưa có AWS account, xem Hướng dẫn “Làm thế nào để tạo và kích hoạt một  Amazon Web Services account mới ?”

Bạn cũng cần có một ứng dụng chuyên gia kinh doanh Amazon Q hiện tại và hoạt động. Nếu bạn chưa thiết lập một, xem Hướng dẫn “Tạo một ứng dụng chuyên gia kinh doanh Amazon Q.”

Cuối cùng, bạn cần một Slack account và quyền tạo và xuất bản ứng dụng cho tổ chức Slack của bạn. Nếu bạn chưa có một, xem xem có thể công ty của bạn có thể tạo một tổ chức Slack sandbox để thử nghiệm, hoặc truy cập slack.com để tạo một tài khoản và không gian làm việc Slack miễn phí.

Triển khai các nguồn giải pháp

Chúng tôi đã cung cấp các mẫu AWS CloudFormation đã được xây dựng trước, triển khai tất cả những gì bạn cần trong AWS account của bạn.

Nếu bạn là một nhà phát triển và muốn xây dựng, triển khai hoặc xuất bản giải pháp từ mã nguồn, tham khảo tại  Developer README.

Hoàn tất các bước sau để khởi chạy ngăn xếp CloudFormation:

  1. Đăng nhập vào  AWS Management Console.
  2. Chọn một trong những nút Launch Stack sau đây cho AWS Region mong muốn của bạn để mở bảng điều khiển AWS CloudFormation và tạo một ngăn xếp mới.
  1. Về Stack name, nhập một tên cho ứng dụng của bạn (ví dụ: AMAZON-Q-SLACK-GATEWAY).
  1. Về AmazonQAppId, nhập ID ứng dụng Amazon Q hiện tại của bạn (ví dụ: 80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5). Bạn có thể sao chép nó từ Amazon Q console.
  1. Về AmazonQRegion, chọn Region nơi bạn đã tạo ứng dụng Amazon Q của mình (us-east-1 hoặc us-west-2).
  1. Về AmazonQUserId, nhập địa chỉ email ID người dùng Amazon Q (để trống để sử dụng địa chỉ email người dùng Slack làm ID).
  1. Về ContextDaysToLive, nhập độ dài thời gian để giữ metadata cuộc trò chuyện được lưu trong Amazon DynamoDB (bạn có thể để giá trị mặc định).

Khi tình trạng CloudFormation stack của bạn là CREATE_COMPLETE, chọn tab Outputs và giữ nó mở – bạn sẽ cần nó trong các bước sau.

Tạo ứng dụng của bạn trên Slack

Bây giờ, bạn có thể tạo ứng dụng của mình trên Slack. Hoàn tất các bước sau:

  1. Tạo một ứng dụng Slack tại https://api.slack.com/apps từ mã nguồn được tạo ra – sao chép và dán từ đầu ra ngăn xếp: SlackAppManifest.
  2. Chọn App Home trong thanh điều hướng và cuộn xuống đến phần Show Tabs.
  3. Bật Messages Tab.
  4. Chọn Allow users to send Slash commands and messages from the messages tab.

Đây là một bước cần thiết để cho phép người dùng của bạn gửi tin nhắn đến ứng dụng của bạn.

Thêm ứng dụng vào không gian làm việc của bạn

Bây giờ, bạn có thể thêm ứng dụng vào không gian làm việc của mình. Điều này là cần thiết để tạo giá trị token OAuth của người dùng bot cần thiết trong bước tiếp theo.

  1. Điều hướng đến OAuth & Permissions (tại https://api.slack.com) và chọn Install to Workspace để tạo mã token OAuth.
  2. Trong Slack, điều hướng đến không gian làm việc của bạn.
  3. Chọn tên không gian làm việc của bạn,  Settings & administrationManage apps.
  4. Chọn ứng dụng mới tạo của bạn.
  5. Trong bảng bên phải, chọn Open in App Directory.
  6. Chọn Open in Slack.

Cấu hình bí mật Slack trong AWS Secrets Manager

Hãy cấu hình bí mật Slack của bạn để xác minh chữ ký của mỗi yêu cầu và đăng bài thay mặt bot Amazon Q của bạn.

Trong ví dụ này, chúng tôi không kích hoạt quay vòng token Slack. Bạn có thể kích hoạt nó cho một ứng dụng sản xuất bằng cách triển khai quay vòng qua AWS Secrets Manager. Tạo một vấn đề (hoặc tốt nhất là một yêu cầu kéo) trong GitHub repo nếu bạn muốn tính năng này được thêm vào các phiên bản tương lai.

Hoàn tất các bước sau để cấu hình một bí mật trong Secrets Manager:

  1. Trên  AWS CloudFormation console, điều hướng đến tab Outputs của slack của bạn và chọn liên kết cho SlackSecretConsoleUrl để được chuyển hướng đến Secrets Manager console.
  2. Chọn Retrieve secret value.
  3. Chọn Edit.
  4. Thay thế các giá trị của SlackSigningSecretSlackBotUserOAuthToken bằng các giá trị trong cấu hình ứng dụng Slack dưới Basic InformationOAuth & Permissions.

Hãy chắc chắn rằng bạn không vô tình sao chép Client Secret thay vì Signing Secret.

Bắt đầu sử dụng Amazon Q

Hoàn tất các bước sau để bắt đầu sử dụng Amazon Q trong Slack:

  1. Mở không gian làm việc Slack của bạn.
  2. Dưới Apps, Manage, thêm ứng dụng Amazon Q mới của bạn.
  3. Theo ý muốn, thêm ứng dụng Amazon Q của bạn vào các kênh nhóm.
  4. Trong kênh ứng dụng DM, nhập Hello.

Bạn đã triển khai một trợ lý trí tuệ nhân tạo mạnh mẽ vào môi trường thử nghiệm Slack của mình.

Hãy thử nghiệm nó, kiểm tra tất cả các tính năng được thảo luận trong bài viết này và sao chép những điều bạn thấy trong video demo. Quan trọng nhất, bạn có thể hỏi về các chủ đề liên quan đến tài liệu bạn đã nhập vào ứng dụng chuyên gia kinh doanh Amazon Q của bạn. Nhưng đừng dừng lại ở đó. Bạn có thể tìm thêm cách để làm cho nó hữu ích và khi bạn làm được, hãy thông báo cho chúng tôi bằng cách đăng một bình luận.

Khi bạn đã tin tưởng vào tính hữu ích của nó, trò chuyện với các quản trị viên Slack của bạn (và cho họ xem bài viết này) và làm việc với họ để triển khai nó trong không gian làm việc Slack của công ty bạn. Đồng nghiệp của bạn sẽ cảm ơn bạn!

Dọn dẹp

Khi bạn đã hoàn tất thử nghiệm với giải pháp này, hãy xóa ứng dụng của bạn trong Slack (https://api.slack.com/apps) và dọn dẹp tài nguyên AWS của bạn bằng cách mở AWS CloudFormation console và xóa ngăn xếp AMAZON-Q-SLACK-GATEWAY mà bạn triển khai. Điều này sẽ xóa các tài nguyên bạn đã tạo bằng cách triển khai giải pháp.

Kết luận

Ứng dụng mẫu Amazon Q trong bài viết này được cung cấp dưới dạng mã nguồn mở – bạn có thể sử dụng nó như một điểm khởi đầu cho giải pháp của bạn và giúp chúng tôi cải thiện nó bằng cách đóng góp các sửa lỗi và tính năng qua yêu cầu kéo GitHub. Khám phá mã nguồn, chọn Watch trong GitHub repo để nhận thông báo về phiên bản mới và kiểm tra lại để cập nhật mới nhất. Chúng tôi cũng rất mong nhận được ý kiến ​​đóng góp của bạn về cải thiện và tính năng.

Để biết thêm thông tin về Amazon Q, tham khảo “Amazon Q là gì (Dành cho Sử dụng Doanh nghiệp)?”

Về tác giả

Gary Benattar là Quản lý phát triển phần mềm cấp cao tại AWS HR. Gary bắt đầu làm việc tại Amazon vào năm 2012 với tư cách là một sinh viên thực tập, tập trung vào việc xây dựng hệ thống phát hiện ngoại lệ có khả năng mở rộng và thời gian thực. Anh đã làm việc tại Seattle và Luxembourg và hiện đang đặt trụ sở tại Tel Aviv, Israel, nơi anh dành thời gian của mình để xây dựng phần mềm để cách mạng hóa tương lai của nguồn nhân lực. Anh cũng là một trong những người sáng lập startup Zengo, tập trung vào việc làm cho ví điện tử trở nên an toàn thông qua tính toán đa bên. Anh nhận được bằng Thạc sĩ Kỹ thuật Phần mềm từ Đại học Sorbonne ở Paris.

Bob Strahan là Kiến trúc sư giải pháp chính tại nhóm AWS Language AI Services. 

Leave a comment