Hướng dẫn dùng AI

Làm bot Discord có AI: lệnh gạch chéo, quyền đọc tin nhắn, giới hạn

Nhiều câu lạc bộ, nhóm học và lớp dùng Discord để trao đổi. Một bot có AI trong máy chủ có thể trả lời câu hỏi thường gặp, tóm tắt một cuộc thảo luận dài, hay gợi ý tài liệu. Bài này đọc tài liệu cho nhà phát triển và điều khoản dịch vụ của Discord ngày 12/11/2026 để đi qua những điều cần biết trước khi viết bot: lệnh gạch chéo và quy tắc đặt tên, quyền đọc nội dung tin nhắn, giới hạn số lần gọi, độ tuổi, và kèm đoạn Python soát định nghĩa lệnh trước khi đăng ký.

Ý chính
  • Lệnh gạch chéo (slash command) là cách người dùng gọi bot rõ ràng nhất; tên lệnh dài 1 tới 32 ký tự, phải dùng chữ thường nếu chữ có dạng thường, mô tả dài 1 tới 100 ký tự.
  • Đọc nội dung tin nhắn là quyền đặc biệt (Message Content); phải bật trong cổng nhà phát triển, và bot ở từ 100 máy chủ phải được xác minh, được duyệt mới dùng được.
  • Vượt giới hạn gọi API, Discord trả mã 429 kèm thông tin chờ bao lâu; bot phải chờ rồi gọi lại.
  • Điều khoản Discord yêu cầu người dùng từ 13 tuổi và đủ tuổi tối thiểu theo luật nước mình; dưới tuổi trưởng thành cần cha mẹ đồng ý điều khoản.

Code trong bài là Python, chỉ dùng thư viện chuẩn; phần kiểm dùng thêm thư viện regex bản 2026.11.9. Lệnh mẫu là giả lập.

Bot Discord có AI làm việc thế nào

Giống bot Telegram trong bài bot Telegram có AI, bot Discord là một chương trình của bạn: nó nhận sự kiện từ Discord (ai đó gọi lệnh, ai đó nhắn tin), gọi mô hình AI để có câu trả lời, rồi gửi lại vào kênh. Token của bot và khóa API của mô hình nằm ở phía chương trình. Ai có token là điều khiển được bot, nên giữ nó như mật khẩu, đọc từ biến môi trường hay tệp cấu hình không đưa lên GitHub; bài giữ khóa API an toàn có cách làm.

Lệnh gạch chéo và quy tắc đặt tên

Tài liệu Application Commands là hướng dẫn tạo lệnh gạch chéo, lệnh người dùng và lệnh tin nhắn. Với lệnh gạch chéo, người dùng gõ dấu gạch chéo, chọn lệnh của bot, điền tham số; bot nhận đúng những gì người dùng gửi qua lệnh. Đây là cách rõ ràng nhất để người dùng chủ động hỏi bot.

Tài liệu đặt quy tắc chặt cho tên. Tên lệnh và tên tham số của lệnh gạch chéo phải khớp một biểu thức: dài 1 tới 32 ký tự, gồm chữ cái và chữ số của mọi ngôn ngữ, dấu gạch ngang, gạch dưới, dấu ʼ, cùng chữ Devanagari và chữ Thái. Nếu chữ cái có dạng chữ thường thì phải dùng dạng chữ thường; chữ không có dạng thường vẫn được. Mô tả lệnh dài 1 tới 100 ký tự. Nghĩa là /hỏi hay câu_hỏi hợp lệ, còn /Tóm Tắt không hợp lệ vì có chữ hoa và khoảng trắng.

Soát lệnh trước khi đăng ký

Đăng ký lệnh sai quy tắc thì Discord từ chối, và bạn mất công tìm lỗi. Đoạn Python dưới đây đọc danh sách lệnh dạng như bạn sẽ gửi lên, soát từng tên lệnh, tên tham số và mô tả theo quy tắc trên, rồi liệt kê lỗi. Mô-đun re của Python không hiểu cú pháp lớp ký tự Unicode như tài liệu Discord dùng, nên chương trình xét từng ký tự bằng mô-đun unicodedata.

"""Soát định nghĩa lệnh gạch chéo (slash command) của bot Discord trước khi đăng ký.

Theo tài liệu Application Commands (đọc 12/11/2026), với lệnh loại CHAT_INPUT:
  - tên lệnh và tên tùy chọn khớp ^[-_ʼ\\p{L}\\p{N}\\p{sc=Deva}\\p{sc=Thai}]{1,32}$ (cờ unicode):
    dài 1 tới 32 ký tự, gồm chữ, số, dấu gạch ngang, gạch dưới, dấu ʼ, chữ Devanagari, chữ Thái;
  - nếu chữ có dạng chữ thường thì phải dùng chữ thường;
  - mô tả dài 1 tới 100 ký tự.
Đăng ký lệnh sai thì Discord từ chối, nên soát trước cho đỡ mất công.
Mô-đun re của Python không có \\p{L}, nên ở đây xét từng ký tự bằng unicodedata.
Lệnh mẫu bên dưới là giả lập. Chỉ dùng thư viện chuẩn.
"""
import unicodedata


def _ky_tu_hop_le(c):
    if c in "-_ʼ":
        return True
    loai = unicodedata.category(c)
    if loai[0] in "LN":
        return True
    ten = unicodedata.name(c, "")
    return ten.startswith("DEVANAGARI") or ten.startswith("THAI")


def loi_ten(ten):
    loi = []
    if not 1 <= len(ten) <= 32:
        loi.append("tên phải dài 1 tới 32 ký tự")
    sai = [c for c in ten if not _ky_tu_hop_le(c)]
    if sai:
        loi.append("ký tự không được dùng: " + ", ".join(repr(c) for c in sorted(set(sai))))
    if ten != ten.lower():
        loi.append("phải viết chữ thường")
    return loi


def soat(lenh):
    """lenh: dict có name, description, options (danh sách dict name, description)."""
    ket_qua = [("lệnh " + lenh["name"], l) for l in loi_ten(lenh["name"])]
    if not 1 <= len(lenh.get("description", "")) <= 100:
        ket_qua.append(("lệnh " + lenh["name"], "mô tả phải dài 1 tới 100 ký tự"))
    for tc in lenh.get("options", []):
        ket_qua += [("tùy chọn " + tc["name"], l) for l in loi_ten(tc["name"])]
        if not 1 <= len(tc.get("description", "")) <= 100:
            ket_qua.append(("tùy chọn " + tc["name"], "mô tả phải dài 1 tới 100 ký tự"))
    return ket_qua


LENH_MAU = [
    {"name": "hoi", "description": "Hỏi trợ lý AI của lớp", "options": [
        {"name": "câu_hỏi", "description": "Điều bạn muốn hỏi"}]},
    {"name": "Tóm Tắt", "description": "", "options": []},
]

if __name__ == "__main__":
    for lenh in LENH_MAU:
        loi = soat(lenh)
        print(f"/{lenh['name']}: " + ("hợp lệ" if not loi else ""))
        for cho, l in loi:
            print(f"  - {cho}: {l}")

Với hai lệnh mẫu, /hoi có tham số câu_hỏi được báo hợp lệ: chữ tiếng Việt có dấu là chữ cái nên được dùng. Lệnh /Tóm Tắt bị báo ba lỗi: có khoảng trắng, có chữ hoa, và mô tả rỗng. Phần kiểm đi kèm dùng thư viện regex, thư viện hiểu đúng biểu thức trong tài liệu Discord, để đối chiếu trên một loạt tên: tiếng Việt, chữ Thái, chữ Devanagari, dấu chấm, biểu tượng cảm xúc, tên rỗng, tên dài đúng 32 và 33 ký tự.

Bot Discord có AI Theo tài liệu và điều khoản Discord, đọc 12/11/2026 Lệnh gạch chéoTên 1-32 ký tự,chữ thường Đọc tin nhắnQuyền MessageContent đặc biệt Giới hạn gọiVượt thì nhậnmã 429 Độ tuổiDiscord:từ 13 tuổi Soát định nghĩa lệnh trước khi đăng ký
Bot Discord có AI Lệnh gạch chéoTên 1-32 ký tự,chữ thường Đọc tin nhắnQuyền MessageContent đặc biệt Giới hạn gọiVượt thì nhậnmã 429 Độ tuổiDiscord:từ 13 tuổi Soát định nghĩa lệnh trước khi đăng ký
Hình 1. Bot Discord có AI: lệnh gạch chéo tên 1 tới 32 ký tự chữ thường; đọc nội dung tin nhắn cần quyền Message Content; vượt giới hạn gọi thì nhận mã 429; điều khoản yêu cầu từ 13 tuổi.

Quyền đọc nội dung tin nhắn

Nếu bạn muốn bot đọc mọi tin nhắn trong kênh, ví dụ để tóm tắt cuộc thảo luận, bot cần quyền Message Content. Tài liệu Gateway xếp quyền này, cùng GUILD_PRESENCES và GUILD_MEMBERS, vào nhóm quyền đặc biệt. Bạn phải bật quyền trong cổng nhà phát triển trước khi khai báo nó khi bot kết nối; khai báo quyền chưa bật hay chưa được duyệt thì kết nối bị đóng. Bot đã xác minh, bắt buộc với bot ở từ 100 máy chủ trở lên, còn phải được duyệt quyền sau quá trình xác minh.

Với bot của một lớp hay câu lạc bộ, thường chỉ ở một máy chủ, việc bật quyền là đủ. Nhưng hãy cân nhắc có thật cần đọc mọi tin nhắn không. Một bot chỉ trả lời khi được gọi bằng lệnh gạch chéo nhận ít dữ liệu hơn, gửi ít dữ liệu hơn tới hãng AI, và các thành viên dễ hiểu bot làm gì hơn.

Giới hạn số lần gọi

Tài liệu Rate Limits ghi khi vượt giới hạn, API trả mã 429 kèm thân JSON cho biết thời gian cần chờ; phản hồi có các tiêu đề cho biết giới hạn thuộc nhóm nào, kể cả giới hạn toàn cục. Bot viết đúng phải đọc thông tin đó và chờ rồi mới gọi lại, thay vì gọi dồn dập. Với bot AI, việc gọi mô hình thường chậm hơn việc gửi tin, nên ít khi chạm giới hạn của Discord; nhưng nếu bot trả lời mọi tin trong một kênh đông người, cả hai giới hạn, của Discord và của hãng AI, đều có thể bị chạm.

Độ tuổi và dữ liệu

Điều khoản dịch vụ của Discord ghi khi dùng dịch vụ, bạn xác nhận mình ít nhất 13 tuổi và đủ tuổi tối thiểu theo luật nước mình; dịch vụ không dành cho người dưới 13 tuổi. Khi tạo tài khoản, bạn xác nhận đã đủ tuổi trưởng thành nơi mình sống, hoặc cha mẹ, người giám hộ đồng ý chịu ràng buộc bởi điều khoản thay bạn. Hãng AI bạn gọi có điều kiện tuổi riêng, nhiều API yêu cầu từ 18.

Mọi nội dung bot gửi tới mô hình đi tới hãng AI. Ghi rõ trong mô tả bot rằng câu hỏi được xử lý bởi dịch vụ AI bên ngoài. Vì ai trong máy chủ cũng nhắn được cho bot, văn bản có thể cố điều khiển mô hình; xem bài prompt injection, và đừng cho bot quyền quản trị máy chủ.

Gắn AI vào một lệnh

Khi lệnh /hoi được gọi, phần xử lý của bạn làm bốn việc: lấy câu hỏi từ tham số, cắt bớt nếu quá dài, gọi mô hình với lời dặn hệ thống rõ ràng, rồi gửi câu trả lời về kênh. Lời dặn nên nói bot này dành cho ai, trả lời dài tối đa bao nhiêu, và khi không chắc thì nói không biết. Gọi mô hình có thể mất vài giây, nên báo cho người dùng biết bot đang trả lời, rồi gửi kết quả khi xong. Bọc lời gọi trong xử lý lỗi: khi hãng AI báo lỗi hay hết hạn mức, bot gửi một câu xin lỗi ngắn thay vì im lặng.

Chạy bot ở đâu

Bot chỉ trả lời khi chương trình đang chạy. Để thử, chạy trên máy của bạn là đủ. Để cả câu lạc bộ dùng hằng ngày, cần một máy luôn bật, như máy của phòng lab hay một máy chủ nhỏ, và một người phụ trách theo dõi lỗi, chi phí, cập nhật thư viện.

Ví dụ: bot hỏi đáp cho câu lạc bộ

Giả sử câu lạc bộ tin học có máy chủ Discord, thành viên hay hỏi lịch sinh hoạt, cách cài môi trường lập trình, quy định nộp bài. Bot có một lệnh /hoi với tham số câu_hỏi. Khi được gọi, bot gửi câu hỏi cùng một đoạn thông tin chính thức của câu lạc bộ tới mô hình, dặn chỉ trả lời dựa trên đoạn đó, rồi trả lời trong kênh. Bot không bật quyền đọc mọi tin nhắn, không có quyền xóa tin hay cấm thành viên. Ban chủ nhiệm giới hạn mỗi người vài câu mỗi ngày để kiểm soát chi phí.

Cẩn thận
  • Đặt tên lệnh có chữ hoa hay khoảng trắng; Discord sẽ từ chối.
  • Bật quyền đọc mọi tin nhắn khi bot chỉ cần trả lời lệnh.
  • Gọi lại API dồn dập khi nhận mã 429 thay vì chờ.
  • Cho bot quyền quản trị máy chủ.
  • Đưa token bot lên GitHub.

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

Tên lệnh gạch chéo của Discord có dùng tiếng Việt được không?

Được, chữ có dấu là chữ cái; nhưng phải viết thường, không khoảng trắng, tối đa 32 ký tự.

Bot Discord đọc tin nhắn cần quyền gì?

Quyền Message Content, một quyền đặc biệt phải bật trong cổng nhà phát triển.

Mã 429 trong Discord là gì?

Là báo vượt giới hạn số lần gọi; chờ đúng thời gian trong phản hồi rồi gọi lại.

Bao nhiêu tuổi thì được dùng Discord?

Điều khoản ghi từ 13 tuổi và đủ tuổi tối thiểu theo luật nước bạn.

Học tiếp

Nếu bạn muốn học Python và AI bài bản cùng giảng viên, tham khảo khóa học AI của Big-O Coding.

Muốn học bài bản cùng giảng viên?

Khóa AI – Introduction to Machine Learning: nền tảng Máy học từ thuật toán cơ bản đến Neural Networks và LLM, học bằng Python. Học thử buổi 1 miễn phí.

Xem Khóa AI

Nguồn tham khảo

Chia sẻ: Facebook LinkedIn
Nhắn Zalo tư vấnZalo Gọi 0937 401 483