Bỏ qua đến nội dung chính

Creating a subagent

                        (Show All)_ · **Bài 2/4** · [🌐 English](../../en/02-creating-a-subagent/en.md)

← Bài trước · 📋 Mục lục khoá · Bài sau →

Creating a subagent

👨‍💻 Track: Developer Track · 📚 Course: Introduction to Subagents · 🧭 Path C

📖 Nội dung bài học

Claude Code có sẵn các subagent tích hợp, nhưng bạn cũng có thể tự tạo. Các subagent tùy chỉnh chuyên về các tác vụ cụ thể -- như xem xét mã, viết kiểm thử, hoặc kiểm tra tài liệu. Chúng được định nghĩa dưới dạng các file markdown với YAML frontmatter cho Claude biết khi nào nên dùng subagent và subagent nên hoạt động như thế nào.

Tạo Subagent

Cách dễ nhất để tạo một subagent là dùng lệnh /agents. Việc này sẽ mở giao diện chính để quản lý các subagent của bạn. Từ đó, chọn Create new agent (Tạo agent mới).

Bạn sẽ được yêu cầu chọn phạm vi của subagent:

  • Project-level (Cấp dự án) -- chỉ khả dụng trong dự án hiện tại
  • User-level (Cấp người dùng) -- được chia sẻ trên tất cả các dự án trên máy của bạn

Tiếp theo, bạn có thể chọn cách tạo nó. Bạn có thể viết cấu hình thủ công, nhưng cách được đề xuất là để Claude tự tạo nó cho bạn. Chỉ cần mô tả bạn muốn subagent làm gì, và Claude sẽ tạo ra một tên, mô tả và system prompt dựa trên đầu vào của bạn.

Tùy chỉnh Tools

Trong quá trình tạo, bạn có cơ hội tùy chỉnh các tool mà subagent có thể truy cập. Các danh mục tool bao gồm:

  • Read-only tools (Tool chỉ đọc)
  • Edit tools (Tool chỉnh sửa)
  • Execution tools (Tool thực thi)
  • MCP tools (Tool MCP)
  • Other tools (Tool khác)

Hãy nghĩ về những gì subagent của bạn thực sự cần. Một người xem xét mã có lẽ không cần edit tools -- nó nên đọc và phân tích mã, không thay đổi nó. Tuy nhiên, bạn có thể muốn giữ cho execution tools được bật để nó có thể dễ dàng xác định các thay đổi đang chờ xử lý.

Chọn Model và Màu

Sau khi cấu hình tools, bạn chọn model Claude nào sẽ cung cấp sức mạnh cho subagent. Các tùy chọn của bạn là:

  • Haiku -- tốt nhất cho các tác vụ nhanh, nhẹ
  • Sonnet -- một lựa chọn tốt giữa tốc độ và độ sâu
  • Opus -- tốt nhất để phân tích phức tạp
  • Inherit -- dùng bất kỳ model nào mà cuộc trò chuyện chính của bạn đang chạy

Cuối cùng, bạn chọn một màu. Điều này hiển thị trong UI để bạn có thể nhanh chóng biết subagent nào đang hoạt động. Đó là một chi tiết nhỏ, nhưng nó hữu ích khi bạn có nhiều subagent đang chạy.

File Cấu hình

Sau khi tạo xong, file cấu hình subagent được lưu vào dự án của bạn (thường là ở .claude/agents/your-agent-name.md). Đây là giao diện của một cấu hình subagent điển hình:

---
name: code-quality-reviewer
description: Use this agent when you need to review recently written or modified code for quality, security, and best practice compliance.
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch
model: sonnet
color: purple
---

You are an expert code reviewer specializing in quality assurance, security best practices, and
adherence to project standards. Your role is to thoroughly examine recently written or modified code
and identify issues that could impact reliability, security, maintainability, or performance.

Hãy xem xét từng trường:

  • name -- Một định danh duy nhất cho subagent. Đây là cách bạn tham chiếu nó, bằng cách hỏi Claude trực tiếp hoặc bằng cách gõ @agent code-quality-reviewer trong tin nhắn của bạn.
  • description -- Kiểm soát khi nào Claude quyết định dùng subagent. Trường này phải là một dòng duy nhất (dùng các ký tự xuống dòng đã thoát \n nếu bạn cần ngắt dòng). Bạn có thể bao gồm các cuộc trò chuyện ví dụ ở đây để giúp Claude hiểu khi nào việc ủy quyền là phù hợp.
  • tools -- Liệt kê các tool mà subagent có thể truy cập. Điều này khớp với bất kỳ thứ gì bạn đã chọn trong quá trình tạo, nhưng bạn có thể chỉnh sửa danh sách ở đây bất kỳ lúc nào.
  • model -- Chỉ định model Claude nào sẽ dùng: sonnet, opus, haiku, hoặc inherit.
  • color -- Màu UI để nhận dạng subagent.

System Prompts

Phần nội dung của file markdown (mọi thứ bên dưới YAML frontmatter) là system prompt. Đây là nơi bạn đưa ra các hướng dẫn cho subagent: nó nên tập trung vào điều gì, nó nên phân tích mọi thứ như thế nào và nó nên báo cáo kết quả trở lại agent chính như thế nào.

Một system prompt được viết tốt là sự khác biệt giữa một subagent hữu ích và một subagent bỏ lỡ vấn đề. Hãy cụ thể về những gì subagent nên tìm kiếm và cách nó nên cấu trúc đầu ra của nó.

Khiến Claude Tự động Dùng Subagent của Bạn

Nếu bạn muốn Claude ủy quyền các tác vụ cho subagent mà không cần bạn hỏi một cách rõ ràng, hãy bao gồm từ "proactively" (chủ động) trong trường description. Ví dụ:

description: Proactively suggest running this agent after major code changes...

Bạn cũng có thể thêm các cuộc trò chuyện ví dụ vào phần mô tả để giúp Claude hiểu các tình huống cụ thể mà subagent nên được dùng. Các ví dụ của bạn càng cụ thể, Claude càng hiểu rõ khi nào nên ủy quyền.

Kiểm thử Subagent của Bạn

Sau khi tạo subagent của bạn, hãy kiểm thử nó bằng cách thực hiện một số thay đổi mã và yêu cầu Claude xem xét chúng.

Nếu subagent không được dùng như bạn mong đợi, hãy quay lại và kiểm tra phần description. Việc thêm nhiều ví dụ và tình huống kích hoạt cụ thể hơn sẽ giúp Claude hiểu khi nào nên ủy quyền công việc cho subagent của bạn.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?