Gói
Xuất, chia sẻ và cài đặt các tác nhân dưới dạng tệp lưu trữ di động.
Chức năng
Một tác nhân, cây thư mục, cấu hình, tri thức và quy trình làm việc của nó được tuần tự hóa thành một tệp lưu trữ ZIP .agentpkg duy nhất kèm theo tệp khai báo (manifest), danh sách người đóng góp và hồ sơ nguồn gốc. Việc cài đặt tuân theo quy trình ba bước: Lập kế hoạch (kiểm tra không ghi), Xem xét (xác minh bản tóm tắt), Áp dụng (ghi kèm kiểm tra an toàn TOCTOU). Ba chế độ phân phối được hỗ trợ: xuất trực tiếp ra tệp, liên kết bàn giao riêng tư với mã thông báo chia sẻ có thời hạn, và thư viện trình bày được tuyển chọn với các lượt chạy mẫu thử nghiệm thực tế đã được xác minh.
Tại sao nó quan trọng
Một tác nhân mà bạn không thể di chuyển là một tác nhân bạn không sở hữu. Các tệp lưu trữ di động giúp tác nhân có thể di chuyển giữa các tài khoản, công cụ và mô hình mà không bỏ lại tri thức của nó, và bước lập kế hoạch trước khi áp dụng giúp việc cài đặt là một quyết định chủ động, không phải là một tác dụng phụ.
Cách thức hoạt động
Không rò rỉ ID qua ranh giới gói
Các UUID nội bộ được tạo lại bằng uuidv5 trong quá trình tuần tự hóa, vì vậy gói không mang theo bất kỳ định danh tài khoản, khách thuê (tenant) hoặc thư mục nào từ nguồn.
Cài đặt ba bước với tính năng an toàn TOCTOU
Lập kế hoạch kiểm tra không ghi, Xem xét xác minh bản tóm tắt, Áp dụng kiểm tra lại bản tóm tắt trước khi ghi. Gói bị thay đổi giữa bước xem xét và áp dụng sẽ bị từ chối.
Thư viện trình bày chứa các lượt chạy mẫu đã xác minh
Một quy trình làm việc trong thư viện trình bày bao gồm một lượt chạy thực tế đã ẩn thông tin nhạy cảm để người dùng có thể xem cách nó hoạt động trước khi cài đặt, và tính xác thực sẽ được kiểm tra khi hiển thị.
Câu hỏi
- Có gì trong một gói?
- Cây thư mục, mọi tài liệu lá, các tệp cấu hình .context và .agent, quy trình làm việc, và tệp khai báo (manifest) chứa siêu dữ liệu về người đóng góp và nguồn gốc. Không chứa thông tin đăng nhập, không chứa embedding, không chứa trạng thái xác minh.
- Tôi có thể chia sẻ gói với người dùng ở tài khoản khác không?
- Có. Liên kết bàn giao riêng tư mang theo mã thông báo chia sẻ có thời hạn. Người nhận sẽ cài đặt gói vào tài khoản của họ thông qua cùng quy trình lập kế hoạch-xem xét-áp dụng.
The rest of the bag
Quyền trên từng tài liệu giúp lọc câu trả lời, không chỉ lọc các trang.
Việc phân giải chính sách được lưu vào bộ nhớ đệm cho mỗi phiên để tăng tốc độ; thay đổi quyền sẽ lan truyền khi bộ nhớ đệm bị vô hiệu hóa thay vì ngay lập tức trên mọi yêu cầu đang xử lý.
Mỗi thư mục và mỗi tài liệu lá đều mang một chính sách truy cập: công khai, đã đăng nhập, hoặc được chủ sở hữu phê duyệt. Các chính sách này phân giải thành một lớp bọc cho mỗi phiên giúp lọc những gì tác nhân có thể truy xuất trước khi trả lời. Một sổ đăng ký chức năng sẽ chặn toàn bộ tính năng theo từng tenant, và các kiểm tra truy cập quan trọng sẽ mặc định đóng khi gặp lỗi.
Tài liệu
Một cây thư mục mà tác nhân đọc, và một tệp cấu hình mà nó tuân theo.
Việc trích xuất hỗ trợ các tệp PDF, bảng tính và bản ghi lời thoại. Các định dạng nhị phân lạ sẽ không được phân tích cú pháp.
Sự kiện
Một nhật ký bền vững ghi lại những gì các tác nhân đã làm, và lý do tại sao.
Bus sự kiện trong tiến trình (in-process event bus) là một bộ phát đơn nút, không phải là một trình môi giới phân tán. Bản ghi liên tác nhân bền vững là một nhật ký tác vụ Postgres riêng biệt.
That was step 6 of 6: a reply leaves, and the trail stays. Đó là toàn bộ lộ trình, từ khi đến cho đến một bản ghi có thể phát lại.