Tác nhân phụ

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.

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.

Trong ChatGPT Work, hãy yêu cầu ChatGPT giao các công việc độc lập cho tác nhân phụ. Các tác nhân chạy trong môi trường do ChatGPT lưu trữ, và cuộc trò chuyện hiển thị hoạt động cùng kết quả của chúng. Ở hầu hết các mức trí thông minh, 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 có thể cải thiện đáng kể tốc độ hoặc chất lượng.

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.

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 các hướng dẫn AGENTS.md hoặc kỹ năng có liên quan yêu cầu giao việc. Dùng /subagents để kiểm tra và chuyển đổi giữa các luồng tác nhân khi chúng đang chạy. Luồng chính tổng hợp kết quả của các tác nhân phụ vào phản hồi cuối cùng.

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

Ở hầu hết các mức trí thông minh, hãy yêu cầu trực tiếp việc sử dụng tác nhân phụ hoặc cho các tác nhân làm việc song song. Ultra cho phép chủ động giao việc, nên 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.

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

Nếu bạn không cấu hình mô hình cho tác nhân phụ hoặc model_reasoning_effort, thì tác nhân phụ sẽ kế thừa mô hình và mức nỗ lực suy luận của tác nhân cha. Nếu một yêu cầu tạo tác nhân rõ ràng hoặc giá trị mặc định trong [agents] chọn một mô hình mà không có mức nỗ lực suy luận được chỉ định rõ hoặc được cấu hình, tác nhân phụ sẽ dùng mức nỗ lực suy luận mặc định của mô hình đó. Để cân bằng trí thông minh, tốc độ và chi phí cho từng tác vụ, hãy yêu cầu một mô hình hoặc mức nỗ lực suy luận cụ thể trong lời nhắc, cấu hình các giá trị mặc định của [agents] trong config.toml, hoặc đặt model và model_reasoning_effort trực tiếp trong tệp tác nhân tùy chỉnh. Ví dụ: dùng gpt-6-luna để rà soát nhanh hoặc cấu hình gpt-6.1-sol với mức nỗ lực cao hơn cho công việc đòi hỏi suy luận sâu hơn.

Lựa chọn mô hình

• gpt-6.1-sol: Bắt đầu với lựa chọn này cho các tác nhân xử lý công việc khó. Dùng cho công việc chưa rõ ràng, gồm nhiều bước, cần lập kế hoạch, sử dụng công cụ, kiểm chứng và theo sát đến khi hoàn tất trong ngữ cảnh lớn hơn.
• gpt-6-luna: 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 được hoặc có khối lượng lớn.

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

Với GPT-6.1 Sol, hãy dùng mức nỗ lực suy luận được ứng dụng khách và mô hình đã chọn hỗ trợ. Khi thiết lập mô hình cụ thể, hãy bắt đầu với high cho GPT-6 Luna hoặc low cho GPT-6 Astra. Điều chỉnh theo tác vụ bằng một mức mà mô hình đã chọn hỗ trợ.

• ultra: Dùng để suy luận sâu nhất khi mô hình đã chọn hỗ trợ mức này.
• max và xhigh: Dùng cho công việc đòi hỏi suy luận đặc biệt sâu khi mô hình đã chọn hỗ trợ các mức này.
• high: Dùng khi tác nhân cần lần theo logic phức tạp, kiểm tra các giả định hoặc xử lý các trường hợp biên (ví dụ: tác nhân rà soát hoặc tác nhân tập trung vào bảo mật).
• medium: Cân bằng tốc độ và chiều sâu.
• low: 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.

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

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.

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

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

Danh sách kiểm tra báo cáoDanh sách kiểm tra bài thuyết trìnhđã bắt đầu làm việc

Đang hoạt độngKhông có tác nhân phụ nào đang hoạt động

Đã xong · 3

Kiểm tra API mô hìnhĐã kiểm tra xong; không phát hiện vấn đề tương thích nào với điểm cuối.

2 phút

Kiểm tra góiQuy trình an toàn nhất là cập nhật có chọn lọc các phần phụ thuộc.

3 phút

Kiểm tra trang đíchĐã kiểm tra xong; không còn vấn đề nào cản trở việc hoàn thiện bố cục.

4 phút

• Dùng /subagents 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 điều chỉnh hướng xử lý của 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 tất.

• Khi có bảng tác nhân chạy nền, hãy mở rộng bảng để kiểm tra trạng thái, dừng các 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 điều chỉnh hướng xử lý của 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 tất.

Tác nhân phụ kế thừa chính sách môi trường cô lập hiện tại của bạn.

ChatGPT Work chạy các tác nhân phụ trong môi trường do mình lưu trữ và không cung cấp môi trường cô lập Codex cục bộ hay tùy chọn điều khiển chế độ phê duyệt. Tác nhân phụ sử dụng các công cụ có sẵn trong cuộc trò chuyện cha. Quyền đối với trang web và trình kết nối vẫn được quy định riêng cho từng công cụ.

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.

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.

Các tác nhân phụ kế thừa thiết lập môi trường cô lập và phê duyệt hiện tại của lượt cha, bao gồm các thay đổi được thực hiện bằng /permissions hoặc --yolo. Tệp tác nhân tùy chỉnh không thể thay thế các thiết lập đó.

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

Thiết lập các biện pháp kiểm soát môi trường cô lập và phê duyệt trong phiên cha. Chỉ dẫn cho tác nhân tùy chỉnh có thể yêu cầu tác nhân tránh chỉnh sửa, nhưng không tạo ra một môi trường cô lập chỉ đọc riêng biệt.

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 định nghĩa một tác nhân tùy chỉnh. Tác nhân tùy chỉnh có thể thay đổi cài đặt mô hình và chỉ dẫn hoặc vô hiệu hóa các khả năng được hỗ trợ. Chúng kế thừa quyền, nhà cung cấp và MCP server của phiên cha; tệp tác nhân tùy chỉnh không thể ghi đè các cài đặt đó.

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. Trước khi áp dụng tệp, Codex xác định từng cài đặt từ giá trị được chỉ định rõ khi khởi tạo, rồi đến giá trị mặc định [agents] tương ứng, sau đó đến giá trị của phiên cha. Nếu yêu cầu khởi tạo tường minh hoặc giá trị mặc định [agents] chọn một mô hình nhưng cả hai đều không cung cấp mức độ suy luận, Codex dùng mức độ mặc định của mô hình đó. Tệp tác nhân tùy chỉnh chỉ đặt model sẽ giữ nguyên mức độ đã được xác định trước đó. Hãy đặt cả model_reasoning_effort trong tệp nếu mô hình đã chọn không hỗ trợ mức độ đó hoặc bạn muốn dùng mức độ khác. Các kỹ năng được kế thừa từ phiên cha và tác nhân tùy chỉnh có thể vô hiệu hóa từng kỹ năng bằng skills.config.

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

Dùng model, model_reasoning_effort, model_reasoning_summary và model_verbosity để tùy chỉnh hành vi của mô hình. Xem tài liệu tham khảo cấu hình để biết các giá trị được chấp nhận.

Để giới hạn khả năng của tác nhân tùy chỉnh, hãy đặt các khóa tính năng được hỗ trợ thành false: features.shell_tool, features.apps, features.plugins, features.memories hoặc features.request_permissions_tool. Vô hiệu hóa từng kỹ năng bằng skills.config hoặc các kỹ năng đi kèm bằng skills.bundled.enabled = false. Đặt skills.include_instructions = false để bỏ khối chỉ dẫn kỹ năng tự động. Các yêu cầu do quản trị viên quản lý vẫn áp dụng.

Các cài đặt phiên khác, bao gồm sandbox_mode, approval_policy, model_provider và mcp_servers, không ghi đè cấu hình của phiên cha khi được đặt trong tệp tác nhân tùy chỉnh. Cấp dịch vụ cũng tuân theo tùy chọn của phiên gốc. Hãy cấu hình MCP server trong phiên cha để tác nhân có thể sử dụng chúng.

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.

Các ví dụ dùng GPT-6.1 Sol khi tài khoản đang đăng nhập hoặc không gian làm việc của bạn có quyền truy cập. Nếu mô hình này không khả dụng, hãy chọn một mô hình bạn có thể sử dụng.

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 MCP server chuyên dụng.

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

[agents]
max_concurrent_threads_per_session = 8

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

.codex/agents/pr-explorer.toml:

name = "pr_explorer"
description = "Read-only codebase explorer for gathering evidence before changes are proposed."
model = "gpt-6-luna"
model_reasoning_effort = "high"
developer_instructions = """
Stay in exploration mode.
Do not edit files.
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-6.1-sol"
model_reasoning_effort = "medium"
developer_instructions = """
Review code like an owner.
Do not edit files.
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-6-luna"
model_reasoning_effort = "high"
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.
"""

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

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

.codex/agents/code-mapper.toml:

name = "code_mapper"
description = "Read-only codebase explorer for locating the relevant frontend and backend code paths."
model = "gpt-6-luna"
model_reasoning_effort = "high"
developer_instructions = """
Map the code that owns the failing UI flow.
Do not edit files.
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-6.1-sol"
model_reasoning_effort = "medium"
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.
"""

.codex/agents/ui-fixer.toml:

name = "ui_fixer"
description = "Implementation-focused agent for small, targeted fixes after the issue is understood."
model = "gpt-6-luna"
model_reasoning_effort = "high"
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.