2.1 Design effective tool interfaces with clear descriptions and boundaries

Viết mô tả tool đủ rõ để Claude phân biệt các tool giống nhau — đây là "bước đầu tiên" khi agent chọn nhầm tool.

1. Mô tả tool là cơ chế chính Claude dùng để chọn tool. Mô tả sơ sài → chọn sai giữa các tool tương tự.
2. Hai tool mô tả gần giống nhau (analyze_content vs analyze_document) → đổi tên và viết lại mô tả cho rõ ranh giới, hoặc tách tool chung chung thành các tool chuyên biệt.
3. Mô tả nên có định dạng input, ví dụ truy vấn, ca biên, và khi nào dùng tool khác thay vì tool này.
4. Kiểm tra cả system prompt: câu chữ chứa từ khóa ("luôn phân tích nội dung…") có thể kéo Claude về một tool sai, lấn át mô tả tool đã viết tốt.