Plugin & Kỹ năng

Plugin

Plugin là gì?

Plugin là các mô-đun TypeScript mở rộng chức năng của Neotask trong thời gian chạy. Chúng có thể thêm các kênh nhắn tin mới, công cụ tác nhân, phương thức RPC, lệnh CLI, dịch vụ nền và kỹ năng.

Plugin chính thức

Kênh nhắn tin:

Microsoft Teams, Matrix, Nostr, Zalo, Feishu/Lark, LINE, Nextcloud Talk, Mattermost, Tlon, Twitch

Tính năng:

Cuộc gọi giọng nói, Hỗ trợ điện thoại SIP cho các cuộc gọi giọng nói đến/đi
Bộ nhớ (LanceDB), Bộ nhớ dài hạn với tìm kiếm độ tương tự vector
MCP Native, Tích hợp máy chủ Model Context Protocol để kết nối các công cụ bên ngoài

Nhà cung cấp xác thực:

Google Antigravity OAuth, Gemini CLI OAuth, Qwen OAuth, Minimax OAuth, VS Code Copilot Proxy

Khả năng plugin

Plugin có thể đăng ký:

Phương thức RPC, Các phương thức WebSocket tùy chỉnh để máy khách gọi
Trình xử lý HTTP, Các endpoint HTTP tùy chỉnh trên Gateway
Công cụ tác nhân, Các công cụ mới với lược đồ có kiểu mà tác nhân có thể gọi
Lệnh CLI, Các lệnh dòng lệnh bổ sung
Dịch vụ nền, Các tiến trình chạy lâu dài được Gateway quản lý
Kỹ năng, Các thư mục kỹ năng được đóng gói với plugin
Lệnh tự động trả lời, Các lệnh thực thi mà không cần tác nhân AI tham gia

Bảo mật plugin

Neotask kiểm tra plugin qua nhiều lớp trước khi chúng chạy:

Được ký và xác minh. Các gói trong danh mục Construct công khai do Neotask phát hành, được kiểm tra tự động trước khi phát hành và được ký bằng khóa phát hành của Neotask. Trước khi cài đặt, Neotask kiểm tra chữ ký bằng các khóa tích hợp sẵn trong Neotask và xác minh mã băm SHA-256 của tệp tải xuống.
Không có script cài đặt. Các gói Construct đi kèm sẵn các phụ thuộc, nên việc cài đặt không bao giờ chạy trình quản lý gói hay script cài đặt. Khi một lượt cài đặt plugin khác dùng npm, script cài đặt sẽ bị tắt.
Quét khi cài đặt. Plugin cài đặt từ bên ngoài Construct được quét để tìm mã nguy hiểm, và các phát hiện nghiêm trọng sẽ chặn việc cài đặt.
Giấy phép theo từng bản phát hành. Plugin Construct chỉ được tải khi tài khoản của bạn có quyền còn hiệu lực cho bản phát hành đó. Các bản phát hành đã bị thu hồi sẽ không được tải.
Phê duyệt hành động của agent. Các lệnh gọi công cụ của agent, kể cả công cụ do plugin thêm vào, được kiểm tra theo chính sách phê duyệt của bạn, và những hành động cần bạn đồng ý sẽ chờ bạn duyệt. Phần mềm mà agent muốn cài đặt ngoài các công thức cài đặt đi kèm Neotask luôn hiển thị chính xác lệnh sẽ chạy và chờ bạn phê duyệt.
Sandbox tùy chọn. Bạn có thể chạy công cụ của agent trong một container Docker tách biệt thay vì chạy trực tiếp trên máy tính. Sandbox tắt theo mặc định; xem Bảo mật để bật.

Plugin native chạy bên trong tiến trình Gateway, nên plugin bạn cài đặt từ bên ngoài Construct là mã do bạn chọn chạy. Dùng plugins.allow để liệt kê các plugin được phép tải.

Kỹ năng

Kỹ năng là gì?

Kỹ năng là các khả năng mô-đun dạy tác nhân các quy trình làm việc mới. Mỗi kỹ năng là một tệp markdown (SKILL.md) với các hướng dẫn được chèn vào ngữ cảnh của tác nhân khi cần.

Vị trí kỹ năng (Thứ tự ưu tiên)

Kỹ năng không gian làm việc, <workspace>/skills/ (ưu tiên cao nhất)
Kỹ năng được quản lý, ~/.neotask/skills/
Kỹ năng đi kèm, Được vận chuyển với Neotask
Kỹ năng plugin, Kỹ năng được đóng gói với các plugin đã cài đặt
Thư mục bổ sung, Các đường dẫn được cấu hình thêm (ưu tiên thấp nhất)

Khi nhiều kỹ năng có cùng tên, vị trí ưu tiên cao nhất thắng.

Tính năng kỹ năng

Người dùng có thể gọi, Kích hoạt kỹ năng trực tiếp bằng lệnh slash (ví dụ: /docker-build)
Mô hình có thể gọi, Kỹ năng mà tác nhân có thể tự gọi khi cần
Điều phối lệnh, Kỹ năng ánh xạ đến các công cụ cụ thể
Kiểm soát yêu cầu, Kỹ năng chỉ tải khi các yêu cầu của chúng được đáp ứng (tệp nhị phân yêu cầu, khóa cấu hình, biến môi trường, plugin)

Tạo kỹ năng

Tạo tệp SKILL.md với YAML frontmatter xác định siêu dữ liệu và hướng dẫn của kỹ năng:

Trường frontmatter:

name, Định danh kỹ năng
description, Kỹ năng làm gì
homepage, Liên kết đến tài liệu
user-invocable, Người dùng có thể kích hoạt trực tiếp hay không
disable-model-invocation, Ngăn tác nhân tự gọi nó
command-dispatch, Công cụ để điều phối đến
metadata.neotask.requires, Điều kiện tiên quyết (bins, config, env, plugins)

Phần thân: Hướng dẫn markdown dạy tác nhân cách sử dụng kỹ năng, bao gồm các ví dụ và hướng dẫn.

Danh mục kỹ năng

Duyệt các kỹ năng có sẵn trong danh mục kỹ năng.

Danh mục kỹ năng

Kỹ năng bao gồm nhiều khả năng:

Danh mục	Ví dụ
Năng suất	Quản lý email, lịch, tạo tài liệu
Phát triển	Thao tác Git, CI/CD, Docker, xem xét mã
Giao tiếp	Nhắn tin, thông báo, thông báo
Phương tiện	Xử lý hình ảnh, chỉnh sửa video, phiên âm âm thanh
AI & Mô hình	Chuyển đổi mô hình, quản lý lời nhắc, RAG
Nhà thông minh	Kiểm soát thiết bị IoT, kích hoạt tự động hóa
Tiện ích	Chuyển đổi tệp, chuyển đổi dữ liệu, thu thập web