Nhảy đến nội dung chính

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.md

Agent 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.md

Skill wso2-mi được thêm vào phần:

Backend & API

Việ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-specialist

Khi được gọi, Agent sẽ:

  1. Tự động truy cập thư mục:

.agent/skills/wso2-mi/

  1. Tìm kiếm thông tin trong các tài liệu liên quan

  2. 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.