Tích hợp Lark Bot
Gắn một agent UniAI vào một Bot Lark (飞书), rồi trò chuyện với nó từ DM hoặc nhóm Lark — @nhắc nó, chat tự nhiên, hoặc gõ /issue để tạo issue UniAI mà không rời Lark.
Gắn bất kỳ agent nào vào một Bot Lark (飞书) và nhóm của bạn làm việc được với nó ngay trong Lark — DM cho Bot, @nhắc nó trong nhóm, hoặc gõ /issue để tạo một issue UniAI mà không phải mở app. Câu trả lời của agent stream thẳng về cuộc chat dưới dạng thẻ động, cập nhật liên tục trong lúc agent làm việc.
Mỗi Bot gắn một-một với một agent UniAI. Gắn agent thứ hai sẽ tạo Bot thứ hai; một agent không bao giờ có hai Bot.
Tích hợp làm gì
| Vị trí | Hành vi |
|---|---|
| Agent → Integrations | Trang chi tiết agent có tab Integrations (và mục tương ứng ở thanh bên trái). Owner và admin thấy Bind to Lark ở đó; gắn xong, nút chuyển thành huy hiệu Connected to Lark kèm liên kết Manage in Lark. |
| DM cho Bot | Một thành viên nhắn thẳng cho Bot trong Lark. Mỗi cuộc trò chuyện thành một phiên chat UniAI với agent; agent trả lời trong luồng. |
| @nhắc trong nhóm | Thêm Bot vào nhóm Lark và @nhắc nó. Chỉ tin nhắn có nhắc mới được đọc — Bot không nghe cả nhóm. |
Lệnh /issue | Gõ /issue <tiêu đề> (tùy chọn kèm phần thân) tạo một issue UniAI mới trong không gian làm việc, đứng tên bạn. |
| Thẻ trả lời động | Bot đăng một thẻ tương tác và liên tục cập nhật nó trong lúc agent chạy — tiến độ, câu trả lời cuối, hoặc lỗi. |
Gắn một agent (owner / admin)
Việc gắn dùng luồng quét mã để cài — không phải chép app secret, không cần thao tác trên developer console.
- Mở agent trong Agent → agent của bạn.
- Vào tab Integrations (hoặc mục Integrations ở thanh bên trái) và bấm Bind to Lark.
- Một mã QR hiện ra. Trên điện thoại, mở Lark → Scan, rồi cấp quyền cho Bot PersonalAgent mới.
- Quét xong, hộp thoại đóng và agent hiện Connected to Lark. Danh tính Lark của chính bạn được tự động liên kết với tài khoản UniAI, nên bạn chat được với Bot ngay.
Mã QR dùng một lần và hết hạn sau một khoảng thời gian ngắn. Nếu mã hết hạn trước khi bạn cấp quyền, bấm Scan again để lấy mã mới.
Khi agent đã kết nối, nút Bind to Lark được thay bằng liên kết Manage in Lark. Dùng nó để mở trang app của Bot trong Lark khi cần chỉnh scope, đổi tên, hoặc xin thêm quyền — tính năng quét lại được chủ đích tắt để Bot hiện có không bị bỏ lửng.
Dùng Bot (thành viên)
Tin nhắn đầu tiên: liên kết danh tính Lark
Lần đầu bạn nhắn Bot, nó trả lời bằng một thẻ đề nghị liên kết danh tính Lark của bạn. Bấm liên kết, đăng nhập UniAI, và tài khoản Lark của bạn được nối với tài khoản thành viên UniAI. Nhờ đó agent có thể hành động thay bạn — ví dụ, /issue tạo issue đứng tên bạn.
Chỉ thành viên của không gian làm việc dùng được Bot. Nếu bạn không phải thành viên, hoặc bỏ qua bước liên kết danh tính, Bot sẽ không trả lời — tin nhắn của bạn bị bỏ qua (và được ghi lại để kiểm toán, không kèm nội dung).
Chat và /issue
- Hỏi agent bất cứ gì — DM cho Bot hoặc @nhắc nó trong nhóm. Cuộc trò chuyện là một phiên chat agent bình thường; agent trả lời trong thẻ.
- Tạo issue — gửi
/issue Fix the login redirectvà UniAI tạo issue đó trong không gian làm việc, được giao như mọi issue mới. Thêm dòng sau tiêu đề để làm mô tả. - Xem agent làm việc — thẻ trả lời tự cập nhật trong lúc agent chạy, nên bạn thấy tiến độ và kết quả ngay tại chỗ.
Nếu agent offline (runtime của nó không kết nối) hoặc đã lưu trữ, Bot trả lời một thông báo trạng thái ngắn thay vì lặng lẽ bỏ tin nhắn của bạn.
Quản lý và ngắt kết nối
Quản lý toàn không gian làm việc nằm ở Cài đặt → Integrations:
- Connected bots liệt kê mọi Bot trong không gian làm việc và agent mà từng Bot gắn vào. Danh sách này mọi thành viên đều thấy.
- Disconnect chỉ dành cho owner / admin. Ngắt kết nối làm Bot ngừng nhận tin nhắn Lark và gỡ kết nối của nó; bản ghi installation được giữ để kiểm toán, và bạn có thể gắn lại chính agent đó về sau.
Quyền
- Gắn / ngắt kết nối cần owner hoặc admin của không gian làm việc. Member thấy danh sách bot đã kết nối nhưng không có nút gắn hay ngắt.
- Nói chuyện với Bot yêu cầu là thành viên của không gian làm việc và đã liên kết danh tính Lark. Tin nhắn của những người khác đều bị bỏ qua.
- Tích hợp không bao giờ lưu nội dung của tin nhắn bị bỏ qua — chỉ lưu lý do, để kiểm toán.