Tác nhân phụ

ChatGPT Work và Codex có thể chạy quy trình tác nhân phụ bằng cách khởi tạo các tác nhân chuyên biệt song song, sau đó tổng hợp kết quả của chúng trong một phản hồi. Cách này đặc biệt hữu ích cho các tác vụ phức tạp có khả năng song song hóa cao, chẳng hạn như khám phá cơ sở mã hoặc triển khai kế hoạch tính năng gồm nhiều bước.

Trong các ứng dụng Codex cục bộ, bạn cũng có thể xác định tác nhân tùy chỉnh với các cấu hình mô hình và hướng dẫn khác nhau cho từng tác vụ.

Khả dụng

ChatGPT Work trên web

ChatGPT Work cung cấp quy trình và hoạt động của tác nhân phụ cho các tài khoản đủ điều kiện.

Ứng dụng Codex cục bộ

Các bản phát hành Codex hiện tại bật quy trình tác nhân phụ theo mặc định. Hoạt động của tác nhân phụ xuất hiện trong ứng dụng ChatGPT dành cho máy tính, Codex CLI và tiện ích mở rộng IDE.

Vì mỗi tác nhân phụ tự thực hiện công việc với mô hình và công cụ, quy trình tác nhân phụ tiêu thụ nhiều token hơn so với lượt chạy một tác nhân tương đương.

ChatGPT Work trên web

Trong ChatGPT Work, hãy yêu cầu ChatGPT giao công việc độc lập cho các tác nhân phụ. Các tác nhân chạy trong môi trường lưu trữ của ChatGPT và cuộc trò chuyện hiển thị hoạt động cũng như kết quả của chúng. Ở hầu hết các mức trí tuệ, hãy yêu cầu giao việc một cách rõ ràng. Với Ultra, ChatGPT có thể chủ động giao việc khi các tác nhân chạy song song giúp cải thiện đáng kể tốc độ hoặc chất lượng.

Ứng dụng ChatGPT dành cho máy tính

Hãy yêu cầu Codex trong cuộc trò chuyện của ứng dụng giao các phần công việc độc lập cho các tác nhân phụ. Các bản phát hành Codex cục bộ hiện tại sẽ giao việc khi bạn yêu cầu trực tiếp hoặc khi hướng dẫn AGENTS.md hay hướng dẫn skill phù hợp yêu cầu điều đó. Ứng dụng hiển thị từng luồng tác nhân phụ để bạn có thể kiểm tra công việc của tác nhân và bản tóm tắt được trả về cuộc trò chuyện chính.

Codex CLI

Hãy yêu cầu Codex sử dụng tác nhân phụ trong một phiên CLI tương tác. Codex cũng có thể tuân theo hướng dẫn AGENTS.md hoặc hướng dẫn skill phù hợp có yêu cầu giao việc. Sử dụng /agent để kiểm tra và chuyển đổi giữa các luồng tác nhân trong khi chúng chạy. Luồng chính tổng hợp kết quả của tác nhân phụ vào phản hồi cuối cùng.

Tiện ích mở rộng IDE

Hãy yêu cầu Codex trong cuộc trò chuyện IDE giao các phần công việc độc lập cho tác nhân phụ. Codex cũng có thể tuân theo hướng dẫn AGENTS.md hoặc hướng dẫn skill phù hợp có yêu cầu giao việc. Khi giao diện tác nhân nền khả dụng, các tác nhân phụ đang hoạt động sẽ xuất hiện phía trên vùng soạn thảo. Mở rộng bảng để xem trạng thái, dừng tất cả tác nhân phụ đang hoạt động hoặc mở một luồng tác nhân phụ riêng lẻ.

Lợi ích của quy trình tác nhân phụ

Ngay cả với cửa sổ ngữ cảnh lớn, mô hình vẫn có giới hạn. Nếu bạn đưa quá nhiều đầu ra trung gian gây nhiễu vào cuộc trò chuyện chính (nơi bạn xác định yêu cầu, ràng buộc và quyết định), chẳng hạn như ghi chú khám phá, nhật ký kiểm thử, dấu vết ngăn xếp và đầu ra lệnh, phiên làm việc có thể dần trở nên kém tin cậy.

Hiện tượng này thường được mô tả là:

• Ô nhiễm ngữ cảnh: thông tin hữu ích bị chôn vùi dưới đầu ra trung gian gây nhiễu.
• Suy giảm ngữ cảnh: hiệu suất giảm khi cuộc trò chuyện chứa ngày càng nhiều chi tiết ít liên quan.

Để tìm hiểu thêm, hãy xem bài viết của Chroma về suy giảm ngữ cảnh.

Quy trình tác nhân phụ giúp chuyển công việc gây nhiễu khỏi luồng chính:

• Giữ cho tác nhân chính tập trung vào yêu cầu, quyết định và đầu ra cuối cùng.
• Chạy song song các tác nhân phụ chuyên biệt để khám phá, kiểm thử hoặc phân tích nhật ký.
• Trả về bản tóm tắt từ tác nhân phụ thay vì đầu ra trung gian thô.

Quy trình này cũng có thể tiết kiệm thời gian khi công việc có thể chạy độc lập và song song, đồng thời giúp các tác vụ quy mô lớn dễ xử lý hơn bằng cách chia chúng thành những phần có phạm vi rõ ràng. Ví dụ: Codex có thể chia việc phân tích một tài liệu gồm hàng triệu token thành các vấn đề nhỏ hơn và trả về những kết luận cô đọng cho luồng chính.

Để bắt đầu, hãy sử dụng các tác nhân song song cho tác vụ thiên về đọc như khám phá, kiểm thử, phân loại và tóm tắt. Hãy thận trọng hơn với quy trình thiên về ghi chạy song song vì nhiều tác nhân chỉnh sửa mã cùng lúc có thể tạo ra xung đột và tăng chi phí phối hợp.

Thuật ngữ cốt lõi

Codex sử dụng một số thuật ngữ liên quan trong quy trình tác nhân phụ:

• Quy trình tác nhân phụ: Quy trình trong đó Codex chạy các tác nhân song song và kết hợp kết quả của chúng.
• Tác nhân phụ: Tác nhân được giao việc mà Codex khởi tạo để xử lý một tác vụ cụ thể.
• Luồng tác nhân: Luồng nơi tác nhân phụ thực hiện công việc. Các ứng dụng được hỗ trợ cho phép bạn mở những luồng này để kiểm tra tiến độ hoặc kết quả.

Kích hoạt quy trình tác nhân phụ

ChatGPT Work trên web

Ở hầu hết các mức trí tuệ, hãy yêu cầu trực tiếp tác nhân phụ hoặc công việc tác nhân song song. Ultra cho phép chủ động giao việc, vì vậy ChatGPT có thể giao các công việc độc lập phù hợp mà không cần yêu cầu riêng.

Ứng dụng Codex cục bộ

Hãy yêu cầu trực tiếp tác nhân phụ hoặc công việc tác nhân song song. Codex cũng có thể giao việc khi hướng dẫn dự án hoặc hướng dẫn skill phù hợp yêu cầu điều đó.

Trong thực tế, kích hoạt thủ công có nghĩa là sử dụng các chỉ dẫn trực tiếp như "khởi tạo hai tác nhân", "giao công việc này để xử lý song song" hoặc "sử dụng một tác nhân cho mỗi điểm". Quy trình tác nhân phụ tiêu thụ nhiều token hơn so với lượt chạy một tác nhân tương đương vì mỗi tác nhân phụ tự thực hiện công việc với mô hình và công cụ.

Một prompt tốt cho tác nhân phụ nên giải thích cách chia công việc, liệu Codex có nên đợi tất cả tác nhân hoàn thành trước khi tiếp tục hay không và cần trả về bản tóm tắt hoặc đầu ra nào.

Review this branch with parallel subagents. Spawn one subagent for security risks, one for test gaps, and one for maintainability. Wait for all three, then summarize the findings by category with file references.

Chọn mô hình và mức suy luận

Các tác nhân khác nhau cần các thiết lập mô hình và suy luận khác nhau.

ChatGPT Work trên web

Trong ChatGPT Work, hãy chọn mô hình và mức trí tuệ từ vùng soạn thảo. Các mức trí tuệ khả dụng có thể bao gồm Light, Medium, High, Extra High và Max, tùy vào mô hình được chọn. Ultra chỉ khả dụng cho tài khoản và mô hình đủ điều kiện. Chế độ này sử dụng mức suy luận tối đa và cho phép ChatGPT chủ động giao công việc phù hợp cho tác nhân phụ.

Ở các mức trí tuệ khác, hãy yêu cầu tác nhân phụ một cách rõ ràng khi bạn muốn công việc được giao để xử lý song song.

Ứng dụng Codex cục bộ

Nếu bạn không chỉ định cố định mô hình hoặc model_reasoning_effort, Codex có thể chọn một thiết lập cân bằng giữa trí tuệ, tốc độ và chi phí cho tác vụ. Codex có thể ưu tiên gpt-5.6-terra cho các lượt quét nhanh hoặc cấu hình gpt-5.6 với mức nỗ lực cao hơn cho yêu cầu suy luận phức tạp hơn. Khi muốn kiểm soát chi tiết hơn, hãy định hướng lựa chọn đó trong prompt hoặc đặt trực tiếp model và model_reasoning_effort trong tệp tác nhân.

Lựa chọn mô hình

• gpt-5.6: Hãy bắt đầu tại đây cho các tác nhân xử lý công việc phức tạp. Đây là lựa chọn mạnh nhất cho công việc mơ hồ, gồm nhiều bước, cần lập kế hoạch, sử dụng công cụ, xác thực và theo sát đến khi hoàn thành trong ngữ cảnh lớn hơn.
• gpt-5.6-terra: Sử dụng cho các tác nhân ưu tiên tốc độ và hiệu quả hơn chiều sâu, chẳng hạn như khám phá, quét thiên về đọc, đánh giá tệp lớn hoặc xử lý tài liệu hỗ trợ. Mô hình này phù hợp với các tác nhân song song trả về kết quả cô đọng cho tác nhân chính.
• gpt-5.6-luna: Sử dụng cho các tác nhân nhanh, có phạm vi hẹp, xử lý công việc rõ ràng, lặp lại hoặc khối lượng lớn.

Mức nỗ lực suy luận (model_reasoning_effort)

• ultra: Sử dụng cho mức suy luận sâu nhất khi mô hình được chọn hỗ trợ mức này.
• max và xhigh: Sử dụng cho yêu cầu suy luận đặc biệt phức tạp khi mô hình được chọn hỗ trợ các mức này.
• high: Sử dụng khi tác nhân cần lần theo logic phức tạp, kiểm tra giả định hoặc xử lý các trường hợp biên (ví dụ: tác nhân đánh giá hoặc tập trung vào bảo mật).
• medium: Mức mặc định cân bằng cho hầu hết tác nhân.
• low: Sử dụng khi tác vụ đơn giản và tốc độ là ưu tiên hàng đầu.

Mức nỗ lực suy luận cao hơn làm tăng thời gian phản hồi và mức sử dụng token, nhưng có thể cải thiện chất lượng cho công việc phức tạp. Để biết chi tiết, hãy xem Mô hình, Cấu hình cơ bản và Tham chiếu cấu hình.

Điều phối và kiểm soát luồng

ChatGPT hoặc Codex xử lý việc điều phối giữa các tác nhân, bao gồm khởi tạo tác nhân phụ mới, định tuyến hướng dẫn tiếp theo, chờ kết quả và đóng luồng tác nhân.

Khi nhiều tác nhân đang chạy, Codex chờ đến khi có tất cả kết quả được yêu cầu rồi trả về một phản hồi hợp nhất.

ChatGPT Work trên web

Ở hầu hết các mức trí tuệ, ChatGPT khởi tạo tác nhân sau khi nhận yêu cầu trực tiếp. Với Ultra, ChatGPT cũng có thể chủ động giao việc khi xử lý song song hữu ích.

Ứng dụng Codex cục bộ

Các bản phát hành Codex cục bộ hiện tại khởi tạo tác nhân sau khi nhận yêu cầu trực tiếp hoặc theo hướng dẫn dự án hay hướng dẫn skill phù hợp.

Để xem cách hoạt động, hãy thử prompt sau trong dự án của bạn:

I would like to review the following points on the current PR (this branch vs main). Spawn one agent per point, wait for all of them, and summarize the result for each point.
1. Security issue
2. Code quality
3. Bugs
4. Race
5. Test flakiness
6. Maintainability of the code

Quản lý tác nhân phụ

ChatGPT Work trên web

Mở Tác nhân phụ để xem danh sách Đang hoạt động và Đã hoàn thành ở chế độ chỉ đọc. Chọn một tác nhân phụ đã hoàn thành để kiểm tra chi tiết và kết quả. Thanh bên trên web báo cáo hoạt động của tác nhân phụ; thanh này không cung cấp điều khiển để dừng hoặc định hướng từng tác nhân phụ.

Ứng dụng ChatGPT dành cho máy tính

• Mở một luồng tác nhân phụ từ hoạt động hiển thị trong luồng chính để kiểm tra công việc của tác nhân.
• Yêu cầu Codex trực tiếp định hướng một tác nhân phụ đang chạy, dừng tác nhân đó hoặc đóng các luồng tác nhân phụ đã hoàn thành.

Codex CLI

• Sử dụng /agent trong CLI để chuyển đổi giữa các luồng tác nhân đang hoạt động và kiểm tra luồng đang chạy.
• Yêu cầu Codex trực tiếp định hướng một tác nhân phụ đang chạy, dừng tác nhân đó hoặc đóng các luồng tác nhân đã hoàn thành.

Tiện ích mở rộng IDE

• Khi bảng tác nhân nền khả dụng, hãy mở rộng bảng để kiểm tra trạng thái, dừng tác nhân phụ đang hoạt động hoặc mở một luồng tác nhân phụ.
• Yêu cầu Codex trực tiếp định hướng một tác nhân phụ đang chạy, dừng tác nhân đó hoặc đóng các luồng tác nhân đã hoàn thành.

Phê duyệt và kiểm soát sandbox

Ứng dụng Codex cục bộ

Tác nhân phụ kế thừa chính sách sandbox hiện tại của bạn.

ChatGPT Work trên web

ChatGPT Work chạy tác nhân phụ trong môi trường lưu trữ của mình và không cung cấp điều khiển sandbox hay chế độ phê duyệt của Codex cục bộ. Tác nhân phụ sử dụng các công cụ khả dụng cho cuộc trò chuyện cha. Quyền đối với trang web và trình kết nối vẫn phụ thuộc vào từng công cụ.

Ứng dụng ChatGPT dành cho máy tính

Tác nhân phụ kế thừa chế độ quyền được chọn bên dưới vùng soạn thảo. Hãy chọn chế độ quyền cho lượt cha trước khi yêu cầu Codex giao việc.

Codex CLI

Trong các phiên CLI tương tác, yêu cầu phê duyệt có thể xuất hiện từ các luồng tác nhân không hoạt động ngay cả khi bạn đang xem luồng chính. Lớp phủ phê duyệt hiển thị nhãn luồng nguồn và bạn có thể nhấn o để mở luồng đó trước khi phê duyệt, từ chối hoặc trả lời yêu cầu.

Trong quy trình không tương tác hoặc bất cứ khi nào lượt chạy không thể hiển thị yêu cầu phê duyệt mới, một hành động cần phê duyệt mới sẽ thất bại và Codex trả lỗi về quy trình cha.

Codex cũng áp dụng lại các ghi đè thời gian chạy trực tiếp của lượt cha khi khởi tạo tác nhân con. Điều đó bao gồm các lựa chọn sandbox và phê duyệt mà bạn đặt tương tác trong phiên, chẳng hạn như thay đổi /permissions hoặc --yolo, ngay cả khi tệp tác nhân tùy chỉnh được chọn đặt giá trị mặc định khác.

Tiện ích mở rộng IDE

Tác nhân phụ kế thừa chế độ quyền được chọn bên dưới vùng soạn thảo. Hãy chọn chế độ quyền cho lượt cha trước khi yêu cầu Codex giao việc.

Bạn cũng có thể ghi đè cấu hình sandbox cho từng tác nhân tùy chỉnh, chẳng hạn như đánh dấu rõ một tác nhân chỉ được làm việc ở chế độ chỉ đọc.

Tác nhân tùy chỉnh

Codex đi kèm các tác nhân tích hợp sẵn:

• default: tác nhân dự phòng đa dụng.
• worker: tác nhân tập trung vào thực thi để triển khai và sửa lỗi.
• explorer: tác nhân khám phá cơ sở mã thiên về đọc.

Để xác định tác nhân tùy chỉnh của riêng bạn, hãy thêm các tệp TOML độc lập trong ~/.codex/agents/ cho tác nhân cá nhân hoặc .codex/agents/ cho tác nhân thuộc phạm vi dự án.

Mỗi tệp xác định một tác nhân tùy chỉnh. Codex tải các tệp này dưới dạng lớp cấu hình cho các phiên được khởi tạo, vì vậy tác nhân tùy chỉnh có thể ghi đè những thiết lập tương tự như cấu hình của một phiên Codex thông thường. Cách này có thể tạo cảm giác nặng nề hơn một tệp kê khai tác nhân chuyên dụng và định dạng có thể phát triển khi việc biên soạn và chia sẻ hoàn thiện hơn.

Mỗi tệp tác nhân tùy chỉnh độc lập phải xác định:

• name
• description
• developer_instructions

Nếu tệp tác nhân tùy chỉnh đặt model hoặc model_reasoning_effort, giá trị trong tệp sẽ được ưu tiên. Nếu không, Codex phân giải từng thiết lập độc lập: giá trị khởi tạo tường minh, sau đó là giá trị mặc định [agents] tương ứng, rồi đến giá trị của tác nhân cha. Nếu lượt khởi tạo chọn mô hình khác và không có mức nỗ lực tường minh hay được cấu hình, Codex sử dụng mức nỗ lực mặc định của mô hình đó. Các thiết lập phiên khác như sandbox_mode, mcp_servers và skills.config sẽ kế thừa từ tác nhân cha khi tệp tác nhân tùy chỉnh không chỉ định chúng.

Thiết lập toàn cục

Các thiết lập tác nhân phụ toàn cục vẫn nằm trong [agents] thuộc cấu hình của bạn.

Lưu ý:

• agents.enabled mặc định là true. Đặt thành false để tắt công cụ đa tác nhân.
• Khi bạn không đặt agents.max_concurrent_threads_per_session, Codex sẽ chọn giá trị mặc định. Các cấu hình hiện có vẫn có thể sử dụng agents.max_threads làm bí danh cũ.
• Giá trị khởi tạo tường minh ghi đè agents.default_subagent_model và agents.default_subagent_reasoning_effort.
• agents.interrupt_message mặc định là true. Đặt thành false để loại bỏ thông báo gián đoạn mà mô hình có thể thấy khỏi ngữ cảnh của tác nhân.
• Nếu tên tác nhân tùy chỉnh trùng với tác nhân tích hợp như explorer, tác nhân tùy chỉnh của bạn sẽ được ưu tiên.

Lược đồ tệp tác nhân tùy chỉnh

Bạn cũng có thể đưa các khóa config.toml được hỗ trợ khác vào tệp tác nhân tùy chỉnh, chẳng hạn như model, model_reasoning_effort, sandbox_mode, mcp_servers và skills.config.

Codex nhận diện tác nhân tùy chỉnh qua trường name. Đặt tên tệp trùng với tên tác nhân là quy ước đơn giản nhất, nhưng trường name mới là nguồn thông tin chính xác.

Ví dụ về tác nhân tùy chỉnh

Các tác nhân tùy chỉnh tốt nhất có phạm vi hẹp và quan điểm rõ ràng. Hãy giao cho mỗi tác nhân một công việc cụ thể, một phạm vi công cụ phù hợp với công việc đó và các hướng dẫn giúp tác nhân không chuyển sang công việc lân cận.

Ví dụ 1: Đánh giá PR

Mẫu này chia việc đánh giá cho ba tác nhân tùy chỉnh chuyên biệt:

• pr_explorer lập bản đồ cơ sở mã và thu thập bằng chứng.
• reviewer tìm kiếm rủi ro về tính đúng đắn, bảo mật và kiểm thử.
• docs_researcher kiểm tra tài liệu framework hoặc API thông qua một máy chủ MCP chuyên dụng.

Cấu hình dự án (.codex/config.toml):

[agents]
max_concurrent_threads_per_session = 8

.codex/agents/pr-explorer.toml:

name = "pr_explorer"
description = "Read-only codebase explorer for gathering evidence before changes are proposed."
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"
developer_instructions = """
Stay in exploration mode.
Trace the real execution path, cite files and symbols, and avoid proposing fixes unless the parent agent asks for them.
Prefer fast search and targeted file reads over broad scans.
"""

.codex/agents/reviewer.toml:

name = "reviewer"
description = "PR reviewer focused on correctness, security, and missing tests."
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
sandbox_mode = "read-only"
developer_instructions = """
Review code like an owner.
Prioritize correctness, security, behavior regressions, and missing test coverage.
Lead with concrete findings, include reproduction steps when possible, and avoid style-only comments unless they hide a real bug.
"""

.codex/agents/docs-researcher.toml:

name = "docs_researcher"
description = "Documentation specialist that uses the docs MCP server to verify APIs and framework behavior."
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"
developer_instructions = """
Use the docs MCP server to confirm APIs, options, and version-specific behavior.
Return concise answers with links or exact references when available.
Do not make code changes.
"""

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

Thiết lập này phù hợp với các prompt như:

Review this branch against main. Have pr_explorer map the affected code paths, reviewer find real risks, and docs_researcher verify the framework APIs that the patch relies on.

Ví dụ 2: Gỡ lỗi tích hợp frontend

Mẫu này hữu ích cho lỗi hồi quy giao diện người dùng, luồng trình duyệt không ổn định hoặc lỗi tích hợp liên quan đến cả mã ứng dụng và sản phẩm đang chạy.

Cấu hình dự án (.codex/config.toml):

[agents]
max_concurrent_threads_per_session = 6

.codex/agents/code-mapper.toml:

name = "code_mapper"
description = "Read-only codebase explorer for locating the relevant frontend and backend code paths."
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"
developer_instructions = """
Map the code that owns the failing UI flow.
Identify entry points, state transitions, and likely files before the worker starts editing.
"""

.codex/agents/browser-debugger.toml:

name = "browser_debugger"
description = "UI debugger that uses browser tooling to reproduce issues and capture evidence."
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
sandbox_mode = "workspace-write"
developer_instructions = """
Reproduce the issue in the browser, capture exact steps, and report what the UI actually does.
Use browser tooling for screenshots, console output, and network evidence.
Do not edit application code.
"""

[mcp_servers.chrome_devtools]
url = "http://localhost:3000/mcp"
startup_timeout_sec = 20

.codex/agents/ui-fixer.toml:

name = "ui_fixer"
description = "Implementation-focused agent for small, targeted fixes after the issue is understood."
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "medium"
developer_instructions = """
Own the fix once the issue is reproduced.
Make the smallest defensible change, keep unrelated files untouched, and validate only the behavior you changed.
"""

[[skills.config]]
path = "/Users/me/.agents/skills/docs-editor/SKILL.md"
enabled = false

Thiết lập này phù hợp với các prompt như:

Investigate why the settings modal fails to save. Have browser_debugger reproduce it, code_mapper trace the responsible code path, and ui_fixer implement the smallest fix once the failure mode is clear.