Aclif: Khung CLI thống nhất giúp AI agent điều khiển mọi nền tảng SaaS

Trong bối cảnh các AI agent ngày càng phải tương tác với nhiều hệ thống doanh nghiệp khác nhau, một dự án mã nguồn mở mới mang tên Aclif (Agent CLI Framework) đang thu hút sự chú ý của cộng đồng lập trình viên. Dự án này giải quyết bài toán nan giải: làm sao để một agent có thể nói chuyện với Salesforce, ServiceNow, DocuSign và nhiều nền tảng khác mà không cần học lại "ngữ pháp" từ đầu cho mỗi hệ thống.

Điểm cốt lõi của Aclif là một ngữ pháp lệnh duy nhất và tên gọi chuẩn hóa — nghĩa là cùng một bản ghi có thể được truy cập bằng cùng một tên trên bất kỳ nền tảng nào. Chẳng hạn, khái niệm "khách hàng" sẽ được ánh xạ thành Account trong Salesforce và core_company trong ServiceNow thông qua các tập alias được cấu hình sẵn.

Tại sao agent cần một CLI riêng?

Các giao thức như MCP (Model Context Protocol) hiện tại xuất bản một danh sách công cụ cố định, và mỗi công cụ trong danh sách đó đều chiếm dụng ngữ cảnh của agent ở mọi lượt hội thoại. Tác giả của máy chủ MCP phải đánh đổi giữa độ bao phủ và chi phí token.

Aclif tiếp cận theo hướng khác: chỉ tải định nghĩa lệnh khi agent thực sự yêu cầu. Điều này có nghĩa là toàn bộ API của mọi nhà cung cấp đều có thể truy cập mà không tốn ngữ cảnh thường trực. Một agent kết nối tới năm nền tảng sẽ có kích thước ngữ cảnh gần như tương đương khi chỉ kết nối một nền tảng.

Một ngữ pháp, một phong bì JSON (envelope), và một bộ từ vựng lỗi chung cho mọi nhà cung cấp. Agent học công cụ một lần, và nền tảng mới chỉ thêm lệnh mà không thêm ngữ pháp.

Những tính năng nổi bật

Aclif mang đến một loạt tính năng được thiết kế riêng cho nhu cầu của AI agent:

• Tên gọi chuẩn hóa: Các tập alias ánh xạ tên khái niệm giữa các nền tảng. Danh mục tenant được thu thập lúc triển khai giúp CLI hiểu các đối tượng và trường tùy chỉnh của từng instance mà không cần thay đổi nhà cung cấp.
• Lỗi có thể xử lý ngay: Mọi lỗi đều nêu rõ nguyên nhân, lệnh khắc phục, và trong nhiều trường hợp còn cung cấp đầu vào đã được sửa sẵn để gửi lại — giúp agent phục hồi chỉ trong một lượt.
• Thăm dò không cần thực thi: Các cờ như --schema, --examples, --shape trả về kết quả trước khi lệnh chạy, không cần thông tin xác thực và không tính vào hạn mức API.
• Runtime nhúng được: Cùng một lớp lệnh có thể chạy trong tiến trình của ứng dụng chủ, nơi cung cấp thông tin xác thực, danh tính và chính sách theo từng yêu cầu.
• An toàn được khai báo: Mức độ biến đổi, phạm vi ảnh hưởng, khả năng đảo ngược và tính idempotent đều được công bố trên mỗi lệnh. Mọi thao tác ghi đều hỗ trợ --dry-run và ghi lại dấu vết kiểm toán.

Quy trình làm việc ưu tiên thăm dò

Aclif được thiết kế theo triết lý "thăm dò trước, thực thi sau". Agent có thể khám phá toàn bộ hệ thống mà không cần tài liệu bên ngoài:

aclif discover --json                    # liệt kê mọi nhà cung cấp và tình trạng xác thực
aclif learn salesforce --json            # tóm tắt chủ đề, trường chính, cú pháp truy vấn
aclif salesforce data query --schema     # xem cờ, tham số, siêu dữ liệu an toàn
aclif salesforce data query --query "SELECT Id, Name FROM Account LIMIT 5" --dry-run

Mã thoát (exit code) được chuẩn hóa: 0 thành công, 1 lỗi API, 2 lỗi sử dụng, 3 lỗi xác thực.

Ba cách triển khai linh hoạt

Một điểm mạnh của Aclif là cùng một lớp lệnh có thể chạy ở ba ngữ cảnh khác nhau, tùy vào ai chịu trách nhiệm cung cấp thông tin xác thực và thực thi chính sách:

• Agent tự chạy: Tiến trình agent khởi tạo binary, thực thi lệnh và đọc JSON trả về. Phù hợp khi một agent, một người vận hành và một bộ thông tin xác thực chia sẻ cùng ranh giới tin cậy.
• Ứng dụng chủ chạy: Ứng dụng nằm giữa mô hình và Aclif, giữ thông tin xác thực. Mô hình không bao giờ chạm tới credential và định nghĩa công cụ không lọt vào ngữ cảnh của nó.
• Gateway chạy: Một tiến trình tồn tại lâu dài phục vụ nhiều agent, giải quyết thông tin xác thực từ vault doanh nghiệp theo từng yêu cầu, kiểm tra chính sách dựa trên người dùng thực tế và ghi lại mọi cuộc gọi.

Kiến trúc gateway đặc biệt hữu ích cho các tổ chức lớn, nơi mọi cuộc gọi cần được quy trách nhiệm cho một cá nhân cụ thể, ngay cả khi đi qua tài khoản dịch vụ dùng chung.

Nhà cung cấp và giấy phép

Aclif hỗ trợ sẵn Salesforce, ServiceNow, DocuSign và Agentforce trong mọi bản phát hành. Google Workspace (Gmail, Calendar) do cộng đồng đóng góp. Việc viết thêm nhà cung cấp mới khá đơn giản — chỉ là dịch trực tiếp đặc tả API của nền tảng sang bề mặt lệnh, và thậm chí một coding agent có thể làm việc này từ prompt mẫu trong kho mã nguồn.

Dự án được phát hành theo giấy phép MIT, yêu cầu Node 22 trở lên, và có thể cài đặt nhanh qua npm:

npm install -g @aclif/core

Ý nghĩa với cộng đồng lập trình viên Việt Nam

Với các đội ngũ phát triển phần mềm tại Việt Nam đang ngày càng tích hợp AI agent vào quy trình doanh nghiệp — từ chăm sóc khách hàng, tự động hóa quy trình nghiệp vụ đến phân tích dữ liệu — những công cụ như Aclif có thể giúp giảm đáng kể công sức tích hợp. Thay vì viết riêng từng connector cho mỗi nền tảng SaaS, các kỹ sư có thể dựa vào một giao diện thống nhất, tiết kiệm thời gian và giảm chi phí token khi vận hành agent ở quy mô lớn.

Dự án hiện đã có mặt trên GitHub và đang trong giai đoạn phát triển tích cực, với tài liệu hướng dẫn dành cho cả người lẫn coding agent cùng tham gia đóng góp.