Khái niệm
Kiến trúc AgentKit
Tìm hiểu cách CLI, Kit được phát hành, runtime adapter và project của bạn phối hợp với nhau.
AgentKit nằm giữa các gói workflow đã phát hành và coding assistant được hỗ trợ. CLI xử lý việc cài đặt và các thao tác lifecycle; assistant vẫn chạy phiên AI và các công cụ của nó.
flowchart TB
accTitle: Từ Kit đã xác minh đến các bề mặt runtime
accDescr: Registry yêu cầu xác thực cung cấp bản phát hành Kit đã xác minh cho AgentKit CLI. CLI chuyển Kit qua adapter thành các bề mặt của Claude Code, Codex hoặc Cursor.
registry["Registry yêu cầu xác thực"] --> release["Bản phát hành Kit đã xác minh"]
release --> cli["AgentKit CLI"]
cli --> adapter["Chuyển đổi qua adapter"]
adapter --> claude["Bề mặt Claude Code"]
adapter --> codex["Bề mặt Codex"]
adapter --> cursor["Bề mặt Cursor"]Các phần của hệ thống
- AgentKit CLI (
ak) xác thực quyền truy cập, phân giải gói Kit đã phát hành, xác minh nội dung phát hành, cài đặt qua adapter được chọn và quản lý cập nhật, chẩn đoán, gỡ cài đặt cùng snapshot khôi phục. - Kit đã phát hành đóng gói workflow và các thành phần hỗ trợ thành một đơn vị có phiên bản. Bạn có thể cài toàn bộ Kit hoặc chọn Skills khi lệnh hỗ trợ.
- Runtime adapter chuyển các bề mặt được hỗ trợ của Kit thành tệp và đăng ký mà Claude Code, Codex hoặc Cursor hiểu được. Adapter cũng báo nội dung mà runtime đích không thể kích hoạt.
- Scope project hoặc người dùng quyết định nội dung đã chuyển đổi có hiệu lực ở đâu. Scope project là mặc định cho workspace hiện tại. Scope người dùng làm cho bản cài khả dụng qua các thư mục người dùng của runtime đó.
- Coding assistant khám phá nội dung đã cài và thực hiện workflow bằng model, công cụ, hệ thống quyền và lifecycle event của chính nó.
Điều gì xảy ra khi bạn dùng một workflow
- Bạn chọn outcome và gọi một Skill, hoặc yêu cầu runtime chạy workflow có giao việc cho Agent.
- Runtime tải hướng dẫn đã được chuyển đổi cùng các tệp hỗ trợ mà nó biết cách sử dụng.
- Skills, Agents và các Hooks được hỗ trợ phối hợp thực hiện công việc. Hành vi chính xác phụ thuộc vào capability của runtime.
- Workflow có thể tạo hoặc thay đổi artifact trong project như code, plan hay report.
- Bạn review kết quả và quyết định nội dung nào được giữ, commit, publish hoặc gửi ra ngoài.
Cài một Kit không tự chạy workflow. Việc cài đặt cũng không tự commit hoặc publish thay đổi trong project. Workflow có thể tác động đến hệ thống bên ngoài, làm lộ dữ liệu hoặc phát sinh chi phí vẫn cần quyền và xác nhận theo yêu cầu của runtime và workflow đó.
Cài đặt và thực thi là hai việc riêng
AgentKit sở hữu lifecycle cài đặt đối với các tệp mà nó xác định được là do mình quản lý. Coding assistant sở hữu việc thực thi. Repository và artifact do bạn tạo vẫn thuộc về bạn.
Sự tách biệt này quan trọng khi cập nhật và gỡ cài đặt: AgentKit có thể thay thế hoặc xóa tệp chưa đổi mà nó đã cài trước đó, nhưng sẽ giữ tệp không rõ nguồn gốc hoặc đã được người dùng sửa khi không chứng minh được quyền sở hữu. Xem Projects, artifacts và checkpoints để hiểu mô hình khôi phục.