Kỹ năng tác tử Ultralytics#
Kỹ năng tác tử Ultralytics cung cấp hướng dẫn và tài liệu tham khảo cho các AI coding agent tương thích khi làm việc với package Python ultralytics, CLI yolo và Ultralytics Platform, bao gồm tự động hóa bằng ul cloud. Các kỹ năng này tuân theo định dạng mở Agent Skills và được tải khi có yêu cầu thực hiện tác vụ liên quan.
Cách hoạt động của Skills#
Skill định tuyến yolo ánh xạ yêu cầu đến giai đoạn vòng đời tương ứng, còn mỗi skill theo giai đoạn hướng dẫn cả hai quy trình: cách nhanh nhất trên Ultralytics Platform, sau đó là quy trình Python và CLI cục bộ. Các thông tin phụ thuộc phiên bản như tên weight, tham số huấn luyện và định dạng export được lưu trong các danh mục dựa trên bản phát hành ultralytics đã được cố định; mọi skill đều hướng dẫn agent ưu tiên gói đã cài đặt (yolo checks, yolo cfg và thông báo lỗi) khi có khác biệt. Thay vào đó, skill platform-cli dựa vào phần trợ giúp CLI ul của bản đã cài đặt và Platform API đang hoạt động. Ask AI của Platform cũng sử dụng skill platform-cli này.
Các kỹ năng hiện có#
Repository chứa một kỹ năng điều phối, sáu kỹ năng theo vòng đời và một kỹ năng Platform CLI:
| Kỹ năng | Dùng cho |
|---|---|
yolo | Cách sử dụng Python và CLI cơ bản, quy trình làm việc với Platform và điều phối đến các kỹ năng khác |
yolo-models | Lựa chọn họ model, kích thước, tác vụ và weights |
yolo-datasets | Chuẩn bị, chuyển đổi, xác thực và khắc phục sự cố dataset |
yolo-training | Huấn luyện, xác thực, tiếp tục huấn luyện, sử dụng nhiều GPU và khắc phục sự cố |
yolo-tuning | Tinh chỉnh siêu tham số và cải thiện thử nghiệm |
yolo-inference | Dự đoán, kết quả, tracking và Solutions |
yolo-export | Export, lượng tử hóa, định dạng triển khai và benchmark |
platform-cli | Tự động hóa Ultralytics Platform bằng ul cloud: tài nguyên, tải lên, huấn luyện trên cloud, export và triển khai |
Cài đặt#
claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralyticsĐể cập nhật, hãy chạy claude plugin update yolo@ultralytics rồi khởi động lại Claude Code.
Mỗi phiên bản của plugin được phát hành dưới dạng bản phát hành GitHub kèm ghi chú phát hành.
Kết nối Platform CLI#
Skill platform-cli sử dụng CLI ul (Python 3.11+), được tích hợp trong pip install ultralytics hoặc SDK độc lập (pip install ultralytics-platform). Tạo Platform API key, cung cấp khóa này cho agent của bạn, rồi kiểm tra kết nối:
export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summaryPrompt mẫu#
Sau khi cài đặt, hãy đưa ra yêu cầu tự nhiên cho agent. Bộ định tuyến yolo sẽ chọn hướng dẫn phù hợp:
| Mục tiêu | Prompt ví dụ |
|---|---|
| Thử YOLO | "Chạy YOLO trên một ảnh mẫu và cho tôi xem các đối tượng được phát hiện." |
| Huấn luyện | "Chuyển ảnh của tôi thành một model YOLO tùy chỉnh, được gán nhãn và huấn luyện trên Ultralytics Platform." |
| Cải thiện | "mAP của model của tôi đã chững lại. Hãy chẩn đoán lần chạy và đề xuất thử nghiệm tiếp theo." |
| Triển khai | "Export model YOLO đã huấn luyện của tôi sang TensorRT với lượng tử hóa INT8 và benchmark model đó." |
| Phân tích video | "Đếm số ô tô đi qua một vạch trong traffic.mp4 và lưu video có chú thích." |
| Tự động hóa Platform | "Liệt kê các dataset Ultralytics Platform của tôi và bắt đầu huấn luyện trên đám mây với dataset PPE." |
Xem repository ultralytics/skills để biết lệnh cài đặt hiện hành, file nguồn, nội dung cập nhật và cách báo cáo vấn đề.
Câu hỏi thường gặp#
Đây là các hướng dẫn và tài liệu tham khảo có thể tái sử dụng, giúp AI coding agent làm việc với Ultralytics Platform, package Python
ultralytics, CLIyolovà Platform CLIul.Repository cung cấp plugin cho Claude Code và Codex. Cursor, Gemini CLI và các agent khác có thể đọc định dạng mở Agent Skills, cài đặt trực tiếp các thư mục kỹ năng hoặc cài đặt thông qua skills CLI.
Cài đặt plugin đầy đủ để tự động điều phối các hoạt động trong vòng đời computer vision và thao tác Platform CLI. Để cài đặt một kỹ năng bằng skills CLI, hãy truyền tên kỹ năng bằng
--skill, chẳng hạn--skill yolo-traininghoặc--skill platform-cli.Bản thân plugin chỉ chứa hướng dẫn nên không có gì chạy khi plugin được tải. Các lệnh agent chạy theo hướng dẫn của skill có thể tải xuống package, weight và dataset; các lệnh
ul cloudtải những tệp bạn chỉ định lên Ultralytics Platform bằng API key của bạn. Packageultralyticscũng gửi dữ liệu phân tích sử dụng ẩn danh;yolo settings sync=Falsesẽ tắt tính năng này.Không. Các kỹ năng định hướng agent đến quy trình làm việc phù hợp, nhưng package đã cài đặt và tài liệu Ultralytics hiện hành vẫn là nguồn thông tin chuẩn khi có khác biệt về hành vi hoặc các tùy chọn được hỗ trợ.
Tạo báo cáo lỗi trong repository
ultralytics/skills, kèm theo prompt bạn đã dùng, hướng dẫn agent đưa ra và kết quả đáng lẽ phải xảy ra.