Nối Slack với không gian làm việc

Bạn sẽ xây dựng gì

Đến cuối bài hướng dẫn này, bạn sẽ có:

• Một app Slack được tạo cho không gian làm việc của bạn, với đúng quyền và sự kiện đã được thiết lập sẵn
• Một kết nối đang hoạt động giữa Slack và Control Center
• Tài khoản Slack của riêng bạn được liên kết với người dùng Control Center của bạn
• Một agent trả lời bạn trong một luồng Slack và một phiếu được tạo từ một lệnh slash

Điều kiện tiên quyết:

• Không gian làm việc đầu tiên của bạn và Điều phối agent đầu tiên đã hoàn thành — một không gian làm việc không có agent vẫn nhận được tin nhắn Slack nhưng không có ai để trả lời nó
• Agent CEO của không gian làm việc đã có adapter và mô hình được đặt tại Cài đặt → Không gian làm việc → Agent. Cầu nối đánh thức agent CEO, chứ không phải agent bạn đã cấu hình trong bài hướng dẫn trước, và một agent không có adapter sẽ chạy trên vòng lặp tích hợp sẵn với mô hình mặc định của Anthropic.
• Vai trò owner hoặc admin trong không gian làm việc Control Center (kết nối một app chat là hành động thay cho toàn bộ không gian làm việc)
• Quyền tạo và cài đặt app trong không gian làm việc Slack của bạn

Ở đây không cần địa chỉ công khai, đường hầm hay cổng vào. Control Center tự gọi ra Slack qua Socket Mode, nên cách này chạy được từ một máy tính xách tay nằm sau NAT.

Bước 1: Lấy token cấu hình app của Slack

Đây là bí mật duy nhất bạn phải tự lấy thủ công. Nó cho phép Control Center tạo và về sau chỉnh sửa app thay bạn.

1. Mở api.slack.com/apps
2. Cuộn xuống phần token cấu hình app ở cuối trang
3. Tạo một cặp token cho không gian làm việc Slack của bạn
4. Sao chép token refresh — nó bắt đầu bằng xoxe-

Bước 2: Để Control Center tạo app

1. Trong Control Center, vào Cài đặt → Không gian làm việc → Chung và tìm thẻ Cầu nối chat
2. Trên khối Slack, nhấp Tạo app giúp tôi
3. Dán token cấu hình app
4. Xem lại hình dạng của bot:
   • Tên app: cách Slack liệt kê app, ví dụ Control Center · Acme
   • Tên bot: nội dung mọi người gõ sau @, ví dụ control-center
   • Mô tả ngắn và Bot nói nó có thể làm gì
   • Lệnh slash: mặc định là cc, nên lệnh là /cc
   • Tin nhắn trực tiếp: để bật để thành viên có thể nhắn tin trực tiếp cho bot
5. Nhấp Tạo app

Control Center soạn toàn bộ định nghĩa app — bật Socket Mode, các scope và đăng ký sự kiện mà bot cần, lệnh slash, tab Messages — rồi tạo nó trong Slack.

Bước 3: Hoàn tất hai bước chỉ Slack mới làm được

Slack không có API để tạo token cấp app hay cài đặt app, nên hộp thoại đưa cho bạn cả hai dưới dạng liên kết:

1. Tạo token cấp app — mở Basic Information → App-Level Tokens. Tạo một token với scope connections:write rồi sao chép nó. Nó bắt đầu bằng xapp-
2. Cài app — mở Install App. Cài vào không gian làm việc của bạn, rồi sao chép Bot User OAuth Token. Nó bắt đầu bằng xoxb-

Hãy giữ cả hai giá trị để dùng cho bước tiếp theo.

Bước 4: Kết nối

1. Trở lại hộp thoại, nhấp Dán thông tin xác thực
2. Nhập Token bot (xoxb-…) và Token cấp ứng dụng (xapp-…)
3. Để trống Token cấu hình app — token từ bước 1 đã được lưu sẵn (Slack đã xoay token đó và Control Center đã lưu token mới)
4. Nhấp Kết nối

Control Center xác minh token bot với Slack trước khi lưu bất cứ thứ gì, rồi mở socket. Dòng này giờ hiển thị tên bot và tên không gian làm việc Slack của bạn kèm thẻ Trực tiếp.

Bước 5: Liên kết tài khoản Slack của riêng bạn

Kết nối giúp bot tiếp cận được; liên kết giúp bạn được nhận diện. Cho đến khi danh tính Slack của bạn được liên kết, bot sẽ không hành động dựa trên tin nhắn của bạn — nó không bao giờ gán một tin nhắn cho người đã cài đặt app.

Việc liên kết mang tính cá nhân, nên nó nằm trên một trang khác với kết nối toàn không gian làm việc.

1. Vào Cài đặt → Không gian làm việc → Hồ sơ & danh tính và tìm thẻ Tài khoản chat đã liên kết
2. Nhấp Liên kết tài khoản Slack của tôi
3. Sao chép lệnh mà nó hiển thị, ví dụ /cc link K7M2QP
4. Trong Slack, gửi lệnh đó cho bot trong một tin nhắn trực tiếp (DM)
5. Bot trả lời “Đã liên kết — bạn là …”

Mã này chỉ dùng được một lần và hết hạn sau 15 phút. Nếu email Slack của bạn khớp với một người dùng Control Center đã là thành viên của không gian làm việc này, cầu nối sẽ tự động liên kết bạn ngay lần đầu bạn trò chuyện với nó và bạn có thể bỏ qua bước này.

Nếu bạn nhắc đến bot trước khi làm xong việc này, nó sẽ từ chối và nói lý do. Ba lời từ chối này khác nhau, nên hãy đọc xem bạn gặp lời nào:

• Người gửi chưa liên kết: bot chỉ cho bạn cách liên kết. Hãy quay lại bước này.
• Đã liên kết, nhưng không phải thành viên của không gian làm việc này: hãy nhờ quản trị viên mời bạn.
• Thành viên với vai trò chỉ đọc (Người xem hoặc Khách): bot sẽ không bắt đầu công việc thay bạn.

Bước 6: Đưa một agent vào việc

1. Trong Slack, mời bot vào một kênh: /invite @control-center

2. Nhắc đến nó bằng một yêu cầu thật:

   @control-center tóm tắt các PR đang mở trên kho api

Cầu nối:

1. Tạo một space Control Center cho luồng Slack đó, đặt tên theo kênh Slack và yêu cầu của bạn
2. Đánh thức agent tiếp nhận của không gian làm việc (agent CEO nếu có, ngược lại là agent đầu tiên)
3. Truyền phản hồi của agent trở lại luồng Slack ngay khi nó được viết

Trả lời trong cùng luồng Slack đó để tiếp tục — không cần nhắc đến nữa, vì luồng Slack giờ đã được nối. Hoặc nhắn tin trực tiếp cho bot thay vì dùng kênh; mỗi cuộc trò chuyện DM điều khiển một space Control Center riêng, với tiêu đề và dòng trạng thái “is thinking…” trong khi agent làm việc.

Truyền theo luồng cần API streaming của Slack, mà không phải gói nào cũng có. Nếu app của bạn bị từ chối API đó, cầu nối sẽ ngừng thử trong suốt toàn bộ kết nối và thay vào đó đăng mỗi phản hồi thành một tin nhắn duy nhất, và thẻ Cầu nối chat hiển thị “Luồng trực tiếp đang tắt cho ứng dụng Slack này — phản hồi đến thành một tin nhắn.” Mọi thứ khác vẫn hoạt động như cũ.

Bước 7: Tạo phiếu mà không cần rời Slack

/cc ticket Fix the flaky login test | It fails on CI about once a day.

Bot trả lời bằng khóa phiếu mà nó đã tạo. Phiếu này là một phiếu Control Center cục bộ thông thường, do bạn báo cáo, sẵn sàng được giao cho một agent. /cc help liệt kê mọi thứ mà lệnh này có thể làm.

Tóm tắt

Bạn đã tạo một app Slack từ Control Center, kết nối nó qua một socket gọi ra, liên kết danh tính Slack của mình với người dùng Control Center và điều khiển một agent từ một luồng Slack. Mọi thứ xảy ra trong Slack cũng tồn tại trong Control Center: luồng Slack là một space, phản hồi là một bản ghi, phiếu là một phiếu.

Tiếp theo: Thiết lập tích hợp Slack trình bày con đường thủ công, xoay token và xử lý sự cố. Để hiểu mô hình bên dưới, hãy đọc Cầu chat.