4 phút đọc
Dự án OpenHands/software-agent-sdk hiện đang thu hút sự chú ý trong cộng đồng phát triển mã nguồn mở với 1.357 lượt stars và 763 lượt forks. Được xây dựng chủ yếu bằng ngôn ngữ Python và ghi nhận lần cập nhật gần nhất vào ngày 07/11/2026, repository này đóng vai trò là hạt nhân cung cấp bộ công cụ phát triển phần mềm (SDK) tinh gọn và mô-đun hóa, phục vụ việc xây dựng các AI Agent có khả năng làm việc trực tiếp với mã nguồn.
Kiến trúc mô-đun và cơ chế vận hành của OpenHands SDK
OpenHands Software Agent SDK cung cấp các giao diện lập trình ứng dụng (API) trên cả nền tảng Python, TypeScript và REST API. Điểm cốt lõi trong kiến trúc của SDK này là tính linh hoạt trong việc quản lý không gian làm việc (workspace). Các agent có thể sử dụng máy cục bộ làm không gian thao tác hoặc vận hành bên trong các không gian làm việc tạm thời (ephemeral workspaces) dựa trên Docker hoặc Kubernetes thông qua Agent Server.
SDK này không chỉ là một thư viện độc lập mà còn là bộ máy nền tảng đứng sau các công cụ như OpenHands CLI và OpenHands Cloud. Repository đóng vai trò quản lý chính thức bản triển khai Python SDK, Agent Server và TypeScript client có khả năng tương thích với môi trường trình duyệt.
Tích hợp hệ sinh thái và phân định trách nhiệm mô-đun
Trong hệ sinh thái OpenHands, vai trò của từng thành phần được phân định rất cụ thể nhằm đảm bảo tính toàn vẹn của kiến trúc:
- OpenHands/software-agent-sdk: Nơi nắm giữ toàn bộ logic cốt lõi gồm agent, công cụ (tools), cuộc trò chuyện (conversations), không gian làm việc (workspaces), sự kiện (events), REST/WebSocket API và truy cập client dạng định kiểu (typed client access).
- OpenHands/OpenHands: Sử dụng TypeScript client với vai trò là giao diện người dùng Agent Canvas.
- OpenHands/automation: Đảm nhận công việc lập lịch, xử lý webhook, quản lý lịch sử chạy và điều phối nhiệm vụ (dispatching).
Quy trình xử lý chuẩn của toàn hệ thống tuân theo luồng truyền dữ liệu từ SDK/Agent Server qua hợp đồng OpenAPI, đến client TypeScript và cuối cùng hiển thị trên Agent Canvas. Các hành vi backend và endpoint thuộc về Python SDK hoặc Agent Server, trong khi UI nằm hoàn toàn ở Agent Canvas.
Tính năng tích hợp Skill tự động cho các công cụ đóng gói
Một điểm mạnh khác của OpenHands SDK là khả năng mở rộng thông qua các skill công cộng. Khi thiết lập tham số AgentContext(load_public_skills=True), hệ thống sẽ tự động truy cập vào chợ ứng dụng mở rộng OpenHands/extensions.
Nhờ cơ chế này, agent có thể tự động nhận diện và áp dụng các hướng dẫn quản lý gói tương ứng cho những dự án có tệp cấu hình như uv.lock, deno.json, deno.jsonc hoặc deno.lock. Nhóm phát triển cũng cung cấp ví dụ mẫu tối thiểu để kích hoạt tính năng này tại tệp examples/01_standalone_sdk/03_activate_skill.py. Đối với việc thiết lập môi trường phát triển cục bộ từ repository, người dùng thực hiện lệnh make build để cài đặt các phụ thuộc workspace và pre-commit hooks.
Những điểm cần lưu ý và khía cạnh chưa công bố
OpenHands Software Agent SDK mang lại giải pháp toàn diện cho việc phát triển phần mềm tự động bằng AI nhờ việc tách biệt rõ ràng giữa backend và frontend. Mặc dù vậy, từ các dữ liệu hiện có trong README và tài liệu thu thập, một số thông tin quan trọng vẫn chưa được đề cập chi tiết:
- Chi tiết về yêu cầu cấu hình phần cứng tối thiểu để vận hành Agent Server trên Kubernetes hoặc Docker.
- Mức độ tiêu tốn tài nguyên và chỉ số hiệu năng (benchmarks) thực tế khi xử lý các dự án phần mềm cỡ lớn.
- Danh sách đầy đủ tất cả các skill hiện có trên chợ tiện ích OpenHands/extensions ngoài các skill liên quan đến uv và deno.
Nguồn tham khảo: Xem bài gốc
