Knowledge Base – TrueLabAI

Thiết lập đăng nhập

TrueLabAI — Wed, 14 Oct 2026 09:07:53 +0000

Đăng nhập vào TrueForge là tùy chọn. Bạn có thể chạy nó mà không cần xác thực để sử dụng cá nhân, cục bộ, hoặc kết nối với nhà cung cấp danh tính OIDC (Okta, Microsoft Entra ID, hoặc bất kỳ nhà cung cấp danh tính OIDC tiêu chuẩn nào) để nhóm của bạn đăng nhập và cài đặt vẫn chỉ dành cho quản trị viên.

Chọn chế độ của bạn

Cách thức	Khi nào nên sử dụng	Những gì người dùng nhìn thấy
Không cần đăng nhập (mặc định)	Mạng cục bộ `npx`hoặc mạng mà bạn hoàn toàn tin tưởng.	Không có màn hình đăng nhập; mọi người đều là quản trị viên cục bộ dùng chung duy nhất.
Đăng nhập OIDC	Triển khai nhóm được lưu trữ hoặc chia sẻ	Đăng nhập bằng tài khoản IdP của bạn; mỗi người là một `admin`hoặc một`user`

Mặc định. Không cần thiết lập bất kỳ OIDC_*biến nào, chạy TrueForge như bình thường ( Khởi động nhanh ), và mở giao diện người dùng — không có màn hình đăng nhập, và Cài đặt cũng như trò chuyện sẽ có sẵn ngay lập tức.

1. Đăng ký ứng dụng với nhà cung cấp danh tính của bạn:

Tạo một ứng dụng OIDC (trên web) bảo mật . Bất kể nhà cung cấp nào, bạn cần:

Mã ủy quyền loại cấp phép (PKCE cũng được sử dụng)
URI chuyển hướng: https:///api/v1/auth/callback, trong đó là địa chỉ công khai của phiên bản TrueForge của bạn (cùng giá trị bạn đã đặt là PUBLIC_BASE_URL)
Người dùng hoặc nhóm được phép đăng nhập
Mã định danh (ID token) chứa thông tin về tư cách thành viên nhóm/vai trò, giúp TrueForge phân biệt quản trị viên với người dùng thông thường.

TrueForge sử dụng chuẩn OIDC, vì vậy bất kỳ nhà cung cấp danh tính nào phát hành mã thông báo định danh đều có thể sử dụng được. Chọn nhà cung cấp của bạn để biết các bước cụ thể:

2. Thiết lập môi trường máy chủ

Hãy thiết lập cả ba biến OIDC bắt buộc cùng lúc – cấu hình không đầy đủ sẽ khiến quá trình khởi động thất bại – cộng thêm nguồn gốc công cộng.

Biến	Yêu cầu	Mục đích
	Đúng	Người dùng nguồn gốc công cộng và IdP thấy (không có đường dẫn theo sau)
`OIDC_ISSUER_URL`	Đúng	Nhà phát hành IdP (khám phá tại `/.well-known/openid-configuration`)
`OIDC_CLIENT_ID`	Đúng	ID máy khách OIDC
`OIDC_CLIENT_SECRET`	Đúng	mã bí mật của máy khách OIDC
`OIDC_USER_REFERENCE_CLAIM`	Không (mặc định `sub`)	Thông tin xác nhận được sử dụng làm ID người dùng để xác định quyền sở hữu phiên.
`OIDC_USER_DISPLAY_NAME_CLAIM`	Không (mặc định `name`)	Yêu cầu được sử dụng làm tên hiển thị của người dùng
`OIDC_USER_ROLE_CLAIM`	Không (mặc định `groups`)	Yêu cầu tư cách thành viên quản trị đã được kiểm tra.
`OIDC_ADMIN_ROLE_VALUE`	Không (mặc định `admin`)	Chuỗi ký tự chính xác cấp quyền `admin`(phân biệt chữ hoa chữ thường)
`OIDC_SCOPES`	Không (mặc định `openid,profile,email`)	Phạm vi của yêu cầu ủy quyền
`OIDC_ALLOWED_EMAILS`	KHÔNG	Danh sách cho phép các email chính xác và/hoặc ``các mẫu ký tự đại diện (ví dụ: `alice@acme.com,@partner.com`) được phân tách bằng dấu phẩy. Khi được thiết lập, chỉ các mã định danh có `email`thông tin xác thực khớp với một mục nhập mới được phép đăng nhập. Để trống / không được thiết lập = không bị hạn chế. Việc so khớp không phân biệt chữ hoa chữ thường.

Cách bạn truyền các tham số này phụ thuộc vào cách bạn chạy TrueForge:

3. Đăng nhập và xác minh vai trò

Mở giao diện người dùng – bạn sẽ được chuyển hướng đến trang đăng nhập IdP của mình.
Sau khi đăng nhập, hãy xác nhận rằng quản trị viên mới thấy phần Cài đặt, còn người dùng không phải quản trị viên thì không.
Nếu ai đó mong đợi quyền quản trị nhưng lại nhận được quyền khác user, hãy giải mã mã định danh của họ và kiểm tra giá trị yêu cầu vai trò (phải khớp chính xác, phân biệt chữ hoa chữ thường). Hãy đăng xuất và đăng nhập lại sau bất kỳ thay đổi nào về yêu cầu của nhà cung cấp danh tính.

Vai trò: quản trị viên so với người dùng

Mỗi người dùng đã đăng nhập tương ứng với chính xác một vai trò, được xác định bởi thông tin vai trò trong mã định danh của họ.

Vai trò	Ai	Có thể trò chuyện và sử dụng trợ lý ảo.	Có thể thay đổi cài đặt
quản trị viên	Yêu cầu vai trò chứa`OIDC_ADMIN_ROLE_VALUE`	Đúng	Đúng vậy — mô hình, trình kết nối, kỹ năng, hộp cát
người dùng	Tất cả những người khác có thể đăng nhập	Đúng	Không — Cài đặt bị ẩn

Để gọi API HTTP hoặc SDK đối với máy chủ có bật tính năng đăng nhập, hãy truyền mã định danh – xem phần Lấy mã và kết nối.

Khắc phục sự cố

Triệu chứng	Nguyên nhân có thể xảy ra
`no_matching_policy`/ Đánh giá chính sách thất bại	Chính sách truy cập máy chủ ủy quyền không bao gồm máy khách, quyền cấp phép, phạm vi hoặc người dùng này (Okta).
`You are not allowed to access this app`	Người dùng chưa được chỉ định cho ứng dụng hoặc chính sách đăng nhập của ứng dụng từ chối cho phép họ đăng nhập.
`invalid client secret`	Ứng dụng này là ứng dụng SPA/công khai — hãy tạo lại nó thành một ứng dụng web (bí mật) với mã bí mật của khách hàng.
Màn hình xác thực trống khi yêu cầu`groups`	Máy chủ ủy quyền tùy chỉnh thiếu `groups`thông tin về phạm vi và/hoặc nhóm mã định danh (Okta)
Đăng nhập thành công nhưng mọi người đều…`role: "user"`	Thông tin nhóm/vai trò bị thiếu trong mã định danh, tên yêu cầu không chính xác hoặc giá trị quản trị không khớp (phân biệt chữ hoa chữ thường)
SDK trả về`401`	OIDC đang hoạt động và yêu cầu không có mã định danh hoặc cookie phiên.
Đăng nhập thất bại với lỗi `login_failed`/ API trả về `401`sau khi triển khai danh sách cho phép.	Yêu cầu của người gọi `email`nằm ngoài phạm vi cho phép `OIDC_ALLOWED_EMAILS`, hoặc mã định danh không có `email`yêu cầu nào trong khi danh sách cho phép được thiết lập. Các lỗi vẫn giữ nguyên tính chất chung chung để danh sách cho phép không được tiết lộ.

Danh sách kiểm tra an ninh

Lưu trữ OIDC_CLIENT_SECRETtrong trình quản lý bí mật; đừng bao giờ tiết lộ nó.
Không nên để lộ triển khai không có OIDC trên mạng internet công cộng.
Hãy ghi lại URL gọi lại chính xác mà người dùng của bạn truy cập (scheme + host).

So sánh hiệu suất

TrueLabAI — Wed, 14 Oct 2026 09:01:17 +0000

Chúng tôi đã so sánh hiệu năng của TrueForge với hai giải pháp thay thế khác – Claude Managed Agents (hệ thống đóng) và deepagents (LangGraph) (mã nguồn mở ) – trên cùng 14 tác vụ cấp doanh nghiệp, với cùng các công cụ và cùng mô hình. Độ chính xác tương đương, chi phí thấp hơn:

Rẻ hơn khoảng 30% so với dịch vụ quản lý đại lý của Claude trên cùng một mô hình (Opus 4.8).
Rẻ hơn khoảng 2,5 lần so với DeepAgents trên cùng một mô hình.
Chi phí vận hành thấp hơn khoảng 75% khi sử dụng mô hình mã nguồn mở hiệu quả GLM-5.2 , mà chất lượng vẫn tương đương.

Những gì chúng tôi đã đo lường

Chúng tôi sử dụng các tác vụ L1-L2 từ Enterprise-Bench của DevRev – 14 tác vụ liên hệ giữa các hệ thống, mô phỏng công việc vận hành B2B thực tế trên các bộ phận kỹ thuật, bán hàng và hỗ trợ. Mỗi tác vụ yêu cầu nhân viên kết nối dữ liệu trên ba máy chủ MCP: một hệ thống CRM (kiểu Salesforce), một hệ thống theo dõi dự án (kiểu Jira) và một kho lưu trữ tài liệu (kiểu Drive).

Cách chúng tôi đo lường

Mỗi bộ khung kiểm thử đều chạy cùng một mô hình, cùng ba máy chủ MCP và cùng một dấu nhắc hệ thống, với mỗi tác vụ được thực hiện trong một phiên mới và không có gì được chuyển tiếp từ phiên trước. Chúng tôi thực hiện n = 3 lần thử nghiệm cho mỗi cấu hình và báo cáo giá trị trung bình.Các câu trả lời được chấm điểm bởi một giám khảo LLM độc lập, người chỉ xem xét các tiêu chí của bài tập và câu trả lời – chứ không bao giờ biết được bộ dây dẫn nào đã tạo ra câu trả lời đó – và một bài tập chỉ được coi là đạt nếu đáp ứng mọi tiêu chí yêu cầu.

Kết quả

Cấu hình	Đã giải quyết / 14	$ / chạy	Mã thông báo / lần chạy
Claude Managed Agents · Opus 4.8	10.7	11,8 đô la	10.0 triệu
TrueForge · Opus 4.8	10.7	8,6 đô la	3,7 triệu
TrueForge · GLM-5.2	11.7	3 đô la	3,8 triệu
deepagents · Opus 4.8	10.0	21,2 đô la	16,5 triệu
deepagents · GLM-5.2	12.0	9,1 đô la	11,9 triệu

Solved / 14là số lượng nhiệm vụ trung bình được hoàn thành trong mỗi lần thử (n = 3 lần thử cho mỗi cấu hình).

Theo nhiệm vụ

Các nhiệm vụ được hoàn thành qua 3 lần thử nghiệm, theo từng cấu hình:

Nhiệm vụ	CMA · Opus	TrueForge · Opus	TrueForge · GLM-5.2	deepagents · Opus	deepagents · GLM-5.2
eng-l1-a	0/3	0/3	1/3	0/3	0/3
eng-l1-b	3/3	3/3	3/3	3/3	3/3
eng-l1-c	1/3	3/3	3/3	3/3	3/3
eng-l2-a	0/3	0/3	1/3	3/3	1/3
eng-l2-b	1/3	1/3	2/3	3/3	3/3
doanh số-l1-a	3/3	3/3	2/3	3/3	3/3
doanh số-l2-a	3/3	1/3	3/3	3/3	3/3
doanh số-l2-b	3/3	3/3	3/3	3/3	3/3
doanh số-l2-c	3/3	3/3	3/3	3/3	3/3
doanh số-l2-d	3/3	3/3	3/3	0/3	3/3
hỗ trợ-l1-a	3/3	3/3	3/3	3/3	3/3
hỗ trợ-l1-b	3/3	3/3	3/3	0/3	3/3
hỗ trợ-l1-c	3/3	3/3	3/3	3/3	2/3
hỗ trợ-l2-a	3/3	3/3	2/3	0/3	3/3
Trung bình / 14	10.7	10.7	11.7	10.0	12.0

Vì sao nó rẻ hơn?

Phần lớn chi phí trong một lần chạy tác nhân nằm ở vòng lặp, chứ không phải câu trả lời cuối cùng – mỗi lần công cụ thực hiện đều gửi ngữ cảnh ngày càng tăng trở lại mô hình. TrueForge giữ cho vòng lặp đó gọn nhẹ:

Ngữ cảnh được đơn giản hóa trong mỗi lượt. Nó hoạt động dựa trên hướng dẫn ngắn gọn thay vì cấu trúc phức tạp; deepagents cũng tích hợp lập kế hoạch, hệ thống tập tin ảo và cơ chế tác nhân phụ trong mỗi lượt.
Số lần gọi công cụ ít hơn. Nó lên kế hoạch thực hiện ít lần gọi công cụ nhất trong ba công cụ để đạt được kết quả tương tự – 19 lần gọi cho mỗi tác vụ, so với 32 và 40 lần gọi của các công cụ khác.
Phương pháp này nén dữ liệu thay vì phát lại. Nó cắt bớt lịch sử và giảm tải các phản hồi lớn từ công cụ thay vì gửi lại mọi thứ nguyên văn; deepagents đọc lại ngữ cảnh đã tích lũy từng bước một, đó là lý do tại sao nó cần số lượng token gấp ba đến bốn lần cho cùng một tác vụ.

Tạo một tác nhân

TrueLabAI — Mon, 12 Oct 2026 08:34:38 +0000

Một agent là một định nghĩa đã được lưu và có thể tái sử dụng: một mô hình, các hướng dẫn, các công cụ và kỹ năng mà nó có thể sử dụng, và một tập hợp các hành vi trong thời gian chạy. Bạn xây dựng một agent trên trang Xây dựng Agent hoặc thông qua SDK – bằng cả hai cách, TrueForge đều lưu trữ cùng một thông số kỹ thuật agent, và bất kỳ số lượng cuộc hội thoại nào cũng có thể chạy với agent đó.

Giải thích chi tiết về vai trò của một người môi giới – mọi lựa chọn có trong dịch vụ.
Tạo tài khoản đại lý thông qua giao diện người dùng — các tùy chọn hiện có trong giao diện người dùng.
Tạo một agent thông qua API – thông số kỹ thuật đầy đủ của agent, bao gồm mọi trường thông tin.

Một người đại diện bao gồm những gì?

Mỗi tùy chọn bên dưới là một phần của định nghĩa tác nhân. Dòng “Đặt trong ” trên mỗi tùy chọn cho biết nơi bạn có thể cấu hình nó hiện tại – giao diện người dùng trò chuyện, API hoặc cả hai.

Tạo một tác nhân thông qua giao diện người dùng

Mở Build Agent từ thanh bên. Bảng Agent Config ở bên trái là nơi bạn thiết lập tác nhân; khung chat ở bên phải cho phép bạn kiểm tra tác nhân trong quá trình thiết lập.

Chọn một mô hình từ các nhà cung cấp mà bạn đã cấu hình trong Cài đặt → Mô hình, và đặt mức độ nỗ lực suy luận của nó.
Hãy viết hướng dẫn cụ thể – về vai trò, đối tượng và hành vi.
Thêm máy chủ MCP – mở Chọn Công cụ MCP, chọn các máy chủ mà tác nhân nên sử dụng và chọn công cụ nào của chúng để kích hoạt. Sử dụng biểu tượng khiên trên một công cụ để yêu cầu phê duyệt trước khi chạy – các công cụ phá hoại được kiểm soát theo mặc định. Đặt công tắc tải trước của máy chủ trên chip của nó để tải các công cụ của nó trước.
Thêm kỹ năng nếu nhân viên cần tuân theo các quy trình chuyên biệt (yêu cầu bật chế độ sandbox ).
Mở Cấu hình Thời gian chạy để xem xét quá trình thực thi và hành vi ngữ cảnh – Các tác nhân phụ động, Giao diện người dùng tạo sinh, Hỏi người dùng câu hỏi, hộp cát, giới hạn lặp lại và nén ngữ cảnh (tất cả đều được bật theo mặc định).
Nhấp vào Lưu Đặc vụ, đặt tên và mô tả cho đặc vụ đó, rồi lưu lại. Đặc vụ này sau đó sẽ xuất hiện trong mục Đặc vụ.

Lưu một tác nhân có thể tái sử dụng từ trang Xây dựng tác nhân.

Hiện có sẵn trong giao diện người dùng: mô hình, hướng dẫn, máy chủ MCP (đính kèm, lựa chọn công cụ, phê duyệt công cụ, tải trước), kỹ năng, hộp cát (bật/tắt và tải xuống tệp), giới hạn lặp, nén ngữ cảnh, và các tác nhân phụ động, giao diện người dùng tạo sinh và các nút chuyển đổi Hỏi người dùng câu hỏi.

Tạo tác nhân thông qua API

SDK và API HTTP hiển thị mọi tùy chọn thông qua đặc tả tác nhân. Bạn có thể lưu đặc tả này dưới dạng một tác nhân có tên, có thể tái sử dụng và tham chiếu nó bằng tên, hoặc truyền trực tiếp nó khi mở phiên. Tất cả các trường đều là kiểu dữ liệu null, và mọi trường ngoại trừ kiểu dữ liệu null đều có giá trị mặc định.snake_casemodel

Kết nối với máy khách: Khi bật đăng nhập OIDC, hãy truyền mã thông báo ID; xem phần Lấy mã thông báo và kết nối. Khi tắt đăng nhập, hãy bỏ qua bước này token.
Lưu cấu hình dưới dạng một tác nhân được đặt tên: agents.create( POST /api/v1/agents) lưu trữ thông số kỹ thuật dưới một tên duy nhất namevà trả về tác nhân với tên do máy chủ tạo ra id. Tên này là bất biến và phải là duy nhất – nếu trùng lặp sẽ trả về 409. Tên descriptionnày là bắt buộc.
Mở một phiên chơi và luân phiên nhau: Tham chiếu đến tác nhân đã lưu theo tên, sau đó thực hiện một lượt chơi. Xem Sử dụng tác nhân để biết toàn bộ quy trình, bao gồm phê duyệt và câu hỏi.

Thông số kỹ thuật đầy đủ của đại lý

Những gì manifestbạn lưu (hoặc nội tuyến spec) là thông số kỹ thuật của tác nhân bên dưới – mọi trường, với các giá trị mặc định.

Cột “Thiết lập thông qua ” trên mỗi bảng bên dưới cho biết trường đó hiện có thể được cấu hình thông qua giao diện người dùng ( UI) , API hoặc cả hai.

Agents

TrueLabAI — Mon, 12 Oct 2026 08:28:26 +0000

Agents là nơi lưu trữ các agent đã lưu. Mở mục này từ thanh bên để tìm kiếm các agent đã lưu, bắt đầu cuộc trò chuyện với chức năng “Thử” hoặc quản lý agent từ menu hàng của nó. Mỗi hàng tóm tắt mô hình, kỹ năng và các kết nối của agent.

Các cộng tác viên: tìm kiếm các cộng tác viên đã lưu và bắt đầu trò chuyện với Try.

Từ trang này, bạn có thể:

Tìm kiếm đại lý theo tên
Hãy thử liên hệ với một nhân viên hỗ trợ để bắt đầu phiên trò chuyện.
Mở menu hàng để chỉnh sửa một tác nhân (mô hình, công cụ, kỹ năng và hướng dẫn của tác nhân trong Build Agent) hoặc quản lý tác nhân đó.

Khả năng hiển thị và truy cập (chế độ lưu trữ)

Ở chế độ lưu trữ với tính năng đăng nhập được bật, TrueForge hiện chưa giới hạn phạm vi thư viện tác nhân theo người dùng hoặc nhóm.

Lịch sử phiên vẫn giới hạn trong phạm vi người dùng (mỗi người dùng chỉ thấy các cuộc trò chuyện của riêng họ). Các cài đặt (mô hình, trình kết nối, kỹ năng, hộp cát) vẫn chỉ dành cho quản trị viên khi OIDC được bật. Thư viện tác nhân hiện đang mở cho tất cả người dùng đã xác thực trên máy chủ đó.Ở chế độ cục bộ (danh tính dùng chung duy nhất), chỉ có một người dùng, do đó mô hình thư viện dùng chung vẫn được áp dụng theo định nghĩa.

Sessions

TrueLabAI — Mon, 12 Oct 2026 08:16:37 +0000

Sessions ghi lại mọi cuộc hội thoại với đặc vụ. Mở nó từ thanh bên để xem đặc vụ đã làm gì trong một ca làm việc, mỗi lượt kéo dài bao lâu, đã sử dụng công cụ và đặc vụ phụ nào , và lỗi xảy ra ở đâu.

Danh sách các phiên

Mọi phiên được liệt kê theo thứ tự mới nhất trước. Mỗi hàng hiển thị thông báo mở đầu, thời gian chạy, số lượt đã thực hiện và tổng thời lượng. Sử dụng bộ lọc tác nhân và khung thời gian ở trên cùng (mặc định là 30 ngày gần đây) để thu hẹp danh sách xuống hoạt động gần đây hoặc xuống một tác nhân cụ thể.Các lần chạy được bắt đầu theo lịch trình cũng xuất hiện ở đây, được đánh dấu là ” Chạy theo lịch trình” và hiển thị tác vụ đã chạy.

Phiên hoạt động của đặc vụ: các lần chạy gần đây với số lượt và thời lượng, có thể lọc theo đặc vụ và khung thời gian.

Chi tiết phiên

Nhấp vào một phiên để mở nó. Chế độ xem chi tiết có ba phần.

Các chỉ số tóm tắt

Một hàng tổng hợp cho toàn bộ phiên: Lượt, Thời lượng, Mã thông báo, Ngữ cảnh, Số lần gọi công cụ, Tác nhân phụ và Lỗi. Nó tóm tắt quá trình chạy một cách nhanh chóng.

Dòng thời gian sự kiện

Một dòng thời gian thể hiện toàn bộ quá trình chạy, được tô màu theo loại sự kiện, chẳng hạn như Hệ thống, Người dùng, Mô hình, Cuộc gọi công cụ và Tác nhân phụ. Nó cho thấy thời gian của quá trình chạy đã được sử dụng như thế nào, do đó dễ dàng nhận biết được một cuộc gọi mô hình chậm, một công cụ chạy lâu hoặc các tác nhân phụ chạy song song.

Bản ghi chép từng bước

Bên dưới dòng thời gian, mỗi lượt chơi được liệt kê với số lượng token và thời lượng riêng, thông báo của người dùng và mục ” Các bước của tác nhân” mà bạn có thể mở rộng để xem các cuộc gọi công cụ mà tác nhân đã thực hiện và cách chúng được giải quyết. Cả hai công cụ này cùng nhau giúp dễ dàng xác định chính xác vị trí xảy ra lỗi trong quá trình vận hành, cho dù đó là do thao tác bị hủy, máy chủ MCP gặp lỗi hay công cụ không trả về kết quả hữu ích nào.

Phiên họp đã được mở để kiểm tra: các số liệu tóm tắt, diễn biến sự kiện và bản ghi chi tiết từng lượt diễn biến.

Tiếp tục chạy

Mỗi phiên đều có một ID phiên có thể sao chép, và phần tiêu đề chi tiết có một nút để tiếp tục phiên, nút này sẽ mở lại cuộc trò chuyện để bạn có thể tiếp tục.

Lịch trình

TrueLabAI — Mon, 12 Oct 2026 08:09:31 +0000

Lịch trình sẽ tự động chạy một tác vụ đã lưu theo chu kỳ định kỳ, mà không cần sự can thiệp của người dùng. Mỗi lần chạy sẽ gửi cùng một tác vụ đến tác vụ đó, thực thi trên máy chủ và được ghi lại dưới dạng một phiên làm việc mà bạn có thể mở sau này. Hãy sử dụng chúng cho các công việc định kỳ như tóm tắt hàng ngày, báo cáo định kỳ hoặc kiểm tra thường xuyên.

Trước khi bạn bắt đầu

Lịch trình sẽ chạy một tác vụ đã được lưu sẵn, vì vậy hãy tạo tác vụ trước. Tác vụ sẽ nhận cùng một nhiệm vụ trong mỗi lần chạy, vì vậy các hướng dẫn và công cụ của nó nên đã bao gồm công việc đó.

Lập lịch trình

Mở mục Lịch trình từ thanh bên và nhấp vào Tạo lịch trình. Điền vào các thông tin sau:

Agent: tác nhân đã được lưu để chạy.
Tên: nhãn cho lịch trình.
Nhiệm vụ: tin nhắn được gửi đến tác nhân trong mỗi lần chạy. Hãy viết nó như tin nhắn đầu tiên trong một cuộc trò chuyện, ví dụ: “Tóm tắt những tin tức quan trọng nhất về AI trong 24 giờ qua và liệt kê năm mục hàng đầu kèm theo liên kết.”
Tần suất: Hàng giờ, Hàng ngày hoặc Hàng tuần, kèm theo giờ, phút và múi giờ cần chạy. Biểu mẫu sẽ hiển thị trước kết quả, ví dụ như “Hàng ngày 9:00 sáng” theo múi giờ của bạn.

Nhấp vào Lưu. Lịch trình sẽ được kích hoạt và chạy theo nhịp độ đã thiết lập.

Tạo lịch trình: chọn một tác nhân đã lưu, viết nhiệm vụ và thiết lập tần suất cũng như múi giờ.

Cách thức hoạt động của các lượt chạy

Mỗi lần chạy sẽ bắt đầu một phiên mới, gửi nhiệm vụ cho tác nhân và kết thúc khi tác nhân hoàn thành nhiệm vụ đó.
Mỗi lần chạy được ghi lại dưới dạng một phiên, được đánh dấu là ” Lần chạy theo lịch trình”, vì vậy bạn có thể mở nó để đọc bản ghi, các lệnh gọi công cụ và kết quả.
Danh sách này hiển thị kết quả của năm lượt chạy gần nhất cho mỗi lịch trình.
Sử dụng chức năng “Chạy ngay” để kích hoạt quá trình chạy ngay lập tức, mà không cần chờ đến thời gian đã lên lịch tiếp theo.

Quản lý lịch trình

Trang Lịch trình tác vụ liệt kê mọi lịch trình với tác nhân, tần suất, trạng thái và các lần chạy gần đây. Từ đây bạn có thể:

Tìm kiếm theo tên, hoặc lọc theo trạng thái hoặc người đại diện.
Tạm dừng lịch trình để dừng nó chạy và tiếp tục sau. Các lịch trình đã tạm dừng vẫn còn trong danh sách.
Chỉnh sửa nhiệm vụ, chu kỳ hoặc múi giờ của lịch trình.
Xóa lịch trình mà bạn không còn cần nữa.

Thông qua SDK

Bạn có thể tạo và quản lý lịch trình bằng lập trình với client.schedules. Xem Lịch trình trong SDK.

Kỹ năng

TrueLabAI — Mon, 12 Oct 2026 07:59:33 +0000

Kỹ năng dạy cho nhân viên cách thực hiện các nhiệm vụ chuyên biệt – truy vấn cơ sở dữ liệu, phân loại cảnh báo, tuân theo quy trình xử lý sự cố hoặc soạn thảo ghi chú phát hành.Kỹ năng là một thư mục trong kho lưu trữ Git, có gốc là một SKILL.mdtệp. Đăng ký kỹ năng một lần trong Cài đặt → Kỹ năng, sau đó gắn chúng theo tên khi bạn tạo tác nhân.

Đăng ký kỹ năng

Mở Cài đặt → Kỹ năng, chọn một kỹ năng cơ bản từ danh mục hoặc thêm kho lưu trữ GitHub/GitLab của riêng bạn (URL, đường dẫn tùy chọn và tham chiếu). Ghim thẻ hoặc mã SHA của commit để đảm bảo tính ổn định khi sử dụng trong môi trường sản xuất.

Các kỹ năng khởi đầu trong danh mục được lấy từ danh mục kỹ năng mặc định – 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 những gì giao diện người dùng cung cấp.

Kỹ năng bao gồm những gì?

customer-support-skill/
├── SKILL.md
├── references/
│ └── escalation-policy.md
└── scripts/
└── classify_ticket.py

SKILL.mdNó có phần đầu YAML ( name, description) và phần thân hướng dẫn bằng Markdown. Phần đầu descriptionlà những gì người đại lý nhìn thấy ngay từ đầu; toàn bộ nội dung và các tệp hỗ trợ chỉ được tải khi người đại lý chọn kỹ năng ( tiết lộ dần dần ).

Yêu cầu thời gian chạy

Trong quá trình thực thi:

Bộ dây đeo hiển thị tên và mô tả của từng kỹ năng được gắn kèm.
Khi mô hình xác định một kỹ năng nào đó là phù hợp, kho lưu trữ sẽ được hiện thực hóa trong phần /opt/tfy/skills/{name}.
Nhân viên này theo dõi SKILL.mdvà sử dụng các tài liệu hỗ trợ khi cần thiết.

Kỹ năng + Công cụ MCP

Kỹ năng xác định cách thức xử lý một nhiệm vụ (quy trình, logic quyết định, định dạng).
Các công cụ MCP cung cấp các thao tác và dữ liệu để thực hiện điều đó.

Ví dụ: bộ kỹ năng theo dõi CRM thiết lập giọng điệu và quy tắc leo thang; công cụ MCP tra cứu hồ sơ, cập nhật phiếu yêu cầu và thông báo cho Slack.

Mẹo viết bài

Hãy giữ cho hình ảnh descriptionsắc nét – đó là thứ duy nhất mà mô hình nhìn thấy trước khi tải kỹ năng.
Hãy viết SKILL.mdtheo kiểu hướng dẫn dành cho một đồng đội giỏi.
Đưa các tài liệu tham khảo chuyên sâu vào các tệp hỗ trợ liên kết với kỹ năng đó.
Nên ưu tiên một vài kỹ năng chuyên biệt hơn là một kỹ năng đa năng.

Sandbox

TrueLabAI — Mon, 12 Oct 2026 03:25:52 +0000

Môi trường sandbox cung cấp cho tác nhân của bạn một môi trường an toàn, biệt lập để chạy mã, thao tác tệp và thực thi các lệnh shell – tách biệt khỏi máy chủ TrueForge và cơ sở hạ tầng của bạn.Chế độ Kỹ năng và Mã hóa yêu cầu môi trường thử nghiệm (sandbox). Cấu hình nhà cung cấp một lần trong Cài đặt → Nhà cung cấp môi trường thử nghiệm, tùy chọn xác định một hoặc nhiều môi trường, sau đó bật môi trường thử nghiệm trên mỗi tác nhân cần đế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=value`có 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.

Kết nối mạng	Truy cập ra ngoài
Không bộ nào	Không giới hạn (mặc định, hiển thị trong `Unrestricted`phần môi trường)
Danh sách cho phép tên miền	Chỉ những máy chủ được liệt kê mới có thể truy cập được; mọi thứ khác đều bị chặn.
Chặn tất cả mạng	Không có quyền truy cập ra ngoài; danh sách cho phép và các thông tin bí mật bị bỏ qua.

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” } }

Bộ chọn Môi trường của tác nhân trong Cấu hình Thời gian chạy, với liên kết Quản lý Môi trường.

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ó.

Tổng quan Harness

TrueLabAI — Sun, 11 Oct 2026 23:14:00 +0000

TrueForge không chỉ đơn thuần là mô hình + công cụ. Những tính năng của bộ dây dẫn này giúp cho việc vận hành các đường dẫn chất tẩy rửa dài ngày trở nên chính xác hơn, tiết kiệm hơn và an toàn hơn.

Tính năng	Chức năng của nó là gì?
Sandbox như một công cụ	Thực thi mã/tệp độc lập mà không cần đưa thông tin bí mật hoặc vòng lặp tác nhân vào bên trong hộp cát.
Kỹ thuật ngữ cảnh	Kỹ năng tiến bộ, công cụ trì hoãn, tác nhân phụ, chuyển giao công việc, Chế độ mã, nén dữ liệu
Phê duyệt công cụ	Tạm dừng trước khi ghi/xóa các công cụ MCP
Đặt câu hỏi làm rõ	Làm rõ vấn đề một cách có cấu trúc trong quá trình chạy
Giao diện người dùng tạo sinh	Biểu đồ, bảng và thẻ được truyền tải liên tục vào khung chat.
Xác thực OAuth MCP trong cuộc trò chuyện	Nút kết nối khi cần xác thực trình kết nối.

Sandbox như một công cụ

Không giống như các hệ thống chạy toàn bộ tác nhân bên trong máy ảo, TrueForge giữ vòng lặp tác nhân trên máy chủ và chỉ sử dụng môi trường sandbox cho mã, tệp và shell. Thông tin bí mật không được lưu trữ trong sandbox; tài nguyên tính toán chỉ được cung cấp khi cần thiết. Chế độ Kỹ năng và Chế độ Mã yêu cầu điều này.

Kỹ thuật tạo bối cảnh là gì?

Kỹ thuật ngữ cảnh là cung cấp thông tin chính xác ở định dạng phù hợp để tác nhân có thể hoàn thành công việc một cách đáng tin cậy. Trong TrueForge, ngữ cảnh bao gồm tất cả những gì mô hình nhìn thấy ở mỗi bước – hướng dẫn, kỹ năng , định nghĩa công cụ MCP, lịch sử hội thoại và kết quả của công cụ.

Việc mất đi sự cân bằng đó sẽ ảnh hưởng đến chất lượng:

Thiếu ngữ cảnh – nhân viên hỗ trợ thiếu thông tin cần thiết và trả lời kém hiệu quả.
Quá nhiều ngữ cảnh – cửa sổ bị lấp đầy bởi nhiễu, khả năng suy luận bị suy giảm, và chi phí/độ trễ tăng cao.

TrueForge quản lý sự cân bằng bằng các chiến lược nhiều lớp. Hãy nghĩ về bối cảnh theo hai giai đoạn:

Ngữ cảnh đầu vào được thiết lập khi khởi động; ngữ cảnh thời gian chạy được mở rộng từng bước khi vòng lặp của tác nhân hoạt động.

Ngữ cảnh đầu vào

Ngữ cảnh đầu vào là tất cả những gì mô hình nhận được khi bắt đầu một lần chạy. Nó hầu như không thay đổi giữa các lần chạy của cùng một tác nhân – bạn cấu hình nó một lần và hệ thống sẽ tải nó mỗi lần. Ngữ cảnh đầu vào càng nhỏ và càng tập trung, mô hình càng có nhiều không gian để suy luận.

Ngữ cảnh thời gian chạy

Ngữ cảnh thời gian chạy bao gồm tất cả mọi thứ được thêm vào ngữ cảnh của mô hình trong quá trình chạy:

Nguồn	Nó là gì?
Tin nhắn người dùng	Bất kể người dùng gửi gì, kể cả các tin nhắn tiếp theo trong cuộc hội thoại nhiều lượt.
Tin nhắn trợ lý	Lý luận và phản hồi của mô hình ở mỗi bước
Công cụ gọi	Mỗi lệnh gọi công cụ do tác nhân thực hiện, cùng với các đối số của nó.
Kết quả công cụ	Bất kể công cụ trả về gì — dữ liệu JSON, nội dung tệp, kết quả tìm kiếm, lỗi.
Đầu ra của tác nhân phụ	Kết quả cuối cùng được trả về từ các đại lý phụ được ủy quyền.

Vấn đề phình to ngữ cảnh chủ yếu xảy ra ở ngữ cảnh thời gian chạy. Một lệnh gọi công cụ duy nhất trả về tải trọng JSON 50.000 token, hoặc một cuộc hội thoại dài với hàng chục bước trung gian, có thể nhanh chóng đạt đến giới hạn của mô hình. Đây là phần mà hệ thống kiểm thử chủ động quản lý.

Quản lý ngữ cảnh thời gian chạy

Các tác nhân phụ – cách ly ngữ cảnh

Các tác nhân con phân tách các tác vụ nặng. Khi tác nhân gốc tạo ra một tác nhân con:

Tác nhân phụ hoạt động với bối cảnh riêng biệt, hoàn toàn mới mẻ – các hướng dẫn và công cụ, nhưng không có lịch sử tin nhắn được chia sẻ.
Nó hoạt động tự động, tự gọi các công cụ và tạo ra kết quả cuối cùng.
Chỉ có kết quả cuối cùng mới được trả về cho tác nhân gốc. Các lệnh gọi công cụ trung gian, kết quả tìm kiếm lớn và các bước suy luận không bao giờ được đưa vào ngữ cảnh của tác nhân gốc.

Điều này đặc biệt hữu ích cho các tác vụ liên quan đến nhiều thực thể hoặc yêu cầu nhiều lệnh gọi công cụ. Ví dụ, việc tóm tắt các yêu cầu kéo (PR) trong một nhóm 10 người có thể được phân bổ thành 10 tác nhân con song song – tác nhân gốc thu thập 10 bản tóm tắt ngắn thay vì 10 bộ dữ liệu đầu ra thô từ công cụ. Xem phần Tác nhân con.

Tải xuống kết quả lớn

Đôi khi một lệnh gọi công cụ duy nhất trả về lượng dữ liệu nhiều hơn mức mà tác nhân cần để xử lý – một danh sách JSON lớn, một tập tin dài, một phản hồi tìm kiếm chi tiết. Việc chuyển tải dữ liệu giúp giữ cho dữ liệu đó không bị ảnh hưởng bởi ngữ cảnh:

Sau đó, tác nhân có thể sử dụng các công cụ hộp cát để kiểm tra tệp, suy luận lược đồ của nó, trích xuất các trường cụ thể hoặc lọc dữ liệu – tất cả mà không cần dữ liệu thô được đưa vào cuộc hội thoại. Xem Phản hồi công cụ lớn.

Chế độ mã – xử lý đầu ra của công cụ dưới dạng mã

Đối với các tác vụ liên quan đến việc tổng hợp, lọc hoặc chuyển đổi đầu ra của công cụ (đếm, nhóm theo, kết hợp giữa nhiều lệnh gọi công cụ), Chế độ Mã cho phép tác nhân chạy một kịch bản Python trong môi trường thử nghiệm để gọi trực tiếp các công cụ MCP. Kịch bản xử lý dữ liệu bằng mã và chỉ in ra bản tóm tắt.Điều này giúp tránh hai kiểu lỗi xảy ra cùng một lúc:

Sự phình to ngữ cảnh – đầu ra thô của công cụ không bao giờ được đưa vào ngữ cảnh, chỉ có kết quả được in ra mới được đưa vào.
Phép toán ảo giác – các phép đếm, phép cộng và phép nhóm được tính toán bằng mã, chứ không phải suy luận từ văn bản.

Nén ngữ cảnh

Khi cuộc hội thoại kéo dài hơn khả năng xử lý của việc chỉ sử dụng phương pháp chuyển tải dữ liệu, hệ thống sẽ kích hoạt quá trình nén dữ liệu. Quá trình nén dữ liệu được bật theo mặc định và chạy ở mức 80% độ dài ngữ cảnh của mô hình. Nếu độ dài đó không đủ, hệ thống sẽ chuyển sang sử dụng 50.000 token đầu vào. Người dùng cũng có thể đặt ngưỡng token đầu vào cụ thể. LLM tạo ra bản tóm tắt có cấu trúc về cuộc hội thoại cho đến nay – ý định ban đầu, các quyết định quan trọng, tệp và hiện vật, lỗi và cách khắc phục, và các bước tiếp theo – và bản tóm tắt đó thay thế lịch sử tin nhắn cũ trong ngữ cảnh làm việc của tác nhân, giải phóng các token để tiếp tục suy luận.

Các chiến lược được cấu thành như thế nào

Trên thực tế, các chiến lược này được kết hợp với nhau. Một lần chạy của tác nhân duy nhất có thể:

Bắt đầu với chế độ tải trước tắt, để chỉ một số ít lược đồ công cụ nằm trong ngữ cảnh đầu vào.
Giao nhiệm vụ nghiên cứu cho một tác nhân phụ thực hiện hàng chục lệnh gọi công cụ một cách độc lập.
Chuyển kết quả của một công cụ lớn bên trong tác nhân phụ sang một tệp hộp cát.
Sử dụng Chế độ Mã (Code Mode) để tổng hợp dữ liệu đã được xử lý thành một bản tóm tắt ngắn gọn.
Trả lại bản tóm tắt cho tác nhân gốc – giữ cho ngữ cảnh hoạt động của tác nhân gốc luôn sạch sẽ.
Sau này, nếu cuộc hội thoại dài vượt quá ngưỡng cho phép, hãy nén lịch sử của tác nhân gốc lại.

Sub Agent

TrueLabAI — Sun, 11 Oct 2026 23:02:44 +0000

Khi một tác vụ liên quan đến việc thu thập hoặc xử lý thông tin từ nhiều nguồn, một tác nhân duy nhất có thể nhanh chóng làm đầy cửa sổ ngữ cảnh của nó với các lệnh gọi công cụ trung gian và kết quả. TrueForge giải quyết vấn đề này bằng các tác nhân con – các tác nhân chạy độc lập, nhẹ, xử lý các tác vụ con tập trung song song và chỉ trả về kết quả cuối cùng cho tác nhân gốc. Các tác nhân con động được bật theo mặc định. Người điều hành chính tập trung vào việc phối hợp cấp cao. Các nhân viên cấp dưới đảm nhiệm những công việc nặng nhọc hơn.

Tại sao lại cần các đại lý phụ?

Các tác nhân phụ giải quyết vấn đề phình to ngữ cảnh. Khi một tác nhân sử dụng các công cụ có đầu ra lớn – phản hồi API, kết quả tìm kiếm, nội dung tệp – cửa sổ ngữ cảnh sẽ đầy dữ liệu trung gian chỉ cần thiết tạm thời. Khi ngữ cảnh phát triển, tác nhân trở nên chậm hơn, tốn kém hơn và dễ xảy ra lỗi hơn.Hãy xem xét một nhiệm vụ: “Tóm tắt các yêu cầu kéo (pull request) gần đây của mỗi thành viên trong nhóm của tôi.”

Không có đại lý phụ:

Đặc vụ tìm kiếm thông tin về các thành viên trong nhóm.
Nó xử lý từng thành viên một , lấy các yêu cầu kéo (pull request) và tóm tắt từng yêu cầu.
Tất cả các lệnh gọi công cụ trung gian và kết quả đều được lưu giữ trong cửa sổ ngữ cảnh.
Người đại diện phải suy luận trong một bối cảnh rộng lớn và phức tạp để đưa ra câu trả lời cuối cùng.
Tình trạng phình to này sẽ tiếp diễn sang các lượt chơi tiếp theo trong phiên.

Với các đại lý phụ:

Đặc vụ tìm kiếm thông tin về các thành viên trong nhóm.
Nó tạo ra một tác nhân phụ cho mỗi thành viên trong nhóm – chúng hoạt động song song.
Mỗi tác nhân con sẽ tự động lấy các yêu cầu kéo và tạo ra bản tóm tắt.
Các tác nhân phụ chỉ trả về bản tóm tắt của chúng cho tác nhân gốc.
Tác nhân gốc kết hợp các bản tóm tắt – dữ liệu thô không bao giờ được đưa vào ngữ cảnh của nó.

Khi nào các trợ lý cấp dưới phát huy hiệu quả nhất:

Nghiên cứu nhiều bước trên nhiều thực thể (người dùng, kho lưu trữ, dịch vụ) có thể chạy song song.
Các tác vụ mà đầu ra của công cụ trung gian lớn nhưng kết quả cuối cùng là một bản tóm tắt.
Công việc cần sự tách biệt – mỗi nhiệm vụ phụ đều có bối cảnh rõ ràng để suy luận.

Cách thức hoạt động

Tác nhân gốc sẽ quyết định trong quá trình thực thi xem có nên ủy quyền hay không. Khi quyết định, nó sẽ gọi create_sub_agentcông cụ tích hợp sẵn với các hướng dẫn được tạo ra và tập trung cho từng tác vụ con, tạo ra các tác nhân con và chờ kết quả của chúng.

Công cụ và môi trường thử nghiệm dùng chung – các tác nhân phụ có quyền truy cập vào cùng các công cụ MCP và môi trường thử nghiệm như tác nhân gốc.
Không có tương tác người dùng – các tác nhân phụ không thể hỏi người dùng câu hỏi. Chỉ có tác nhân gốc mới giao tiếp với người dùng. Tuy nhiên, các lệnh gọi công cụ của tác nhân phụ yêu cầu phê duyệt vẫn tạm dừng để người dùng chờ xử lý.
Không có lồng ghép – các tác nhân con không thể tạo ra các tác nhân con khác. Ủy quyền chỉ có một cấp độ.
Thực thi song song – nhiều tác nhân con chạy đồng thời. Tác nhân gốc chờ tất cả chúng trước khi tiếp tục.