Creating a subagent

• Tác nhân phụ tùy chỉnh trong Claude Code được tạo dưới dạng tệp Markdown kèm cấu hình YAML, cho phép chuyên biệt hóa các tác vụ cụ thể như đánh giá mã.
• Việc tạo tác nhân phụ được thực hiện dễ dàng qua lệnh /agents, với khả năng tùy chỉnh tên, mô tả, quyền truy cập công cụ và mô hình Claude sử dụng.
• Hiệu quả của tác nhân phụ phụ thuộc vào một description rõ ràng để Claude biết khi nào nên ủy quyền, cùng với một lời nhắc hệ thống chi tiết hướng dẫn tác nhân thực hiện nhiệm vụ và tương tác.

• Tạo tác nhân phụ tùy chỉnh bằng cách sử dụng tệp Markdown có YAML front matter để chứa cấu hình và hướng dẫn cho cả Claude và chính tác nhân.
• Sử dụng lệnh /agents trong bảng điều khiển để khởi tạo tác nhân phụ, tận dụng tính năng tự động tạo của Claude Code để thiết lập cấu trúc cơ bản.
• Tùy chỉnh quyền truy cập công cụ cho tác nhân phụ (ví dụ: cho phép thực thi nhưng có thể hạn chế chỉnh sửa cho một người đánh giá mã) và chọn mô hình Claude phù hợp với yêu cầu tác vụ (Haiku cho tốc độ, Opus cho phức tạp, Sonnet cho cân bằng).
• Tối ưu hóa trường description của tác nhân phụ bằng cách thêm từ khóa như proactively hoặc các cuộc hội thoại ví dụ để kiểm soát tần suất và ngữ cảnh Claude tự động gọi tác nhân.
• Viết lời nhắc hệ thống rõ ràng và chi tiết trong nội dung tệp Markdown để cung cấp hướng dẫn cho tác nhân phụ về cách hoàn thành nhiệm vụ và tương tác hiệu quả với tác nhân chính.
• Kiểm tra tác nhân phụ sau khi tạo bằng cách yêu cầu Claude thực hiện tác vụ và điều chỉnh description cùng thêm các ví dụ cụ thể nếu tác nhân không được sử dụng như mong đợi để cải thiện khả năng ủy quyền.

• sub agent — tác nhân phụ
• YAML front matter — YAML front matter
• system prompt — lời nhắc hệ thống
• code reviewer — người đánh giá mã
• code quality — chất lượng mã
• security issues — vấn đề bảo mật
• tools — công cụ
• execute — thực thi
• model — mô hình
• main agent — tác nhân chính

Tổng quan về Tác nhân phụ

Trong video trước, chúng ta đã tìm hiểu về tác nhân phụ (sub agents) là gì và cách chúng hoạt động. Claude Code bao gồm các tác nhân phụ tích hợp sẵn, nhưng bạn cũng có thể tự tạo tác nhân phụ của riêng mình chuyên về các tác vụ nhất định.

Tạo Tác nhân phụ Tùy chỉnh

Các tác nhân phụ tùy chỉnh là các tệp Markdown với phần YAML front matter. Các tệp Markdown này chứa cấu hình giúp Claude hiểu khi nào nên sử dụng tác nhân phụ và cung cấp hướng dẫn cho chính tác nhân phụ đó.

Cách dễ nhất để tạo một tác nhân phụ là sử dụng lệnh / agents. Bảng điều khiển này là giao diện chính để quản lý các tác nhân phụ của bạn. Tại đây, hãy chọn create new agent. Sau đó, bạn sẽ được hỏi liệu bạn muốn tạo một tác nhân phụ cho dự án hiện tại hay một tác nhân phụ sẽ được chia sẻ giữa tất cả các dự án trên máy của bạn. Tiếp theo, bạn có thể tạo một tác nhân phụ theo cách thủ công, nhưng chúng tôi khuyên bạn nên sử dụng Claude Code để tự động tạo nó cho bạn.

Tác nhân phụ đầu tiên của chúng tôi sẽ là một code reviewer (người đánh giá mã). Tôi sẽ yêu cầu Claude tạo một tác nhân phụ đánh giá chất lượng mã (code quality) và các vấn đề bảo mật (security issues). Claude sẽ sử dụng thông tin đầu vào của bạn để tạo tên, mô tả và lời nhắc hệ thống (system prompt) cho tác nhân phụ.

Trước khi xem các thông tin đó, chúng ta có cơ hội tùy chỉnh các công cụ mà tác nhân phụ này có quyền truy cập. Hiện tại, vì tác nhân phụ của chúng tôi chỉ chịu trách nhiệm đánh giá mã, bạn có thể quyết định không cho phép các công cụ chỉnh sửa, nhưng tôi sẽ cho phép thực thi để tác nhân phụ dễ dàng xác định các thay đổi đang chờ xử lý hơn.

Tiếp theo, bạn sẽ được nhắc chọn mô hình cung cấp sức mạnh cho tác nhân phụ này. Và cuối cùng, một màu sắc. Màu này được sử dụng trong giao diện người dùng (UI) để giúp bạn nhận diện tác nhân phụ tốt hơn, đồng thời cũng thêm một chút phong cách cá nhân (personal flair).

Cấu hình Tác nhân phụ

Tại cửa sổ tóm tắt, chúng ta thấy rằng tệp cấu hình (config file) của tác nhân phụ sẽ được lưu vào dự án hiện tại của tôi tại đường dẫn này. Bây giờ, hãy mở tệp đó để hiểu rõ hơn về cách nó hoạt động.

• Trường name: Là một định danh duy nhất. Đây là cách bạn tham chiếu tác nhân phụ, bằng cách hỏi trực tiếp Claude hoặc sử dụng @agent code quality reviewer trong tin nhắn của bạn.
• Trường description: Kiểm soát thời điểm Claude quyết định sử dụng tác nhân phụ. Description phải nằm trên một dòng duy nhất. Lưu ý rằng có các ký tự xuống dòng đã được thoát (escaped new line characters) trong đó. Nếu bạn muốn Claude sử dụng tác nhân phụ tự động thường xuyên hơn, hãy thêm từ proactively vào description. Bạn cũng có thể thêm các cuộc hội thoại ví dụ để giúp Claude hiểu khi nào nên sử dụng tác nhân phụ.
• Trường công cụ: Liệt kê các công cụ mà tác nhân phụ có thể truy cập. Danh sách công cụ sẽ khớp với các công cụ mà chúng ta đã cấp quyền truy cập trong quá trình tạo tác nhân (agent generation), nhưng bạn có thể chỉnh sửa thêm danh sách công cụ trong tệp này nếu muốn.
• Trường model: Chỉ định mô hình Claude nào sẽ sử dụng: Sonnet, Opus, Haiku hoặc inherit. Sử dụng Haiku cho các tác vụ nhanh, Opus cho phân tích phức tạp và Sonnet nếu bạn cần một cái gì đó ở giữa. Inherit sẽ sử dụng cùng một mô hình với cuộc hội thoại chính của bạn.

Nội dung của tệp chứa lời nhắc hệ thống (system prompt) được cung cấp cho tác nhân phụ. Lời nhắc hệ thống sẽ cung cấp hướng dẫn cho tác nhân phụ, giúp nó hiểu cách hoàn thành tác vụ của mình và cách nó nên trả lại thông tin cho tác nhân chính (main agent).

Kiểm tra và Tối ưu Tác nhân phụ

Bây giờ đến phần thú vị. Sau khi tạo tác nhân phụ của bạn, hãy kiểm tra nó bằng cách thực hiện một số thay đổi mã (code changes) và yêu cầu Claude đánh giá chúng. Nếu tác nhân phụ không được sử dụng khi bạn mong đợi, hãy kiểm tra description của bạn. Việc thêm các ví dụ cụ thể hơn giúp Claude hiểu khi nào nên ủy quyền.