Slack Bot cho Coding Agent: Kết nối Sharkly Agent của bạn vào Slack

TL;DR

Slack bot cho coding agent là một ứng dụng Slack được gắn với một AI agent duy nhất, nhờ đó tin nhắn trực tiếp và các lượt mention đều trở thành hội thoại với agent, và mọi câu trả lời đều nằm trong cùng một thread. Trong Sharkly, mỗi bot chỉ gắn với đúng một Agent, và Agent đó trả lời dựa trên hướng dẫn, model, skill và repo mà bạn đã cấu hình cho nó.

1. Mở api.slack.com/apps và tạo một App Configuration Token, sau đó sao chép Refresh Token của nó.
2. Trong Sharkly, mở Integrations, chọn Slack rồi chọn Connect Agent.
3. Chọn Agent cần gắn và đặt tên cho ứng dụng nếu muốn (Slack giới hạn tên ứng dụng tối đa 35 ký tự).
4. Dán Refresh Token và chọn Create & Install.
5. Chấp thuận yêu cầu OAuth trong cửa sổ mà Slack mở ra.
6. Đợi trạng thái bot chuyển từ Installing sang Connected, rồi gửi cho nó một tin nhắn trực tiếp.

Vì sao coding agent của bạn nên trả lời ngay trên Slack

Đội của bạn vốn đã dùng coding agent. Người thì mở Claude Code trong terminal, người thì viết script chạy Codex, và kết quả chỉ nằm trong lịch sử shell của từng người. Trong khi đó, những câu hỏi mà các agent này có thể trả lời lại được đặt ra trên Slack — vì Slack mới là nơi cả đội trò chuyện.

Khoảng cách đó có cái giá của nó. Khi một product manager hỏi vì sao endpoint export bắt đầu lỗi, câu hỏi sẽ đến tay một developer, người này lại hỏi agent rồi chuyển câu trả lời về. Việc trung chuyển đó khiến một câu hỏi mà agent giải đáp trong 90 giây mất thêm cả tiếng đồng hồ.

Sharkly thu hẹp khoảng cách đó từ phía nền tảng. Sharkly không thay thế Claude Code, Codex hay các công cụ thực thi khác; nó bổ sung lớp task, ngữ cảnh, kiểm soát và review dùng chung bao quanh chúng. Tích hợp Slack của Sharkly mở rộng lớp đó vào workspace của bạn, để đồng đội nhận được câu trả lời ngay tại nơi câu hỏi được đặt ra.

Hai kết nối, hai nhiệm vụ

Tích hợp này cung cấp hai loại kết nối độc lập, và nhầm lẫn giữa chúng là nguyên nhân gây bối rối phổ biến nhất:

Đây là hai bản cài đặt riêng biệt, dựa trên hai ứng dụng Slack riêng, và mỗi cái đều hoạt động độc lập với cái kia. Thêm hai giới hạn nữa: một workspace Slack chỉ kết nối với một Organization của Sharkly tại một thời điểm, và các action Slack bên trong automation của Space dùng kết nối thứ ba, trong đó Slack đóng vai trò action nhưng chưa thể khởi chạy workflow ở phiên bản này. Hướng dẫn này tập trung vào việc gắn bot cho Agent.

Slack bot của Agent trong Sharkly là gì?

Bot Agent kết nối một Agent của Sharkly với một ứng dụng Slack. Tin nhắn trở thành một cuộc hội thoại với Agent, và câu trả lời quay về đúng DM hoặc thread đó. Agent trả lời cũng chính là “đồng đội” đã được cấu hình giống như ở mọi nơi khác trong Sharkly: cùng hướng dẫn, model, skill và kiến thức về repository.

Việc gắn kết là một-một tuyệt đối, và bạn có thể gắn Personal Agent của mình cùng những Agent được chia sẻ trong Space mà bạn được phép sử dụng.

Bản cài đặt này mang lại hai bề mặt tương tác. Tin nhắn trực tiếp tạo một phiên chat cho kênh DM đó, và các tin nhắn sau đó tiếp nối phiên ấy, nên Agent giữ được ngữ cảnh thay vì bắt đầu lại từ đầu. Mention trong channel sẽ loại bỏ phần mention, gửi phần còn lại cho Agent, và trả lời trong một thread bắt đầu từ tin nhắn của bạn.

@ReleaseShark summarize the decision in this thread and list the next steps

Sharkly bỏ qua tin nhắn từ các bot khác, sự kiện chỉnh sửa tin nhắn và sự kiện tham gia, nhờ đó tránh được vòng lặp trả lời khi nhiều ứng dụng cùng chung một channel.

Cách kết nối AI agent với Slack

Bạn cần một Agent có thể cấu hình được (xem hướng dẫn bắt đầu) và quyền tạo Slack App Configuration Token cũng như cài đặt ứng dụng cho team đích.

1. Mở api.slack.com/apps và tìm mục Your App Configuration Tokens.
2. Tạo một App Configuration Token và sao chép Refresh Token của nó (tài liệu của Slack). Hãy coi nó như thông tin mật và chỉ nhập qua form kết nối của Sharkly.
3. Trong Sharkly, mở Integrations và chọn Slack.
4. Chọn Connect Agent rồi chọn Agent cần gắn.
5. Tùy chọn nhập tên ứng dụng. Nếu để trống, tên của Agent sẽ được dùng.
6. Dán Refresh Token và chọn Create & Install.
7. Hoàn tất ủy quyền OAuth của Slack trong cửa sổ mở ra. Nếu không thấy gì, hãy cho phép pop-up và thử lại.
8. Đợi trạng thái bot chuyển từ Installing sang Connected.

Sharkly đổi refresh token lấy một configuration access token có thời hạn ngắn, tạo ứng dụng từ manifest bao gồm danh tính bot, chế độ xem Slack Assistant, redirect OAuth, callback và scope của Events API, rồi mở Slack để cài đặt.

Hãy kiểm tra bằng cách gửi DM cho bot. Một câu trả lời xác nhận toàn bộ luồng đã thông: sự kiện được nhận, phiên được tạo, lượt chạy hoàn tất, phản hồi được gửi đi. Nếu bot vẫn ở trạng thái Installing, nghĩa là callback OAuth chưa lưu bot token, nên hãy mở lại cửa sổ cài đặt và hoàn tất bước xác nhận. Nếu không chọn được Agent, tức là nó đã được gắn với một ứng dụng khác.

Các cách kích hoạt Slack bot: mention, thả emoji, mọi tin nhắn

Mặc định, bot chỉ phản hồi tin nhắn trực tiếp và mention trong channel, không gì khác. Trong phần cài đặt Slack của Agent, mỗi trigger là một dòng bạn có thể bật/tắt:

• Mentioned in a channel là mặc định. Agent chỉ chạy khi có người gọi tên bot, và câu trả lời nằm trong một thread bên dưới lượt mention.
• Emoji reaction in a channel biến một lượt thả cảm xúc thành trigger. Thả emoji đã cấu hình và bot sẽ mở một thread kèm ngữ cảnh xung quanh.
• Any channel message cho Agent chạy trên các tin nhắn thông thường trong những channel bạn chọn cụ thể. Nó không thể áp dụng cho mọi channel, và các ứng dụng khác đăng bài ở đó cũng có thể kích hoạt nó.

Cặp lựa chọn giúp mọi thứ hợp lý: giữ chế độ chỉ-mention trong các channel dùng chung, nơi việc kích hoạt tràn lan gây nhiễu và đẩy những ngữ cảnh không liên quan đến Agent. Chỉ bật Any channel message ở một channel chuyên dụng, nơi mọi người đều hiểu rằng tin nhắn sẽ đến Agent. Trigger bằng emoji nằm giữa hai thái cực đó, vì không gì đến được Agent trừ khi có người chủ động thả cảm xúc.

Mỗi thread trong channel là một cuộc hội thoại riêng với Agent, nên hai thread trong cùng một channel là hai phiên với ngữ cảnh tách biệt, và mọi người có thể tiếp tục một thread mà không cần mention bot lần nữa. Ứng dụng cũng bật Slack Assistant, khung mà Slack cung cấp cho các ứng dụng AI.

Hội thoại trên Slack không phải là Task

Hội thoại với bot Agent không bao giờ tự tạo Task, và ranh giới đó là có chủ đích. Quy tắc từ chat và giao Task vẫn giữ nguyên: chat khi bạn cần câu trả lời, giao Task khi bạn cần một kết quả để ai đó review.

Khi Agent tạo Task từ Slack, bạn có thể gắn luôn thread hiện tại. Sau khi gắn, comment trong task và tin nhắn trong thread luôn đồng bộ. Gắn thread chính là giá trị cốt lõi của tích hợp này: một cuộc thảo luận bắt đầu trên Slack, trở thành Task, và từ đó tiến độ, điểm nghẽn cùng kết quả đều được cập nhật về Task, trong khi thread vẫn luôn mới với những người tham gia cuộc trò chuyện.

Khi nào Slack bot không phải là lựa chọn đúng

Bạn chỉ cần tạo Task và xem trước liên kết. Chỉ cần dùng kết nối workspace. Slash command, shortcut, linkback và unfurl đều đến từ ứng dụng dùng chung.

Bạn muốn gửi tin nhắn vào channel theo lịch hoặc theo sự kiện. Đó là một action Slack bên trong workflow automation, không phải một cuộc hội thoại. Vì sự kiện Slack chưa thể kích hoạt workflow ở phiên bản này, hãy bắt đầu từ lịch chạy, thay đổi trạng thái, từ khóa trong comment hoặc webhook.

Công việc cần thực thi trên repository và có bước review ở cuối. Hãy giao Task. Dùng bot để hỏi; dùng Task để làm ra sản phẩm.

Bạn muốn một bot đại diện cho cả đội hình. Kiểu gắn kết đó không tồn tại. Nhiều chuyên gia phối hợp trong công việc thực tế nên nằm trong một Crew cùng xử lý một Task, chứ không phải một channel đầy bot.

Bảo mật và quyền hạn

• App Configuration Refresh Token được đổi trong quá trình thiết lập và không được dùng làm bot token của bản cài đặt. Client secret, signing secret và OAuth bot token được tạo ra đều được mã hóa khi lưu trữ.
• Callback của Events API được xác minh bằng signing secret đã lưu; chữ ký không hợp lệ sẽ bị từ chối và phần thân sự kiện bị giới hạn kích thước.
• Hãy xem lại các scope được yêu cầu trước khi ủy quyền: mention, tin nhắn trực tiếp, lịch sử thread của channel và channel riêng tư, gửi tin nhắn, mở DM và cập nhật trạng thái Assistant.
• Owner và Admin quản lý workspace dùng chung cùng mọi liên kết; member quản lý liên kết cho những Agent họ được phép dùng.

Ngắt kết nối không gây mất dữ liệu: Agent ngừng nhận tin nhắn qua bot đó, nhưng lịch sử Slack vẫn nguyên vẹn và không tin nhắn cũ nào trở thành Task.

Kết luận

Một Slack bot cho coding agent chỉ thực sự xứng chỗ khi nó thay đổi nơi diễn ra cuộc trò chuyện mà không thay đổi nơi công việc được thực hiện. Hãy gắn một Agent bạn đã tin tưởng, giữ mặc định chỉ-mention cho đến khi có channel thực sự cần hơn thế, và dùng tính năng gắn thread ngay khi cuộc trò chuyện biến thành công việc. Nếu bạn chưa có Agent, hãy tạo một cái trước.

Câu hỏi thường gặp

Tôi có cần kết nối workspace Slack trước khi gắn bot cho Agent không?

Không. Hai loại kết nối này độc lập với nhau. Bạn chỉ cần kết nối workspace cho việc tạo Task từ Slack, linkback, xem trước liên kết và DM thông báo từ Inbox.

Một Slack bot có thể phục vụ nhiều Agent của Sharkly không?

Không. Mỗi bot chỉ gắn với đúng một Agent, và một Agent chỉ giữ một liên kết tại một thời điểm. Muốn đưa nhiều Agent lên Slack, hãy tạo một bot riêng cho từng Agent.

Trò chuyện với bot có tự động tạo Task không?

Không. Khi một cuộc trò chuyện biến thành công việc cần người phụ trách, trạng thái hoặc review, hãy chủ động tạo Task. Nếu Agent tạo Task từ Slack, bạn có thể gắn thread để comment và tin nhắn luôn đồng bộ.

Một tin nhắn Slack có thể khởi chạy workflow automation của Sharkly không?

Chưa, ở phiên bản này. Slack có mặt trong workflow với vai trò action, nhưng trigger Slack qua Events API vẫn chưa được nối.