guilds.run: đội AI agent mã nguồn mở có thể kiểm tra

guilds.run của Cigale AI vận hành các đội AI agent hoạt động lâu dài. Mỗi thành viên có nhiệm vụ, mô hình và công cụ riêng; đội dùng chung trò chuyện, ghi chú và bảng dữ liệu.

Nói đơn giản, guilds.run dùng để làm gì?

Hãy hình dung bàn làm việc của một đội AI: một agent tìm thông tin, một agent soạn bản nháp, còn bạn xem cách họ làm việc. Guild là đội, Task là chỉ dẫn thường trực, run là một lần thực thi được lưu lại. Bạn đọc được lời nhắc thực tế, lời gọi công cụ, kết quả và thay đổi bộ nhớ.

Nó phù hợp với lập trình viên và người vận hành quy trình lặp lại cần tìm nguyên nhân lỗi. Nếu chỉ hỏi thỉnh thoảng, hãy tính cả công cài đặt và cấu hình mô hình.

Phân vai và giữ thông tin dùng chung

Ghi chú chứa quy tắc và phát hiện; bảng giữ bản ghi có cấu trúc; script lưu thao tác có thể tái sử dụng. Bộ nhớ riêng mang ngữ cảnh sang lần chạy sau. Bắt đầu bằng đầu vào, kết quả mong đợi và hành động được phép của một nhiệm vụ nhỏ.

Connector có thể là bộ nối gốc hoặc endpoint MCP. Gmail, Drive và GitHub còn cần cấu hình ứng dụng, thông tin xác thực trên instance. Giới hạn công cụ theo tổ chức, guild hoặc agent; biểu tượng trên trang không có nghĩa tài khoản đã kết nối.

Cài đặt và xác minh lần chạy đầu tiên

Chuẩn bị Docker với Compose, git và bash. Làm theo hướng dẫn cài đặt:

git clone https://github.com/CigaleAI/guilds.git
cd guilds
./setup.sh
docker compose up --detach --wait

Lần dựng image đầu có thể mất vài phút. Giữ file .env được tạo vì nó chứa khóa giải mã thông tin xác thực đã lưu. Mở http://127.0.0.1:8080/.

Kết nối nhà cung cấp, chọn các mô hình được dùng và mô hình mặc định. Tạo guild, thêm agent, lưu Task trong Prompt. Gửi việc nhỏ tại Group chat: @tên ở đầu chỉ đánh thức thành viên đó, không gắn tên sẽ đánh thức cả đội. Xem Inspect run, hỏi tiếp về thông tin trước đó và kiểm tra phiên bản bộ nhớ trong State. Truy cập từ xa cần cấu hình riêng.

Xem bằng chứng và duyệt đề xuất của Studio

Inspect run giúp kiểm tra Task, đầu vào và kết quả công cụ. Khi sai lầm lặp lại, đối chiếu bộ nhớ.

Prompt Studio phân tích đội đang có và soạn sửa đổi Task. Bạn xem khác biệt rồi xuất bản hoặc bỏ. Coach không tự xuất bản; lần chạy mới nhận thay đổi, lịch sử cũ giữ nguyên. Khả năng kiểm tra hỗ trợ tìm lỗi nhưng không bảo đảm câu trả lời đúng.

Lịch chạy và Recipes để tái sử dụng

Routine có thể tạm dừng. Cron dùng UTC và khoảng cách ít nhất năm phút. Dừng lịch thử nghiệm khi xong để tránh tiêu thụ liên tục.

Recipes xuất cấu hình ra JSON. Save as recipe, duyệt và xuất; sau khi nhập, kiểm tra kế hoạch tạo, hoàn thành đăng nhập và thiết lập bên ngoài rồi kích hoạt routine. Khóa, lịch sử chat, bộ nhớ, bản ghi bảng và hồ sơ trình duyệt không được chuyển. Danh mục recipe công khai vẫn được ghi là sắp ra mắt.

Mô hình, phần miễn phí và dữ liệu

Kiểm tra ngày 14 tháng 10 năm 2026: lõi tự host là phần mềm tự do theo AGPL-3.0-only. Bản được công ty host là triển khai riêng, độc quyền; chưa xác minh gói hiện có hoặc hạn mức. Máy chủ, công cụ ngoài và mô hình có thể tính phí riêng.

Lõi hỗ trợ OpenAI, OpenRouter, xAI, DeepInfra và endpoint cục bộ tương thích như Ollama, LM Studio, vLLM. Claude và Gemini có thể qua OpenRouter; Kimi Code chỉ dành cho agent lập trình. Tài liệu mô hình nêu chủ khóa API trả phí cho nhà cung cấp và Guilds không đặt trần chi tiêu.

Tự host không giữ yêu cầu đến mô hình đám mây ở máy bạn. Trong Docker, 127.0.0.1 là container nên mô hình trên host cần địa chỉ truy cập được. Cấp bí mật hẹp: agent cùng máy chia sẻ ranh giới tin cậy, cần tách máy nếu cần cách ly. Liên kết quyền riêng tư và điều khoản trả 404, nên chưa xác minh đầy đủ lưu giữ và dùng dữ liệu huấn luyện.

Câu hỏi thường gặp

Tự host miễn phí có nghĩa không phát sinh chi phí?

Phần mềm miễn phí; mô hình, hạ tầng và dịch vụ có thể tính riêng. Đặt ngân sách tại nhà cung cấp.

Có thể dùng mô hình cục bộ cho dữ liệu nhạy cảm không?

Có, qua endpoint tương thích. Cần kiểm tra cả công cụ ngoài; điều khoản riêng tư đầy đủ chưa truy cập được.

Có thể kiểm tra agent thực sự đã làm gì không?

Có. Inspect run hiển thị lời nhắc, lời gọi công cụ và kết quả thực tế. Phiên bản bộ nhớ giúp theo dõi ngữ cảnh, nhưng không bảo đảm câu trả lời đúng.

Tài nguyên chính thức

• Tài liệu: cài đặt và vận hành.
• Mã nguồn và báo lỗi: triển khai và giấy phép.
• Tài khoản X chính thức: thông báo.
• Cộng đồng Discord được liên kết: có thể yêu cầu tư cách thành viên.