Kết nối trợ lý AI bên ngoài

Bạn nối trợ lý AI bên ngoài với Telegram-Auto và giới hạn những gì trợ lý được làm. Telegram-Auto không có AI nội bộ; mọi lệnh của trợ lý đi qua cùng cổng an toàn như thao tác trên web.

#Ai làm được

Chủ hoặc Quản lý tạo và quản lý kết nối. Quyền thật của kết nối là giao của vai trò, nhóm việc và tài khoản được cấp; kết nối không mạnh hơn người tạo.

#Cần chuẩn bị

• Một trợ lý hỗ trợ MCP, hoặc chương trình gọi REST.
• Danh sách tài khoản và công việc trợ lý được phép xử lý.
• Nơi giữ bí mật nếu bạn dùng khoá API.

Nên tách kết nối đọc báo cáo khỏi kết nối có quyền gửi tin.

#Bắt đầu ở đâu

Mở Cài đặt → Kết nối AI.

#Các bước

1. Chọn Tạo kết nối.
2. Nhập Tên để nhận biết trợ lý.
3. Chọn Cách nối phù hợp với chương trình của bạn.
4. Chọn Vai trò không cao hơn quyền của bạn.
5. Chọn Bộ tool MCP phù hợp.
6. Chọn Nhóm việc được làm theo nguyên tắc đủ dùng.
7. Chọn Tài khoản Telegram mà trợ lý được truy cập.
8. Đặt Ngôn ngữ cho AI. Tuỳ chọn này đổi ngôn ngữ mô tả, lỗi và lý do; không đổi mã thao tác, mã sự kiện hay dữ liệu.
9. Kiểm tra Việc nguy hiểm. Nên giữ chính sách Hỏi lại.
10. Chọn Tạo.

Nếu dùng khoá API, chép khoá tga_… ngay khi xuất hiện. Khoá chỉ hiện một lần. Không dán khoá vào hội thoại, ảnh hoặc nhật ký.

#Nối bằng OAuth

Trong trình khách MCP, thêm địa chỉ:

https://tlg.builera.app/mcp

Đăng nhập Telegram-Auto, xem màn hình đồng ý và chọn kết nối phù hợp. Không đồng ý nếu workspace hoặc phạm vi quyền không đúng.

#Nối bằng khoá API

REST v2 dùng địa chỉ gốc:

https://tlg.builera.app/api/public/v2

MCP bằng khoá dùng:

https://tlg.builera.app/api/public/mcp

Cả hai dùng header:

Authorization: Bearer $TELEGRAM_AUTO_API_KEY

#Hiểu bộ công cụ

Các profile là realtime, setup, prospecting, reports, admin, full. Mỗi profile công bố tối đa 35 công cụ, gồm công cụ hỗ trợ và khám phá.

Không thấy công cụ có tên riêng không có nghĩa là thao tác bị cấm. Trợ lý dùng tools_search, đọc hợp đồng bằng tools_describe, rồi gọi tools_run. Các kiểm tra quyền vẫn giữ nguyên.

#Kết quả

Kết nối có danh tính riêng, phạm vi tài khoản riêng và lịch sử lệnh riêng. Khi xử lý khách, trợ lý cần giữ hội thoại bằng conversations.claim, không giành khoá của người khác và nhả khoá khi xong.

#Kiểm tra

Mở Thao tác gần đây để xem lệnh, trạng thái và lỗi. Cho trợ lý gọi whoami trước khi làm việc.

Dùng Sửa khi cần thu hẹp quyền. Dừng ngay từ chối lệnh mới, huỷ việc đang chờ hoặc đang giữ của kết nối và giải phóng hội thoại. Tin đã gửi không được thu hồi.

Chỉ chọn Xoá sau khi kiểm tra đúng kết nối.

#Khi có lỗi

Kiểm tra trạng thái kết nối, vai trò, scope, tài khoản và hạn dùng. Với confirmation_required, trợ lý phải hỏi người; không được tự quyết định xác nhận.

#Làm bằng API hoặc MCP

• Xem kết nối.
• Sửa kết nối.
• Dừng kết nối.
• MCP: dùng tools_run với mã tương ứng sau khi đọc tools_describe.

Xem thêm gửi an toàn và xác nhận thao tác.