Bắt đầu với Ars Umbris: Cài đặt và khám phá IDE có kiểu dữ liệu, dành riêng cho tác tử

Ars Umbris là gì?

Ars Umbris là một IDE linh hoạt, ưu tiên tác nhân, dành cho tri thức có kiểu. Nó kết hợp tri thức, kiểu, kỹ năng, công cụ và các thành phần UI trong những kho lưu trữ có thể kết hợp, đồng thời có thể phụ thuộc lẫn nhau.

Dự án đọc các kho lưu trữ này như một đồ thị có kiểu duy nhất. Nó kiểm tra các trường và tham chiếu, sau đó cung cấp các chẩn đoán mà tác nhân có thể xử lý. Con người và tác nhân có thể sử dụng cùng các nguyên tố và SDK để xây dựng công cụ, thêm chế độ xem và chỉnh sửa ứng dụng.

Ars Umbris hiện đang ở giai đoạn alpha ban đầu, vì vậy hãy chuẩn bị cho lỗi và các thay đổi phá vỡ tương thích. Hiện tại, dự án chỉ hỗ trợ macOS.

Kiến trúc kết hợp như thế nào

Ars Umbris được tổ chức thành ba lớp chính. Hiểu rõ các lớp này giúp bạn xác định nơi cần tìm khi cấu hình hoặc mở rộng hệ thống.

1. au-engine

au-engine là công cụ đồ thị xuyên kho lưu trữ, được xây dựng trên một lớp nền tệp có kiểu. Nó lập chỉ mục các tệp trong nhiều kho lưu trữ và chuyển chúng thành một đồ thị trực tiếp, có kiểu và có thể truy vấn.

Công cụ này cũng triển khai một ngôn ngữ kiểu tùy chỉnh cho các tệp Markdown và YAML. Để biết thêm chi tiết, hãy đọc au-engine.md.

2. au-host

au-host là ứng dụng máy chủ Electron. Nó gắn các phép chiếu có kiểu, hay các chế độ xem, lên đồ thị và hỗ trợ những cấu hình kết hợp dựa trên dữ liệu có kiểu.

Các cấu hình kết hợp này có thể chỉnh sửa và được điều khiển bởi cả con người lẫn tác nhân. Xem au-host.md để đọc tài liệu về máy chủ.

3. au-mcp

au-mcp cung cấp lớp tác nhân có thể mở rộng. Nó cung cấp các công cụ và kỹ năng có kiểu thông qua MCP, đồng thời giao tiếp với bộ khung tác nhân bạn chọn thông qua các bộ chuyển đổi.

Đọc au-mcp.md để tìm hiểu thêm về lớp MCP.

Chuẩn bị cài đặt

Quá trình cài đặt sử dụng hai thư mục:

• ~/arsumbris/ chứa nhiều kho lưu trữ Ars Umbris.
• ~/.arsumbris/ chứa các tệp cấu hình Ars Umbris.

Vì dự án chỉ dành cho macOS và vẫn đang được phát triển tích cực, hãy xem các yêu cầu trước khi thay đổi hệ thống. Hướng dẫn cài đặt hiện tại của kho lưu trữ là nguồn chính thức về phần mềm bắt buộc và thứ tự thiết lập.

Cài đặt kho lưu trữ điểm khởi đầu

README khuyến nghị yêu cầu tác nhân thực hiện cài đặt bằng các hướng dẫn sau:

Hãy giúp tôi cài đặt Ars Umbris.

1) Tạo hai thư mục nếu chúng chưa tồn tại:
   - ~/arsumbris/ sẽ chứa nhiều kho lưu trữ.
   - ~/.arsumbris/ sẽ chứa các cấu hình.

2) Sao chép kho lưu trữ điểm khởi đầu:
   git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
   Nếu đích đó đã tồn tại, hãy kiểm tra trước khi tiếp tục; không ghi đè lên nó.

3) Đọc ~/arsumbris/arsumbris/INSTALL.md và làm theo quy trình thiết lập hiện tại.
   Kiểm tra các yêu cầu và giải thích mọi thay đổi cần thiết trên máy của tôi trước khi thực hiện.

Bước an toàn quan trọng là kiểm tra thư mục ~/arsumbris/arsumbris hiện có trước khi sao chép. Không ghi đè lên bản sao mã nguồn hiện có. Sau khi kho lưu trữ khả dụng, hãy mở INSTALL.md và làm theo các hướng dẫn hiện tại theo đúng thứ tự được nêu.

Làm theo quy trình thiết lập hiện tại của kho lưu trữ

1. Xác nhận rằng bạn đang sử dụng macOS.
2. Tạo ~/arsumbris/ và ~/.arsumbris/ nếu chúng chưa tồn tại.
3. Kiểm tra xem ~/arsumbris/arsumbris đã tồn tại hay chưa.
4. Nếu chưa tồn tại, sao chép kho lưu trữ bằng git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris.
5. Nếu đã tồn tại, hãy kiểm tra thay vì thay thế nó.
6. Đọc ~/arsumbris/arsumbris/INSTALL.md.
7. Kiểm tra và cài đặt các yêu cầu được chỉ định trong tệp đó, xem xét các thay đổi được đề xuất trên máy trước khi áp dụng.
8. Hoàn tất các bước thiết lập còn lại theo thứ tự được ghi trong INSTALL.md.

Vì Ars Umbris đang được phát triển tích cực, hãy tránh dựa vào các hướng dẫn thiết lập lỗi thời từ các nguồn bên thứ ba. Hãy sử dụng hướng dẫn cài đặt trong kho lưu trữ đã sao chép cho phiên bản bạn đang cài đặt.

Khái niệm sử dụng cơ bản

Ars Umbris được thiết kế xoay quanh các kho lưu trữ chứa tri thức và khả năng có kiểu. Một kho lưu trữ có thể chứa tri thức, định nghĩa kiểu, kỹ năng, công cụ và các thành phần UI. Các kho lưu trữ cũng có thể phụ thuộc vào những kho lưu trữ khác, cho phép tái sử dụng khả năng và tri thức giữa các dự án.

Ở cấp độ khái quát, một quy trình điển hình như sau:

1. Đặt hoặc sao chép các kho lưu trữ liên quan vào ~/arsumbris/.
2. Để au-engine lập chỉ mục lớp nền tệp trong các kho lưu trữ đó.
3. Sử dụng đồ thị có kiểu thu được để làm việc với dữ liệu, trường và tham chiếu được kết nối.
4. Sử dụng au-host để gắn các phép chiếu và chế độ xem lên đồ thị.
5. Kết nối bộ khung tác nhân thông qua au-mcp và các bộ chuyển đổi MCP.
6. Sử dụng tác nhân hoặc người dùng để kiểm tra chẩn đoán, xây dựng công cụ, thêm chế độ xem và chỉnh sửa ứng dụng.

README không quy định một dự án mẫu hoặc quy trình dòng lệnh duy nhất. Các lệnh chính xác và những phép chiếu khả dụng phụ thuộc vào thiết lập được mô tả trong INSTALL.md và các kho lưu trữ bạn kết nối.

Làm việc với tác nhân thông qua MCP

Ars Umbris được xây dựng để kết nối với bộ khung tác nhân thông qua Model Context Protocol. Lớp au-mcp cung cấp các công cụ và kỹ năng có kiểu, còn các bộ chuyển đổi kết nối những khả năng đó với bộ khung bạn chọn.

Điều này cho phép tác nhân làm việc với cùng các nguyên tố nền tảng và SDK được sử dụng để xây dựng ứng dụng. Trên thực tế, tác nhân có thể tham gia xây dựng công cụ, thêm chế độ xem và chỉnh sửa ứng dụng, tùy thuộc vào các khả năng và cấu hình có trong bản cài đặt của bạn.

Mẹo nâng cao và các cân nhắc về an toàn

Giữ các repository có tính kết hợp

Tổ chức kiến thức và khả năng thành các repository có thể tái sử dụng và kết nối với nhau. Các phụ thuộc xuyên repository là một phần cốt lõi của mô hình dự án, vì vậy hãy xem các repository là những phần của một đồ thị có kiểu duy nhất thay vì các thư mục biệt lập.

Sử dụng chẩn đoán làm phản hồi

Công cụ kiểm tra các trường và tham chiếu trên toàn bộ đồ thị có kiểu. Hãy xem các chẩn đoán của công cụ như phản hồi khi chỉnh sửa Markdown có kiểu, YAML hoặc nội dung repository liên quan, đặc biệt khi một agent đang thực hiện thay đổi.

Đọc tài liệu của từng lớp

Khi cần tìm hiểu hành vi, hãy tham khảo tài liệu của lớp liên quan: engine, host hoặc lớp agent MCP.

Xem xét các thay đổi trước khi áp dụng

Lời nhắc cài đặt đặc biệt khuyến nghị giải thích các thay đổi cần thiết đối với máy trước khi thực hiện. Hãy áp dụng cách tiếp cận thận trọng tương tự khi cho phép các agent sửa đổi repository hoặc cấu hình.

Tính đến mô hình bảo mật hiện tại

Ars Umbris chạy mã trên máy của bạn và hiện tại không có cơ chế sandbox. Hãy xem SAFETY.md trước khi sử dụng dự án, đặc biệt khi kết nối các agent hoặc làm việc với những repository mà bạn không hoàn toàn kiểm soát.

Kết luận

Ars Umbris kết hợp một đồ thị có kiểu xuyên repository, một host dựa trên Electron và một lớp agent MCP thành một IDE thử nghiệm dành cho kiến thức có kiểu. Để bắt đầu, hãy chuẩn bị hai thư mục cấu hình, clone repository điểm vào mà không ghi đè các tệp hiện có, rồi làm theo INSTALL.md hiện tại của repository đó. Sau khi cài đặt, hãy khám phá cách repository, projection, công cụ, skill và agent phối hợp với nhau, đồng thời lưu ý trạng thái alpha và mô hình thực thi không có sandbox của dự án.