Yuanbao — Trợ lý AI của Tencent
hướng dẫn dễ hiểu dựa trên tài liệu chính thức
Yuanbao — Trợ lý AI của Tencent
Hãy tưởng tượng bạn đang ở một bữa tiệc công ty lớn, và bạn muốn trợ lý AI của mình tham gia vào mọi cuộc trò chuyện — cả chat riêng lẫn thảo luận nhóm. Đó chính xác là những gì tính năng này làm: nó kết nối trực tiếp agent Hermes của bạn vào nền tảng nhắn tin Yuanbao của Tencent, để AI của bạn có thể gửi và nhận tin nhắn theo thời gian thực, giống như một đồng nghiệp hữu ích vậy.
Những gì bạn cần chuẩn bị trước khi bắt đầu
Cứ coi như đây là việc đăng ký hội viên phòng gym — bạn cần vài thứ trước đã:
- Một tài khoản Yuanbao có quyền tạo bot (hỏi quản trị viên nếu bạn không chắc chắn)
- APP_ID và APP_SECRET cá nhân của bạn (giống như tên đăng nhập và mật khẩu cho bot của bạn)
- Các gói Python được cài đặt trên máy tính
Chạy lệnh này để cài đặt mọi thứ:
pip install websockets httpx aiofiles
Bước 1: Tạo Bot của bạn
Đầu tiên, tải ứng dụng Yuanbao từ https://yuanbao.tencent.com/. Khi đã vào được:
- Đi tới PAI → My Bot
- Nhấp vào “Create New Bot”
- Sau khi tạo xong, sao chép APP_ID và APP_SECRET — hãy giữ chúng an toàn, như mã PIN thẻ ATM của bạn vậy!
Bước 2: Để Wizard lo phần còn lại
Hermes có một trợ lý ma thuật giúp bạn thiết lập mọi thứ. Chỉ cần gõ:
hermes gateway setup
Khi được hỏi, chọn Yuanbao. Wizard sẽ:
- Hỏi APP_ID của bạn
- Hỏi APP_SECRET của bạn
- Tự động lưu mọi thứ
Mẹo chuyên nghiệp: Bạn không cần lo lắng về URL WebSocket hay domain API — chúng đã được điền sẵn với các giá trị mặc định thông minh. Bạn chỉ cần cung cấp hai khóa đó mà thôi.
Bước 3: Kiểm tra lại cài đặt
Sau khi wizard hoàn tất, hãy nhìn vào file cấu hình tại ~/.hermes/.env. Bạn sẽ thấy nội dung tương tự như:
YUANBAO_APP_ID=your_app_id_here
YUANBAO_APP_SECRET=your_secret_here
YUANBAO_WS_URL=wss://default-websocket-url
YUANBAO_API_DOMAIN=https://default-api-domain
Nếu mọi thứ trông ổn, bạn đã sẵn sàng để bắt đầu!
Điều gì làm tính năng này đặc biệt?
Yuanbao không chỉ là một ứng dụng chat thông thường — nó được xây dựng cho công việc nghiêm túc. Nó sử dụng WebSocket (cứ nghĩ như một đường dây điện thoại mở vĩnh viễn thay vì gửi thư qua lại) để truyền tin nhắn tức thời. Thêm vào đó, nó hỗ trợ đa phương tiện phong phú: hình ảnh, file, và cả tin nhắn thoại. Vì vậy AI của bạn có thể gửi ảnh chụp màn hình, chia sẻ file PDF, hoặc chuyển tiếp một ghi âm giọng nói, giống hệt một đồng đội thực thụ.
Tổng kết
Kết nối Hermes với Yuanbao giống như trao cho AI của bạn một thẻ nhân viên công ty — giờ đây nó có thể tham gia trò chuyện, trả lời câu hỏi, và chia sẻ file theo thời gian thực. Toàn bộ quá trình thiết lập mất chưa đến năm phút, và wizard sẽ lo phần nhàm chán.
Mẹo thực tế cho người mới bắt đầu: Hãy bắt đầu với một bài kiểm tra đơn giản — gửi tin nhắn cho bot của bạn trong một cuộc trò chuyện riêng trước. Khi đã hoạt động, hãy thử thêm nó vào một nhóm. Bằng cách này, bạn sẽ phát hiện sớm các vấn đề thiết lập và xây dựng sự tự tin trước khi chuyển sang chế độ “đồng nghiệp AI” hoàn toàn. Chúc bạn tự động hóa vui vẻ!
📖 Tài liệu chính thức
この記事は Hermes Agent のTài liệu chính thứcに基づいています:Tài liệu chính thức › user-guide/messaging/yuanbao