Skrun: Công cụ mã nguồn mở giúp triển khai kỹ năng AI Agent dưới dạng API

Skrun là một công cụ mã nguồn mở mới nổi, được thiết kế để giúp các nhà phát triển dễ dàng chuyển đổi các kỹ năng của AI Agent (Agent Skills) thành các API có thể gọi được. Với Skrun, việc triển khai các tác nhân AI thông minh trở nên đơn giản hơn bao giờ hết, cho phép tích hợp sâu vào các ứng dụng và quy trình làm việc hiện có.

Skrun Banner

Skrun là gì?

Về cơ bản, Skrun hoạt động như một cầu nối giữa các định nghĩa kỹ năng của AI (thường được lưu trong tệp SKILL.md) và một endpoint API thực tế. Thay vì phải xây dựng hạ tầng server phức tạp để chạy một AI Agent, Skrun cho phép bạn "đóng gói" kỹ năng đó và expose nó dưới dạng một API REST thông qua lệnh POST /run.

Dự án hiện hỗ trợ runtime cục bộ mạnh mẽ và đang trong lộ trình phát triển tính năng triển khai đám mây (cloud deploy).

Các tính năng nổi bật

Skrun tập trung vào việc cung cấp trải nghiệm phát triển (DX) mượt mà cho các kỹ sư làm việc với AI:

• Đa mô hình (Multi-model): Hỗ trợ nhiều nhà cung cấp mô hình lớn bao gồm Anthropic, OpenAI, Google, Mistral và Groq. Hệ thống còn có khả năng tự động chuyển đổi (fallback) sang mô hình khác khi cần thiết.
• Có trạng thái (Stateful): Các Agent có khả năng "ghi nhớ" thông tin qua các lần chạy khác nhau thông qua cơ chế lưu trữ trạng thái key-value, giúp duy trì ngữ cảnh hội thoại.
• Hỗ trợ Tool Calling: Skrun cung cấp hai cách tiếp cận để Agent tương tác với bên thứ ba: sử dụng các công cụ CLI (scripts tùy chỉnh) hoặc kết nối với các MCP servers (Model Context Protocol), tiêu chuẩn tương tự như Claude Desktop sử dụng.
• Tiêu chuẩn SKILL.md: Sử dụng định dạng tệp chuẩn, tương thích với các công cụ phổ biến như Claude Code, Copilot và Codex.

Build Status

Bắt đầu nhanh với Skrun

Để sử dụng Skrun, bạn cần cài đặt CLI của nó thông qua npm:

npm install -g @skrun-dev/cli

Quy trình làm việc cơ bản bao gồm 3 bước: Khởi tạo, Triển khai và Gọi API.

1. Khởi tạo Agent

Bạn có thể tạo một agent mới hoặc nhập một kỹ năng đã có sẵn:

# Tạo mới
skrun init my-agent
cd my-agent

# Hoặc nhập từ kỹ năng có sẵn
skrun init --from-skill ./my-skill

Quá trình này sẽ tạo ra tệp SKILL.md (chứa hướng dẫn cho Agent) và agent.yaml (cấu hình runtime).

2. Phát triển và kiểm thử cục bộ

Chạy môi trường phát triển cục bộ để kiểm tra Agent của bạn:

skrun dev
# Server sẽ chạy tại http://localhost:3000

Bạn cũng có thể chạy các bài kiểm tra tự động:

skrun test

3. Triển khai

Khi đã sẵn sàng, hãy triển khai agent của bạn:

skrun deploy

Sau khi triển khai, bạn có thể gọi API ngay lập tức:

curl -X POST localhost:4000/api/agents/dev/my-skill/run \
-H "Authorization: Bearer " \
-H "Content-Type: application/json" \
-d '{"input": {"query": "analyze this"}}'

NPM Version

Các ví dụ minh họa (Demo Agents)

Skrun đi kèm với nhiều ví dụ để người dùng dễ hình dung khả năng ứng dụng:

• code-review: Nhập kỹ năng để tạo một API đánh giá chất lượng mã nguồn.
• pdf-processing: Sử dụng tool calling với các script cục bộ để xử lý PDF.
• seo-audit: Tận dụng tính năng stateful để chạy phân tích nhiều lần và so sánh kết quả.
• data-analyst: Nhận đầu vào là file CSV và trả về các thông tin chi tiết có cấu trúc.
• web-scraper: Sử dụng MCP server với trình duyệt headless (thông qua @playwright/mcp).

Kết luận

Skrun v0.1 hiện đã sẵn sàng để sử dụng với runtime cục bộ. Đây là một công cụ hứa hẹn cho cộng đồng AI và các nhà phát triển phần mềm muốn tích hợp các khả năng của AI Agent vào sản phẩm của mình một cách nhanh chóng và chuẩn hóa. Với kiến trúc đã sẵn sàng cho Cloud Deploy, Skrun có thể sẽ trở thành một giải pháp quan trọng trong kỷ nguyên phát triển ứng dụng AI.

Bạn có thể tìm hiểu thêm và đóng góp cho dự án tại kho GitHub chính thức của Skrun.