Thiết lập Aggrega với trợ lý AI của bạn
Một trợ lý AI có thể chạy lệnh trên máy của bạn — một tác tử lập trình trong terminal hoặc trình soạn thảo — có thể thiết lập Aggrega cho bạn: cài đặt tệp nhị phân aggrega, tự thêm kỹ năng Aggrega cho chính nó và tự kết nối với máy chủ MCP của Aggrega. Một trợ lý có cài đặt plugin sẽ thực hiện hai việc sau cùng trong một bước, bằng cách cài đặt plugin Aggrega; mọi trợ lý khác thêm kỹ năng và kết nối máy chủ lần lượt từng việc. Hãy dán lời nhắc bên dưới vào trợ lý, và nó sẽ lần lượt thực hiện các bước đó; lời nhắc yêu cầu nó hỏi ý kiến bạn trước khi cài đặt bất cứ thứ gì.
Khi hoàn tất, trợ lý có hai cách làm việc với Aggrega. Kỹ năng là một thư mục chứa tệp SKILL.md mà trợ lý tải khi yêu cầu của bạn liên quan đến Aggrega: kỹ năng cho trợ lý biết vòng lặp soạn thảo diễn ra như thế nào và yêu cầu nó lấy mọi câu trả lời về một schema hay một tệp từ tệp nhị phân thay vì từ trí nhớ. Máy chủ MCP, aggrega mcp, cung cấp cho trợ lý các công cụ của Aggrega — scaffold, validate, build và các công cụ khác — cùng tài liệu tham chiếu mà các công cụ đó dựa vào. Kỹ năng Aggrega mô tả kỹ năng và plugin, Kết nối máy chủ MCP mô tả máy chủ, và Những gì trợ lý của bạn có thể làm với Aggrega mô tả những gì trợ lý truy cập được thông qua máy chủ.
Sau khi thiết lập xong, Bắt đầu, mỗi hướng dẫn từng bước trong Nhập và trang của mỗi ví dụ có thể chạy được build bằng Aggrega đều đưa ra tác vụ mà chúng hướng dẫn dưới dạng lời nhắc để dán vào trợ lý, bên cạnh các lệnh.
Lời nhắc
Hãy thiết lập Aggrega cho tôi, từng bước một, và cho tôi biết bạn đã chạy gì ở mỗi bước.
1. Hãy chạy `aggrega version`. Nếu không tìm thấy lệnh, hãy hỏi tôi trước khi cài đặt Aggrega, sau đó cài đặt nó cho người dùng của tôi bằng trình cài đặt chính thức: trên Linux hoặc macOS là `curl -fsSL https://aggrega.ai/install.sh | sh`, trên Windows trong PowerShell là `irm https://aggrega.ai/install.ps1 | iex`. Chạy lại `aggrega version`. Nếu trình cài đặt in ra một dòng cần thêm vào `PATH` của tôi, hãy cho tôi xem dòng đó.2. Nếu `https://aggrega.ai/docs/ai-assistants/skill/` đưa ra cách cài đặt plugin Aggrega vào bạn, hãy hỏi tôi trước khi cài đặt, rồi cài đặt theo cách đó, hoặc cho tôi biết cần làm gì nếu đó là một bước tôi thực hiện trong giao diện của bạn. Plugin thêm kỹ năng Aggrega và kết nối bạn với máy chủ MCP của Aggrega. Nếu không, hãy chạy `aggrega skills install --help` và tìm định danh của chính bạn trong danh sách mà lệnh in ra. Hỏi tôi muốn có kỹ năng trong dự án này hay trong mọi dự án, sau đó chạy `aggrega skills install --agent <your identifier>`, thêm `--global` cho mọi dự án. Nếu bạn không có trong danh sách, hãy bỏ qua việc cài đặt kỹ năng và nói rõ điều đó.3. Nếu bạn đã cài đặt plugin, bạn đã được kết nối với máy chủ MCP của Aggrega. Nếu không, hãy tự kết nối với máy chủ MCP của Aggrega, tức là lệnh `aggrega mcp`, theo cách bạn thêm một máy chủ MCP, như `https://aggrega.ai/docs/ai-assistants/mcp-server/` mô tả dành cho bạn. Nếu bạn cần khởi động lại hoặc tải lại để nạp plugin hoặc máy chủ, hãy cho tôi biết cần làm gì.4. Sau khi đã kết nối, hãy gọi công cụ `describe-capabilities` không kèm đối số và tóm tắt những gì nó liệt kê.Prompt này giống nhau ở mọi ngôn ngữ mà tài liệu được xuất bản: chỉ các câu được dịch, còn mọi lệnh, cờ, địa chỉ và tên công cụ trong đó vẫn giữ nguyên như đã viết, nên trợ lý đọc cùng một chỉ dẫn dù bạn sao chép nó từ ngôn ngữ nào.
Trình cài đặt tải xuống bản phát hành mới nhất, kiểm tra nó với các bản tóm lược SHA-256 được công bố của bản phát hành đó và chỉ cài đặt cho người dùng của bạn, không cần quyền quản trị; Cài đặt tệp nhị phân mô tả những gì trình cài đặt thực hiện và cách cài đặt thủ công thay vào đó.
Những gì thay đổi giữa các trợ lý
Ba phần của lời nhắc phụ thuộc vào trợ lý: cách nó cài đặt plugin Aggrega, nếu nó cài đặt plugin; nếu không, định danh mà nó truyền cho --agent khi cài đặt kỹ năng, và cách nó thêm máy chủ. Trợ lý tự xác định những phần này từ lời nhắc, nhưng nếu biết, bạn có thể viết chúng vào lời nhắc.
| Trợ lý | Cài đặt plugin | Cài đặt kỹ năng không qua plugin |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills, sau đó codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills, sau đó copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity, hoặc --agent antigravity-cli cho Antigravity CLI |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, sau đó Developer: Reload Window | aggrega skills install --agent cursor |
Visual Studio Code với GitHub Copilot, Kiro và OpenClaw cũng cài đặt plugin; Cài đặt plugin đưa ra cách làm cho từng trợ lý, và những gì OpenClaw hỏi trước khi cài đặt. Các định danh mà --agent chấp nhận, và thư mục mà mỗi định danh ghi vào, được liệt kê trong aggrega skills và được in ra bởi aggrega skills install --help. Cách mỗi trợ lý thêm máy chủ — bằng lệnh riêng của nó, hoặc bằng một mục trong cài đặt hay trong tệp danh sách máy chủ — được trình bày trong Kết nối máy chủ MCP, cho từng client.
Khi một phần của lời nhắc không áp dụng
- Một trợ lý cài đặt plugin sẽ bỏ qua bước kết nối máy chủ: plugin đã kết nối nó. Plugin không cài đặt tệp nhị phân, vì vậy bước 1 vẫn áp dụng. Khi trợ lý khởi động máy chủ của plugin bên ngoài dự án của bạn — Codex khởi động nó trong thư mục riêng của plugin — kỹ năng yêu cầu trợ lý cho máy chủ biết thư mục dự án của bạn, như Thư mục mà máy chủ làm việc mô tả.
- Một trợ lý không cài đặt plugin nào và không có trong danh sách
--agentsẽ bỏ qua việc cài đặt kỹ năng. Sau khi kết nối, nó vẫn sử dụng được các công cụ của Aggrega thông qua máy chủ MCP, và máy chủ cung cấp cho nó hướng dẫn riêng khi nó kết nối. - Một trợ lý không thể chạy lệnh — một ứng dụng trò chuyện không có quyền truy cập vào terminal của bạn — không thể làm theo lời nhắc. Hãy cài đặt tệp nhị phân như Cài đặt mô tả, và tự kết nối ứng dụng như Kết nối máy chủ MCP mô tả. Với Claude Desktop, hãy xem Claude Desktop bên dưới.
- Một máy chủ do người khác chạy cho bạn, truy cập qua HTTPS, không cần tệp nhị phân, plugin lẫn kỹ năng. Thay vào đó, hãy cung cấp địa chỉ cho ứng dụng khách của trợ lý, như Máy chủ truy cập qua HTTPS mô tả.
Claude Desktop
Claude Desktop kết nối với Aggrega thông qua gói tiện ích mở rộng đi kèm mỗi bản phát hành, và gói đó khởi chạy aggrega được cài đặt trên máy tính của bạn. Hãy tự thiết lập cả hai trên máy tính của bạn:
- Cài đặt
aggregatrong PowerShell trên Windows bằngirm https://aggrega.ai/install.ps1 | iex, hoặc trong terminal trên macOS hay Linux bằngcurl -fsSL https://aggrega.ai/install.sh | sh. Cài đặt tệp nhị phân mô tả trình cài đặt làm gì. - Cài đặt gói tiện ích mở rộng, đặt Workspace folder của nó và khởi động lại Claude Desktop, như Claude Desktop trong trang Kết nối máy chủ MCP mô tả.
Một phiên Claude Desktop có thể chạy lệnh trong một container trên đám mây thay vì trên máy tính của bạn, vì vậy lời nhắc ở trên, khi được dán vào phiên đó, sẽ tác động lên container. Tại đó, aggrega được cài đặt và chạy từ shell của phiên khi chính sách mạng của container cho phép aggrega.ai — chủ sở hữu tổ chức cho phép điều này trong phần cài đặt truy cập mạng của tổ chức. Máy chủ MCP Aggrega không được kết nối ở đó: Claude Desktop chỉ thêm máy chủ cục bộ từ phần cài đặt tiện ích mở rộng của nó, và tiện ích mở rộng khởi chạy aggrega trên máy tính của bạn, không phải bản trong container.
aggrega skills install không có mục cho Claude Desktop, vì vậy một phiên Claude Desktop sẽ bỏ qua việc cài đặt kỹ năng. Phiên đó sử dụng các công cụ của Aggrega thông qua máy chủ MCP sau khi tiện ích mở rộng được cài đặt, và máy chủ cung cấp cho nó hướng dẫn riêng khi nó kết nối.