Toàn bộ quy trinh và cấu trúc để tạo bộ skill mới
1. Mục đích
Phần này minh họa cách xây dựng một AI Skill chuyên biệt để hỗ trợ phát triển và vận hành hệ thống WSO2 Micro Integrator (WSO2 MI).
Skill này đóng vai trò như một kho tri thức (Knowledge Base) giúp AI Agent có thể:
-
Hướng dẫn viết Synapse XML
-
Áp dụng best practices khi xây dựng integration
-
Phát hiện anti-patterns
-
Hỗ trợ xử lý lỗi trong WSO2 MI
Toàn bộ tri thức được tổ chức trong thư mục:
.agent/skills/wso2-mi/2. Cấu trúc Skill
Thư mục wso2-mi được tổ chức theo từng chủ đề của WSO2 MI.
.agent/
├── skills/
│ └── wso2-mi/
│ ├── SKILL.md
│ ├── mediators.md
│ ├── sequences.md
│ ├── apis.md
│ ├── endpoints.md
│ ├── error-handling.md
│ ├── connectors.md
│ ├── data-services.md
│ └── references/Ý nghĩa các file:
| File | Mô tả |
|---|---|
| SKILL.md | File điều hướng tri thức cho AI |
| mediators.md | Hướng dẫn sử dụng các mediator |
| sequences.md | Thiết kế và sử dụng sequence |
| apis.md | Cách xây dựng REST API |
| endpoints.md | Cấu hình endpoint |
| error-handling.md | Cơ chế xử lý lỗi |
| connectors.md | Hướng dẫn sử dụng connector |
| data-services.md | Hướng dẫn Data Service (.dbs) |
| references | Chứa tài liệu nghiệp vụ riêng |
3. Agent chuyên biệt cho WSO2 MI
Một AI Agent chuyên biệt được tạo để xử lý các câu hỏi liên quan đến WSO2 MI.
Vị trí file:
.agent/agents/wso2-mi-specialist.mdAgent này có các đặc điểm:
-
Ưu tiên sử dụng skill
wso2-mi -
Tập trung hỗ trợ WSO2 Micro Integrator
-
Áp dụng các quy tắc thiết kế integration
Ví dụ quy tắc của agent:
-
Ưu tiên sử dụng XML mediator chuẩn
-
Hạn chế viết Script hoặc Java custom
-
Thiết kế integration theo hướng dễ bảo trì và dễ mở rộng
4. Tích hợp vào kiến trúc hệ thống AI
Để các Agent khác trong hệ thống có thể sử dụng skill này, cần đăng ký skill trong file kiến trúc chung:
.agent/ARCHITECTURE.mdSkill wso2-mi được thêm vào phần:
Backend & APIViệc này cho phép:
-
Các agent khác nhận biết hệ thống đã có chuyên gia WSO2
-
Orchestrator Agent có thể tự động gọi agent này khi cần hỗ trợ integration.
5. Cách sử dụng Agent
Trong quá trình làm việc, khi cần hỗ trợ về WSO2 MI, có thể gọi agent chuyên biệt:
@wso2-mi-specialistKhi được gọi, Agent sẽ:
-
Tự động truy cập thư mục:
.agent/skills/wso2-mi/-
Tìm kiếm thông tin trong các tài liệu liên quan
-
Trả lời và hướng dẫn viết Synapse XML chuẩn cho hệ thống.
Agent này được thiết kế để hỗ trợ phát triển các integration trong dự án TTHC_service.