Chuyển đến nội dung chính
Blog

Hướng dẫn AgentKitBài 10/21

Hệ sinh thái AgentKit: Vault, Render, CloudHarness, SkillX, TOSE là gì và dùng khi nào

6 phút đọc
Ảnh bìa
Bài 10/20 trong bộ onboarding AgentKit v3. Đọc khoảng 10 phút.

AgentKit là cái lõi. Xung quanh nó có mấy sản phẩm nhỏ hơn, mỗi cái giải đúng một bài toán mà tui gặp khi làm việc với agent hằng ngày. Bài này là tấm bản đồ: mỗi món là gì, trạng thái tới đâu, nối với ak bằng cách nào, và khi nào bạn thật sự cần nó.

Sản phẩm Một câu Trạng thái Nối với ak qua
AK Vault Cất và đồng bộ secret mã hoá đầu cuối ✅ cục bộ, 🧪 đồng bộ ak secrets
AK Render Agent viết spec, ra trang HTML tương tác ✅ Cờ --ak-render trong skill
CloudHarness MCP Agent làm việc trong sandbox từ xa ✅ live, beta Gói kit cloud-harness 🧪
SkillX Chợ skill có chữ ký, personal kit ✅ chợ, 🧪 personal kit ak skills
TOSE Nền tảng host app, deploy từ Git ✅ Skill ak-deploy

Hệ sinh thái AgentKit

1/ AK Vault ✅ / 🧪

vault.agentkit.best

Giải bài toán: API key nằm rải rác trong .env, agent đọc được, đổi máy là mất.

Cách dùng: vault cục bộ ak secrets đã ship. Đồng bộ E2E đa thiết bị qua vault.agentkit.best là preview.

Khi nào cần: ngay hôm nay, cho phần cục bộ. Phần đồng bộ thì đợi GA nếu là key production.

Mã nguồn mở, MIT: bestagentkits/ak-vault. Chi tiết đầy đủ và cảnh báo ở bài 6.


2/ AK Render ✅

render.agentkit.best

Giải bài toán: bảo agent "làm cho tui cái dashboard báo cáo" thì mỗi lần nó viết ra một mớ HTML/CSS/JS khác nhau, lỗi lặt vặt, có khi còn gọi CDN lung tung.

Cách AK Render làm: agent không viết HTML. Nó viết một Page Spec bằng YAML/JSON, rồi trình biên dịch tạo ra một file HTML tự chứa, chạy offline, kết quả xác định (cùng spec ra cùng file).

  • Khoảng 90 loại block trong 8 nhóm, có recipe sẵn (dashboard, report, incident...), theme, icon, motion.

  • Trang xuất ra không gửi request mạng nào, font nhúng sẵn, spec không cho phép HTML/CSS/JS thô.

  • Không cần tài khoản hay API key.

Thử ngay (cần Node 20.11 trở lên):

npx -y @bestagentkits/render validate plan.yaml
npx -y @bestagentkits/render plan.yaml --out plan.html

Có MCP server cho agent gọi trực tiếp:

npx -y @bestagentkits/render mcp

Nối với AgentKit thế nào? Không có lệnh ak render. Thay vào đó, các skill ak-brainstorm, ak-explain và ak-preview có cờ --ak-render:

/ak-explain kiến trúc module thanh toán --ak-render

Gói npm @bestagentkits/render bản 0.3.0, mã nguồn MIT.


3/ CloudHarness MCP ✅ beta

Giải bài toán: bạn muốn agent làm việc trên repo mà không chạy trên máy bạn: clone cô lập, chạy lệnh, chạy test, mở PR, rồi dọn sạch.

Cách làm: một MCP server qua HTTP có xác thực. Agent gọi workspace_open với URL repo, làm việc bằng các tool (file, code intel, shell, Git, worktree, task...), rồi workspace_close. Mỗi workspace là một bản clone trong container Docker có thời hạn.

Kết nối:

  • Client hỗ trợ OAuth: https://harness.zuey.me/mcp

  • Client chỉ gửi được header tĩnh: https://api.harness.zuey.me/mcp với API key lấy từ dashboard

Chế độ chạy cục bộ qua stdio (chỉ POSIX, Windows thì qua WSL):

cloud-harness-mcp --transport stdio --workspace /duong/dan/repo

⚠️ Cảnh báo bảo mật phải đọc

README của CloudHarness ghi rõ, và tui nhắc lại:

  • Đây là một miền tin cậy duy nhất (single trust domain). Những người vận hành chung một instance phải tin nhau.

  • Agent chạy được lệnh tuỳ ý trong executor dùng chung kernel. Không phải sandbox cho nhiều khách hàng không tin nhau.

  • Chế độ cục bộ giới hạn đường dẫn, nhưng không phải sandbox của hệ điều hành.

Phiên bản: bản ổn định gần nhất 0.76.2, bản pre-release mới nhất v0.80.0-beta.2. Mã nguồn MIT: bestagentkits/cloud-harness-mcp. Routine vận hành chính AgentKit cũng dùng CloudHarness (bài 9).


4/ SkillX ✅ / 🧪

skillx.sh

Giải bài toán: tìm skill tốt, cài skill có chữ ký, chia sẻ và đồng bộ skill của riêng bạn.

  • Chợ skill skillx.sh và CLI skillx-sh 0.8.0: đã ship.

  • Đọc, kiểm tra skill từ ak không chạy script (ak skills inspect, ak skills read): có trong 3.0.0.

  • Personal kit, publish và sync riêng tư: preview, API phía server còn sau cờ.

Mã nguồn: nextlevelbuilder/skillx. Hướng dẫn chi tiết ở bài 5.


5/ TOSE ✅

tose.sh

Giải bài toán: code xong rồi, giờ deploy ở đâu cho nhanh mà không phải làm DevOps?

TOSE (tose.sh) là nền tảng host app chạy trên Kubernetes: nối repo Git, build và deploy kèm domain và TLS, có template app AI agent, database managed, cloud desktop dùng chung. Trả trước theo ví, tính theo giờ, thanh toán USD hoặc VND.

CLI:

npm i -g @tosesh/tose
tose login # hoặc đặt biến TOSE_API_KEY
tose whoami
tose init
tose up

Có MCP connector (OAuth 2.1) cho agent, với cổng duyệt hai bước cho deploy và rollback. Agent không tự đẩy production mà bạn không biết.

Nối với AgentKit: skill ak-deploy nhận TOSE là một đích deploy, tự phát hiện khi project có tose.yaml:

/ak-deploy lên TOSE

Mã nguồn TOSE hiện là private.


Vì sao tui tách ra nhiều sản phẩm?

Câu hỏi hợp lý: sao không gom hết vào ak cho gọn?

Vì mỗi món có mô hình tin cậy khác nhau. Vault phải zero-knowledge. Render phải chạy offline không cần tài khoản. CloudHarness chạy code tuỳ ý nên phải tách hẳn khỏi máy bạn. TOSE đụng tới tiền và hạ tầng thật. Gom chung một chỗ thì một lỗ hổng ở chỗ này kéo sập chỗ kia.

Cái giá phải trả là hệ sinh thái đang hơi rải rác: nhiều domain (agentkit.best, skillx.sh, tose.sh, zuey.me), nhiều tổ chức GitHub. Tui biết, và đã ghi vào báo cáo gap việc cần một trang tổng hợp duy nhất.


Bài tiếp: Chương trình Contributor và kiếm tiền cùng AgentKit →

Nguồn

Tìm hiểu sâu hơn trong tài liệu

Trang tham chiếu cho từng lệnh, skill, hook và thiết lập nhắc đến trong bài.

Đọc tài liệu →

Chia sẻ bài viết