Sandbox
Kết nối một môi trường thực thi biệt lập cho mã, tệp và lệnh shell – chỉ được cung cấp khi tác nhân cần đến.
Cách tiếp cận của TrueForge
Có hai mô hình phổ biến để kết hợp các tác nhân với môi trường thử nghiệm:
| Mẫu | Nơi mà người đại lý hoạt động | Sự đánh đổi |
|---|---|---|
| Đặc vụ trong môi trường thử nghiệm | Bên trong hình ảnh hộp cát | Môi trường sandbox được thiết lập ngay cả đối với những yêu cầu đơn giản nhất; các thông tin bí mật phải được lưu trữ trong môi trường sandbox; việc cập nhật đồng nghĩa với việc phải xây dựng lại ảnh hệ thống. |
| Sandbox như một công cụ | Bên ngoài, trên máy chủ | Môi trường thử nghiệm (sandbox) được cấp phát theo yêu cầu khi cần thiết; thông tin bí mật được lưu giữ trong hệ thống; môi trường thử nghiệm chỉ dành cho việc thực thi/tập tin. |
TrueForge sử dụng sandbox như một công cụ: vòng lặp tác nhân và thông tin xác thực vẫn nằm trong hệ thống điều khiển; sandbox chỉ thực thi mã, tệp và các thao tác shell. Điều đó có nghĩa là:
- Thông tin xác thực Model và MCP không bao giờ được đưa vào môi trường thử nghiệm.
- Trạng thái hội thoại vẫn được duy trì sau khi môi trường thử nghiệm gặp sự cố.
- Môi trường thử nghiệm chỉ được tạo ra khi nhân viên thực sự cần đến nó – các cuộc gọi hỏi đáp đơn giản và các cuộc gọi MCP không phát sinh chi phí môi trường thử nghiệm.
Cấu hình nhà cung cấp
Hiện tại, Daytona là nhà cung cấp môi trường thử nghiệm duy nhất được hỗ trợ. Chúng tôi dự định sẽ hỗ trợ thêm các nhà cung cấp khác. Mở Cài đặt → Nhà cung cấp Sandbox, chọn cài đặt sẵn Daytona từ danh mục và dán khóa API của bạn.
Các thiết lập mặc định của nhà cung cấp được lấy từ danh mục hộp cát được cung cấp sẵn – xem Thiết lập ban đầu để biết cách thức hoạt động của danh mục và cách thay đổi các tùy chọn mà giao diện người dùng cung cấp.
Môi trường
Môi trường hộp cát là một bản thiết kế có thể tái sử dụng cho các hộp cát mà tác nhân của bạn tạo ra. Nó ghi lại hình ảnh cơ bản và một tập lệnh xây dựng tùy chọn, CPU, bộ nhớ và ổ đĩa cần phân bổ, các biến môi trường, các quy tắc mạng đi ra và các thông tin bí mật. Khi một tác nhân thiết lập một hộp cát, TrueForge sẽ sao chép môi trường mà tác nhân đó trỏ đến. Mở mục Envs ở thanh bên để xem các môi trường hiện có và tạo môi trường mới. Mỗi hàng hiển thị trạng thái xây dựng, tài nguyên, mạng và thời điểm cập nhật lần cuối.
Tạo ra một môi trường
Nhấp vào Tạo Môi trường Mới, đặt tên cho môi trường đó để các tác nhân của bạn có thể tham chiếu, sau đó thiết lập những gì bạn cần:
| Cánh đồng | Nó cấu hình những gì | Khi nào nó áp dụng |
|---|---|---|
| Tập lệnh xây dựng | Ví dụ: một shell chỉ chạy một lần trong khi TrueForge tạo ảnh chụp nhanh.pip install httpx |
Trên môi trường thử nghiệm mới tiếp theo , khi môi trường đã sẵn sàng. |
| CPU / Bộ nhớ / Ổ đĩa | Các tài nguyên được tích hợp sẵn trong ảnh chụp nhanh (mặc định: 1 CPU, 1 GB, 3 GB) | Tương tự như tập lệnh xây dựng |
| Biến môi trường | Các cặp trơn KEY=valuecó sẵn cho quy trình thử nghiệm. |
Khi một môi trường thử nghiệm được tạo |
| Chặn tất cả mạng | Chặn tất cả lưu lượng truy cập đi ra. Danh sách cho phép tên miền và thông tin bí mật sẽ bị bỏ qua khi chức năng này được bật. | Khi một môi trường thử nghiệm được tạo |
| Danh sách tên miền được phép | Ví dụ: Các máy chủ được phân tách bằng dấu phẩy mà hộp cát có thể truy cập.api.github.com,api.openai.com |
Khi một môi trường thử nghiệm được tạo |
| Bí mật | Thông tin xác thực phạm vi mạng được chèn dưới dạng biến môi trường, xem mục Bí mật. | Các chỉnh sửa về giá trị và máy chủ sẽ được cập nhật ngay lập tức vào các môi trường thử nghiệm hiện có ; một bí mật mới được thêm vào sẽ được áp dụng trong lần tạo tiếp theo. |
Trạng thái xây dựng và xây dựng lại
Môi trường mới hoặc đã chỉnh sửa sẽ hiển thị trạng thái Đang xây dựng trong khi TrueForge tạo ảnh chụp nhanh, sau đó là Sẵn sàng. Chỉ những môi trường ở trạng thái Sẵn sàng mới có thể được chọn trên một tác nhân.
- Việc thay đổi tập lệnh xây dựng hoặc CPU/bộ nhớ/ổ đĩa sẽ tạo ra một ảnh chụp nhanh mới. Môi trường sẽ quay lại quá trình xây dựng, và các sandbox hiện có sẽ giữ nguyên ảnh chụp nhanh cũ cho đến khi chúng được thay thế.
- Việc thay đổi các biến môi trường, mạng hoặc thông tin bí mật sẽ sử dụng lại ảnh chụp nhanh hiện tại, do đó không cần phải xây dựng lại.
Môi trường tùy chỉnh thuộc sở hữu của người dùng đã tạo ra chúng. Bạn không thể xóa một môi trường khi tác nhân đã lưu vẫn còn tham chiếu đến nó.
Chính sách mạng
Môi trường thử nghiệm (sandbox) chạy mã do tác nhân viết, vì vậy bạn có thể muốn giới hạn phạm vi truy cập của nó trên mạng. Theo mặc định, quyền truy cập ra ngoài không bị hạn chế. Mỗi môi trường có hai tùy chọn trong phần Mạng để thắt chặt điều đó:
- Danh sách tên miền cho phép: một danh sách các máy chủ được phân tách bằng dấu phẩy mà môi trường thử nghiệm có thể truy cập, ví dụ:
api.github.com,api.openai.com. Các yêu cầu đến bất kỳ máy chủ nào không có trong danh sách đều bị chặn. Sử dụng danh sách này để giới hạn phạm vi hoạt động của môi trường thử nghiệm chỉ cho phép truy cập vào các dịch vụ mà tác vụ thực sự cần. - Chặn tất cả mạng: không cho phép truy cập ra ngoài. Danh sách cho phép truy cập tên miền và thông tin bí mật sẽ bị bỏ qua khi chức năng này được bật. Sử dụng chức năng này cho các môi trường chỉ chạy mã cục bộ và các thao tác tệp.
Các bí mật có phạm vi mạng: mỗi bí mật chỉ định các máy chủ mà giá trị của nó có thể được gửi đến, vì vậy thông tin xác thực chỉ được chuyển tiếp đến các đích mà bạn chấp thuận, ngay cả khi môi trường thử nghiệm có thể truy cập được chúng. Vì lý do này, không thể thêm bí mật khi tùy chọn “Chặn tất cả mạng” đang bật.Các thay đổi về mạng sẽ có hiệu lực khi một môi trường thử nghiệm (sandbox) được tạo, vì vậy phiên làm việc hiện tại sẽ giữ nguyên chính sách hiện hành cho đến khi môi trường thử nghiệm của nó được thay thế. Xem Cách các thay đổi tác động đến phiên đang chạy.
Bí mật
Các bí mật chứa thông tin xác thực mà hộp cát cần cho các cuộc gọi đi ra ngoài của chính nó, chẳng hạn như mã thông báo API hoặc thông tin xác thực Git. Chúng không phải là thông tin xác thực mô hình hoặc MCP, những thông tin này vẫn nằm trong hệ thống bảo mật (xem Bảo mật thông tin xác thực ).Thêm các thông tin bí mật cho từng môi trường trong mục Secrets. Mỗi thông tin bí mật bao gồm:
- Tên biến môi trường: biến môi trường mà tiến trình hộp cát nhìn thấy, ví dụ:
GITHUB_TOKEN. - Giá trị: chính là thông tin xác thực. TrueForge không lưu trữ giá trị này dưới dạng văn bản thuần, và các thao tác đọc API và giao diện người dùng sẽ trả về một giá trị thay thế đã được che giấu. Hãy giữ nguyên giá trị thay thế để giữ lại giá trị đã lưu trữ, hoặc nhập một giá trị mới để thay đổi nó.
- Máy chủ: các đích đến mà giá trị có thể được gửi tới. Quá trình hộp cát nhìn thấy biến này, nhưng nhà cung cấp chỉ chuyển tiếp giá trị đến các máy chủ này.
Bạn không thể thêm bí mật khi tính năng Chặn tất cả mạng đang được bật.
Cách các thay đổi được đưa vào phiên chạy thử
Các thiết lập của môi trường được đọc khi tạo sandbox, vì vậy việc thay đổi chúng thường chỉ ảnh hưởng đến các phiên mới. Ngoại lệ là các thông tin bí mật: việc lưu môi trường sẽ đồng bộ hóa chúng với nhà cung cấp ngay lập tức, ngay cả khi quá trình xây dựng lại ảnh chụp nhanh vẫn đang diễn ra. Bảng này bao gồm mọi trường thông tin.
| Bạn thay đổi | Một phiên làm việc mà môi trường thử nghiệm (sandbox) đã tồn tại. | Một phiên họp mới |
|---|---|---|
| Xoay giá trị hoặc chỉnh sửa máy chủ của một bí mật mà môi trường thử nghiệm đã có. | Có hiệu lực ngay lập tức ; yêu cầu tiếp theo sẽ sử dụng giá trị hoặc máy chủ mới, không cần tạo cuộc trò chuyện mới. | Sử dụng bí mật đã được cập nhật |
| Thêm một bí mật (tên môi trường mới) | Không được tiêm vào, vì các bí mật chỉ được gắn kết khi môi trường thử nghiệm được tạo. | Đòn khóa bí mật mới |
| Xóa một bí mật | Việc tiêm thuốc dừng lại ngay lập tức. | Không bao giờ nhận được nó. |
| Các biến môi trường , danh sách miền được cho phép hoặc chặn tất cả mạng. | Không thay đổi cho đến khi môi trường thử nghiệm được thay thế. | Sử dụng môi trường đã lưu. |
| Tập lệnh biên dịch hoặc CPU / bộ nhớ / ổ đĩa | Tiếp tục chạy trên bản dựng hiện có cho đến khi môi trường thử nghiệm được thay thế. | Chờ cho đến khi môi trường sẵn sàng , sau đó sử dụng bản dựng mới. |
Kích hoạt chế độ hộp cát trên tác nhân
Chế độ sandbox mặc định bị tắt cho mỗi agent. Hãy bật nó trong trình tạo agent khi bạn cần thực thi mã, kỹ năng hoặc Chế độ mã. Bạn cũng có thể thiết lập config.sandbox.enabledtrong thông số kỹ thuật của agent khi tạo agent thông qua SDK. Các tùy chọn điều khiển:
- Tải xuống tập tin: cho phép người dùng tải xuống các tập tin do tác nhân tạo ra (mặc định bật trong giao diện trò chuyện).
- Môi trường: môi trường mà hộp cát được sao chép từ đó. Hãy để mặc định hoặc chọn một môi trường bạn đã tạo (chỉ các môi trường Sẵn sàng mới hiển thị).
Trong trình tạo tác nhân, cả hai tùy chọn đều nằm trong Cấu hình thời gian chạy dưới mục Sandbox, nơi menu thả xuống Môi trường cũng có liên kết Quản lý môi trường đến trang Envs. Đối với cuộc trò chuyện một lần, hãy chọn một môi trường từ menu Công cụ của trình soạn thảo dưới tab Môi trường. Thông qua SDK, hãy đặt config.sandbox.environment_nametrên thông số kỹ thuật của tác nhân; bỏ qua nó để sử dụng default:
“config”: { “sandbox”: { “enabled”: true, “environment_name”: “data-tools” } }
Vòng đời
- Được cung cấp theo yêu cầu khi tác nhân cần mã, tập tin, kỹ năng hoặc Chế độ Mã.
- Được sử dụng lại trong nhiều lượt chơi trong cùng một phiên (tệp tin được lưu giữ).
- Sau một thời gian không hoạt động, chương trình đã dừng lại, sau đó được lưu trữ và cuối cùng bị xóa theo cài đặt của nhà cung cấp.
- Việc chỉnh sửa môi trường của tác nhân không làm thay đổi môi trường thử nghiệm đã tồn tại, ngoại trừ một trường hợp: các bí mật được đồng bộ hóa ngay lập tức. Xem Cách các thay đổi được cập nhật vào phiên đang chạy.
An toàn chứng chỉ
- Chứng chỉ Model và MCP vẫn được giữ nguyên trong bộ dây đeo.
- Các lệnh gọi MCP từ các tập lệnh Chế độ Mã được chuyển tiếp trở lại hệ thống điều khiển – môi trường thử nghiệm không bao giờ lưu giữ các mã thông báo đó.
- Các bí mật môi trường được quản lý bởi nhà cung cấp và có phạm vi mạng. Việc thay đổi giá trị sẽ ngay lập tức cập nhật các hộp cát phiên hiện có; việc thêm bí mật thì không, vì vậy hãy bắt đầu một phiên mới cho nó.
