DingTalk — AI cho Nơi làm việc Trung Quốc

Hãy tưởng tượng bạn bước vào một văn phòng ở Thượng Hải, nơi những câu chuyện phiếm bên máy làm mát nước diễn ra ngay trong một biểu tượng ứng dụng màu xanh dương sáng chói — DingTalk. Nó vừa giống Slack, vừa giống Trello, lại vừa là cổng thông tin nhân sự, và với hàng trăm triệu người dùng, nó chính là nơi làm việc. Giờ hãy tưởng tượng agent AI của bạn, Hermes, âm thầm hoạt động bên trong ứng dụng đó — trả lời thắc mắc, phân loại công việc và gửi các thông báo tiếp theo mà không bao giờ rời khỏi cuộc trò chuyện. Đó chính là lời hứa của việc tích hợp DingTalk vào Hermes Agent.

Tại Sao DingTalk Lại Quan Trọng Với AI Agent

Hầu hết các bài hướng dẫn về AI agent đều giả định môi trường làm việc nói tiếng Anh và sử dụng công cụ phương Tây. Nhưng ở Trung Quốc, DingTalk là hệ điều hành mặc định cho giao tiếp doanh nghiệp. Nếu bạn đang xây dựng một agent mã nguồn mở cho một nhóm ở Thâm Quyến hay một nhà máy ở Thành Đô, bạn cần một cầu nối bản địa. Hermes Agent hiện cung cấp chính xác điều đó — một tích hợp sạch sẽ, dựa trên cấu hình, biến bất kỳ nhóm DingTalk nào thành trung tâm chỉ huy cho agent của bạn.

Thiết Lập Bot DingTalk

Bạn có hai lựa chọn: webhook (đơn giản nhất, một chiều) hoặc callback (song công hoàn toàn, có thể nhận tin nhắn). Đối với một trợ lý thực thụ, bạn sẽ cần chế độ callback. Quy trình như sau:

1. Tạo một bot trong Bảng điều khiển Nhà phát triển DingTalk.
2. Lấy AppKey và AppSecret của bạn.
3. Thiết lập một URL callback công khai (bắt buộc dùng HTTPS) để nhận tin nhắn đến.
4. Cấu hình webhook gửi đi của bot để trả lời.

Trong Hermes, bạn khai báo điều này trong config.yaml:

channels:
  dingtalk:
    enabled: true
    mode: callback          # hoặc "webhook" cho cảnh báo một chiều
    app_key: "your_app_key"
    app_secret: "your_app_secret"
    callback_url: "https://your-server.com/dingtalk/callback"
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx"  # dùng để trả lời
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

Nhận Tin Nhắn

Khi URL callback đã hoạt động, DingTalk sẽ đẩy mọi tin nhắn nhóm đến Hermes. Agent sẽ phân tích dữ liệu JSON, trích xuất người gửi, ID cuộc trò chuyện và nội dung văn bản, sau đó chuyển đến quy trình xử lý kỹ năng của bạn. Bạn có thể lọc theo từ khóa, đề cập (@mention), hoặc thậm chí theo nhóm cụ thể. Ví dụ: chỉ phản hồi khi bot được @đề cập:

channels:
  dingtalk:
    filters:
      require_mention: true
      allow_groups:
        - "ops-alerts"
        - "ai-assistant"

Gửi Phản Hồi

Phản hồi sẽ được gửi lại qua URL webhook. Hermes tự động bọc phản hồi trong đúng định dạng tin nhắn DingTalk — văn bản thuần túy, markdown hoặc thẻ tương tác. Đây là một kỹ năng tối giản để gửi lại lời chào:

@agent.skill
async def greet(ctx, text):
    return f"Hello from Hermes! You said: {text}"

Không cần gọi HTTP thủ công. Hermes tự xử lý chữ ký, dấu thời gian và khung JSON cho bạn.

Tổng Kết

Tích hợp DingTalk biến Hermes từ một công cụ chỉ chạy trên terminal thành một thành viên thực thụ trong môi trường làm việc của các nhóm Trung Quốc. Chỉ với vài dòng trong config.yaml, bạn có được nhắn tin hai chiều, lọc theo đề cập và định dạng phản hồi tự động. Dù bạn đang xây dựng một bot QA cho phân xưởng hay một trợ lý cá nhân cho nhà quản lý bận rộn, Hermes + DingTalk nghĩa là AI của bạn nói ngôn ngữ của văn phòng Trung Quốc hiện đại — trôi chảy, đáng tin cậy và không cần một ký tự Trung Quốc nào trong mã nguồn của bạn.

---