KUNGFU TECH

0
0
Lập trình
Sơn Tùng Lê
Sơn Tùng Lê103931498422911686980

Hướng Dẫn Cài Đặt evi-run Trên DigitalOcean và VPS Khác

Đăng vào 8 tháng trước

• 5 phút đọc

Chủ đề:

#ai#python#agent#framework

Giới Thiệu

evi-run là một hệ thống AI đa tác nhân sẵn sàng để triển khai, được xây dựng trên SDK OpenAI Agents. Hệ thống này cung cấp khả năng trí tuệ nhân tạo mạnh mẽ thông qua giao diện bot Telegram thuận tiện và hỗ trợ các chế độ hoạt động từ sử dụng cá nhân đến ứng dụng thương mại.

Đặc Điểm Kỹ Thuật Chính

  • Kiến trúc: Hệ thống đa tác nhân với tác nhân chính, các tác nhân phụ chuyên biệt và các công cụ.
  • Backend: Python, OpenAI Agents SDK, FastAPI.
  • Cơ sở dữ liệu: PostgreSQL cho dữ liệu + Redis cho caching.
  • Giao diện: Telegram Bot API.
  • Containerization: Docker Compose cho việc điều phối dịch vụ.
  • Tích hợp: Máy chủ MCP, Solana RPC.

Yêu Cầu Hệ Thống

Yêu Cầu Tối Thiểu Cho Droplet Trên DigitalOcean

  • CPU: 1 vCPU.
  • RAM: 1GB.
  • Lưu trữ: 25GB SSD.
  • Hệ điều hành: Ubuntu 22.04 LTS.
  • Mạng: 1TB truyền tải.

Các Khoá API Cần Thiết

  • Telegram Bot Token - lấy từ @BotFather.
  • OpenAI API Key - lấy từ Nền tảng OpenAI.
  • Telegram User ID - lấy từ @userinfobot.

Hãy cẩn thận tìm bot trong danh sách và kiểm tra tất cả các ký tự trong tên.

Bước 1: Tạo và Cấu Hình Droplet Trên DigitalOcean

Sử dụng bất kỳ hướng dẫn tạo Droplet nào hoặc tham khảo tài liệu nhanh Droplet chính thức nếu bạn gặp khó khăn.

Tạo Một Droplet

  1. Đăng nhập vào bảng điều khiển DigitalOcean và nhấp vào "Tạo → Droplets".
  2. Chọn hình ảnh hệ điều hành:
    • Phân phối: Ubuntu.
    • Phiên bản: 22.04 (LTS) x64.
  3. Chọn kích thước Droplet:
    • Tối thiểu: Kế hoạch cơ bản → Regular → 6$/tháng (1GB RAM, 1 vCPU, 25GB SSD).
    • Hoặc cao hơn, tùy thuộc vào tải dự kiến.
  4. Cấu hình xác thực:
    • Đặt mật khẩu root mạnh mẽ.
    • Hoặc sử dụng SSH Key.
  5. Cài đặt bổ sung:
    • Tên máy chủ: evi-run-server.
    • Bật giám sát (tùy chọn).
    • Bật sao lưu (tùy chọn).
  6. Tạo Droplet - quá trình sẽ mất 1-2 phút.

Kết Nối Với Máy Chủ

Tùy chọn 1: Bảng điều khiển web DigitalOcean (được khuyến nghị cho người mới bắt đầu)

  1. Trong bảng điều khiển DigitalOcean, đi đến Droplet của bạn.
  2. Nhấp vào nút "Console" ở góc trên bên phải.
  3. Chờ cho terminal web tải.
  4. Đăng nhập với root và mật khẩu bạn đã chỉ định trong quá trình tạo.

Tùy chọn 2: SSH qua terminal

Dán mật khẩu bằng cách nhấp chuột phải vào một lần, mật khẩu sẽ không hiển thị trong dòng nhập, chỉ cần nhấn Enter.

Thiết Lập Ban Đầu

Cập nhật hệ thống và cài đặt các tiện ích cần thiết:

Thực hiện từng lệnh một (theo từng dòng), sao chép dòng lệnh và dán vào console bằng cách nhấp chuột phải.

Copy 
apt update && apt upgrade -y
apt install -y curl wget git nano

Chờ cho các lệnh hoàn thành cho đến khi dấu nhắc nhập xuất hiện.

Bước 2: Cài Đặt Docker và Docker Compose

evi-run có một kịch bản cài đặt Docker tự động:

Copy 
# Chuyển đến thư mục làm việc
cd /opt

# Clone kho lưu trữ
sudo git clone https://github.com/pipedude/evi-run.git

# Đặt quyền truy cập
sudo chown -R $USER:$USER evi-run
cd evi-run

Chạy cài đặt Docker tự động:

Copy 
# Biến kịch bản thành có thể thực thi
chmod +x docker_setup_en.sh

# Chạy cài đặt (cần sudo)
sudo ./docker_setup_en.sh

Bước 3: Cấu Hình evi-run

Thiết Lập Biến Môi Trường

Sao chép và chỉnh sửa tệp môi trường:

Copy 
# Sao chép cấu hình mẫu
cp .env.example .env

# Chỉnh sửa cấu hình
nano .env

Điền vào các tham số cần thiết trong .env:

Copy 
# CẦN THIẾT: Telegram bot token từ @BotFather
TELEGRAM_BOT_TOKEN=your_bot_token_here

# CẦN THIẾT: OpenAI API key
API_KEY_OPENAI=your_openai_api_key

Chèn token và key của bạn thay cho XXX, không có dấu ngoặc kép hay định dạng khác.

Cách lưu tệp trong nano:

  • Nhấn Ctrl + X để thoát.
  • Nhấn Y để xác nhận lưu.
  • Nhấn Enter để xác nhận tên tệp.

Thiết Lập Cấu Hình Chính

Chỉnh sửa config.py:

Copy 
nano config.py

Các tham số cần thay đổi:

Copy 
# CẦN THIẾT: ID Telegram của bạn từ @userinfobot
ADMIN_ID = 123456789

# Danh sách quản trị viên (tùy chọn, thêm ID người dùng sẽ có quyền quản trị)
ADMINS_LIST = [123456789, 987654321]

# Chế độ hoạt động: 'private', 'free' hoặc 'pay'
TYPE_USAGE = 'private'  # Bắt đầu với private để thử nghiệm

Thiết Lập Cấu Hình Tác Nhân (Tùy Chọn)

  • Xem hướng dẫn: Hướng dẫn bắt đầu nhanh evi-run trên Ubuntu: cài đặt, thiết lập nhân vật và thêm tác nhân tùy chỉnh.

Bước 4: Xây Dựng và Chạy Hệ Thống

Xây Dựng Các Container và Khởi Động Hệ Thống

Copy 
# Xây dựng tất cả các dịch vụ
docker compose up --build -d

Đầu ra mong đợi:

Bước 5: Kiểm Tra Chức Năng

Kiểm Tra Bot Telegram

  1. Tìm bot của bạn trong Telegram theo tên người dùng - xem trong @BotFather.
  2. Gửi lệnh /start.
  3. Thử một yêu cầu đơn giản, ví dụ: "Xin chào, bạn khỏe không?"

Thông Tin Bổ Sung

Lệnh Hữu Ích

Khởi động lại hệ thống (sau khi thay đổi mã):

Copy 
cd /opt/evi-run
docker compose down
docker compose up --build -d

Tắt hệ thống:

Copy 
cd /opt/evi-run
docker compose down

Xem nhật ký:

Copy 
# Tất cả nhật ký hệ thống
docker compose logs -f

# Nhật ký dịch vụ cụ thể
docker compose logs -f bot

# Nhật ký từ giờ trước
docker compose logs --since 1h bot

Kết Luận

Sau khi hoàn thành tất cả các bước, bạn sẽ có một hệ thống AI đa tác nhân evi-run hoàn toàn hoạt động trên VPS. Bây giờ hãy bắt đầu cấu hình hệ thống của bạn một cách chi tiết. Chúc bạn có một trải nghiệm lập trình tốt! 💜

Tài Nguyên Hữu Ích

  • Tài liệu evi-run.
  • Tài liệu SDK OpenAI Agents.
  • Tài liệu DigitalOcean.
  • Tài liệu tham khảo Docker Compose.
  • Tài liệu PostgreSQL.

Cộng Đồng và Hỗ Trợ

  • Cộng đồng Telegram: evi_run.
  • Kho lưu trữ GitHub: Báo cáo sự cố.

Bài viết này được viết cho những người mới bắt đầu trong cộng đồng kỹ thuật trên DEV, những người quan tâm đến việc triển khai hệ thống AI. Các câu hỏi và đề xuất cải thiện rất được chào đón!

Nội dung bài viết

Gợi ý câu hỏi phỏng vấn
Không có dữ liệu

Không có dữ liệu

Bài viết được đề xuất
Bài viết cùng tác giả

Bình luận

Chưa có bình luận nào

Chưa có bình luận nào