Skill cho AI agent

Skill GetMyBot là các wrapper agent sẵn sàng trên GetMyBot API. Chúng dạy AI agent (ví dụ: Claude Code) làm việc với bot của bạn bằng ngôn ngữ tự nhiên: "tạo phản ứng trong GetMyBot", "khởi động phát đi GetMyBot theo nhãn VIP", "hiển thị thống kê bot". Bên dưới, skill gọi các công cụ MCP của GetMyBot, và nếu máy chủ MCP không được kết nối — thực hiện các yêu cầu tương tự qua REST với token của bạn.

Skill không phải tính năng trả phí riêng và không phải marketplace. Đây là các tệp SKILL.md (định dạng Claude Code) mà bạn cài đặt cục bộ bên cạnh agent của mình.

Cách hoạt động

Mỗi skill được tổ chức theo nguyên tắc tiết lộ dần dần: mô tả ngắn kích hoạt skill theo các từ ngữ liên quan đến domain, còn tài liệu tham khảo API nặng chỉ được tải khi cần. Bên trong mỗi skill có tài liệu về hai con đường truy cập:

  • MCP (ưu tiên) — nếu máy chủ MCP GetMyBot được kết nối với agent, skill gọi các công cụ trực tiếp.
  • REST-fallback — nếu MCP không có sẵn, skill thực hiện các thao tác tương tự bằng các yêu cầu curl với token cá nhân.

Xác thực trong tất cả skill là một: token cá nhân mbp_… và địa chỉ cơ sở /api. Xem chi tiết — trong hướng dẫn xác thực.

Sáu skill

  • mybot — điểm vào và điều hướng: GetMyBot API là gì, cách lấy PAT và phạm vi của nó, địa chỉ cơ sở, cách kết nối máy chủ MCP, khi nào dùng REST, khi nào dùng MCP, định dạng lỗi, phân trang và giới hạn. Từ đây agent đi vào năm skill còn lại.
  • mybot-bots — kết nối và quản lý bot: kiểm tra token, kết nối, danh sách và thẻ, cập nhật, đồng bộ, đổi token, chuyển giao, xóa, cài đặt, template.
  • mybot-reactions — trình tạo phản ứng (lớn nhất): cấu trúc "trình kích hoạt → điều kiện → cuộc trò chuyện → hành động", tạo và cập nhật, loại trình kích hoạt, điều kiện AND/OR, danh mục hành động, tin nhắn và nút, nút động và tham số, công thức (DSL), thư mục, liên kết phản ứng, import từ SamBot, kiểm tra công thức, thứ tự.
  • mybot-broadcasts — phát đi: khởi động theo phản ứng, phân khúc theo nhãn, tạm dừng/tiếp tục/hủy và trạng thái, chỉnh sửa tin nhắn đã gửi (đơn lẻ và "cho tất cả"), hàng đợi và thử lại.
  • mybot-data — dữ liệu và tích hợp: bộ sưu tập (bảng — trường và bản ghi), kịch bản (flows), tích hợp (AI, Google Sheets, GetCourse, xử lý bên ngoài qua WebSocket), kết nối và truy cập.
  • mybot-analytics — quan sát và đối tượng: thống kê (chi tiêu số dư, số liệu, nhật ký, sức khỏe phản ứng), phân tích (đối tượng, cuộc trò chuyện, phễu), người đăng ký và nhãn, đối thoại, billing (số dư, gói cước, giao dịch).

Cài đặt

Skill nằm trong repository GetMyBot trong thư mục skills/. Mỗi skill là thư mục skills/<name>/ với các tệp SKILL.md (hướng dẫn ngắn) và reference.md (tài liệu tham khảo đầy đủ về domain với ví dụ trên MCP và curl).

Để agent nhìn thấy skill, hãy liên kết chúng với danh mục skill Claude Code của bạn. Trong repository có script sẵn sàng:

./skills/install.sh

Nó tạo symlink ~/.claude/skills/<name> đến các thư mục trong repository — các thay đổi trong repository được agent nhìn thấy ngay, không tạo bản sao thừa. Sau khi cài đặt, hãy diễn đạt nhiệm vụ bằng lời thông thường ("tạo bot tự động trả lời trong GetMyBot"), và agent sẽ tự tải skill cần thiết.

Tiếp theo