Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Konfiguracja Aggrega za pomocą asystenta AI

Asystent AI, który może uruchamiać polecenia na komputerze użytkownika — agent programistyczny w terminalu lub edytorze — może skonfigurować Aggrega za użytkownika: zainstalować plik binarny aggrega, dodać sobie umiejętność Aggrega i połączyć się z serwerem MCP Aggrega. Asystent, który instaluje wtyczki, wykonuje dwa ostatnie kroki naraz, instalując wtyczkę Aggrega; każdy inny dodaje umiejętność i łączy się z serwerem po kolei. Wystarczy wkleić do niego poniższy prompt, a asystent przejdzie przez te kroki; prompt nakazuje mu zapytać o zgodę, zanim cokolwiek zainstaluje.

Po zakończeniu asystent ma dwa sposoby pracy z Aggrega. Umiejętność to folder z plikiem SKILL.md, który asystent wczytuje, gdy żądanie dotyczy Aggrega: informuje asystenta, jak przebiega pętla tworzenia, i nakazuje mu brać każdą odpowiedź dotyczącą schematu lub pliku z pliku binarnego, a nie z pamięci. Serwer MCP, aggrega mcp, udostępnia asystentowi narzędzia Aggrega — scaffold, validate, build i pozostałe — oraz materiały referencyjne, na których one bazują. Umiejętność i wtyczkę opisuje strona Umiejętność Aggrega, serwer — Połączenie z serwerem MCP, a to, do czego asystent ma przez niego dostęp — Co asystent może zrobić z Aggrega.

Po skonfigurowaniu asystenta strona Pierwsze kroki, każdy przewodnik w sekcji Import oraz strona każdego przykładu do uruchomienia, który buduje się za pomocą Aggrega, podają zadanie, którego uczą, jako prompt do wklejenia do asystenta, obok poleceń.

Prompt

Skonfiguruj dla mnie Aggrega, krok po kroku, i przy każdym kroku powiedz mi, co zostało uruchomione.
1. Uruchom `aggrega version`. Jeśli polecenie nie zostanie znalezione, zapytaj mnie przed zainstalowaniem Aggrega, a następnie zainstaluj Aggrega dla mojego użytkownika oficjalnym instalatorem: w systemie Linux lub macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, w systemie Windows w PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Ponownie uruchom `aggrega version`. Jeśli instalator wypisał wiersz do dodania do mojego `PATH`, pokaż mi go.
2. Jeśli `https://aggrega.ai/docs/ai-assistants/skill/` podaje sposób zainstalowania w tobie wtyczki Aggrega, zapytaj mnie, zanim ją zainstalujesz, a następnie zainstaluj ją w ten sposób albo powiedz mi, co mam zrobić, jeśli jest to krok, który wykonuję w twoim interfejsie. Wtyczka dodaje umiejętność Aggrega i łączy cię z serwerem MCP Aggrega. W przeciwnym razie uruchom `aggrega skills install --help` i znajdź swój identyfikator na wypisanej liście. Zapytaj mnie, czy chcę mieć umiejętność w tym projekcie, czy we wszystkich projektach, a następnie uruchom `aggrega skills install --agent <your identifier>`, dodając `--global` dla wszystkich projektów. Jeśli nie ma cię na liście, pomiń instalację umiejętności i poinformuj mnie o tym.
3. Jeśli wtyczka została zainstalowana, połączenie z serwerem MCP Aggrega już istnieje. W przeciwnym razie połącz się z serwerem MCP Aggrega, czyli z poleceniem `aggrega mcp`, w taki sposób, w jaki dodajesz serwer MCP, zgodnie z opisem przeznaczonym dla ciebie na `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Jeśli do wczytania wtyczki lub serwera potrzebny jest restart lub ponowne wczytanie, powiedz mi, co mam zrobić.
4. Po połączeniu wywołaj narzędzie `describe-capabilities` bez argumentów i podsumuj, co wymienia.

Prompt jest taki sam w każdym języku, w którym publikowana jest dokumentacja: tłumaczone są tylko jego zdania, a każde polecenie, flaga, adres i nazwa narzędzia pozostają dokładnie w zapisanej postaci, więc asystent czyta te same instrukcje niezależnie od tego, z której wersji językowej zostały skopiowane.

Instalator pobiera najnowsze wydanie, weryfikuje je względem opublikowanych dla tego wydania skrótów SHA-256 i instaluje je tylko dla bieżącego użytkownika, bez uprawnień administratora; Instalacja pliku binarnego opisuje, co robi instalator i jak zamiast tego zainstalować ręcznie.

Co się zmienia w zależności od asystenta

Trzy części promptu zależą od asystenta: sposób instalowania wtyczki Aggrega, jeśli asystent instaluje wtyczki; w przeciwnym razie identyfikator, który przekazuje on do --agent przy instalowaniu umiejętności, oraz sposób dodawania serwera. Asystent ustala je na podstawie promptu, ale jeśli są znane, można je wpisać do promptu.

AsystentInstalacja wtyczkiInstalacja umiejętności bez wtyczki
Claude Codeclaude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsaggrega skills install --agent claude-code
Codexcodex plugin marketplace add aggrega-ai/aggrega-skills, a następnie codex plugin add aggrega@aggregaaggrega skills install --agent codex
GitHub Copilot CLIcopilot plugin marketplace add aggrega-ai/aggrega-skills, a następnie copilot plugin install aggrega@aggregaaggrega skills install --agent github-copilot
Gemini CLIgemini extensions install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent gemini-cli
Antigravityagy plugin install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent antigravity lub --agent antigravity-cli dla Antigravity CLI
Cursorgit clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, a następnie Developer: Reload Windowaggrega skills install --agent cursor

Visual Studio Code z GitHub Copilot, Kiro i OpenClaw również instalują wtyczkę; sekcja Instalacja wtyczki podaje sposób dla każdego asystenta oraz to, o co OpenClaw pyta przed instalacją. Identyfikatory akceptowane przez --agent oraz folder, który każdy z nich zapisuje, są wymienione w aggrega skills i wypisywane przez aggrega skills install --help. Sposób, w jaki każdy asystent dodaje serwer — własnym poleceniem albo wpisem w ustawieniach lub w pliku z listą serwerów — opisuje strona Połączenie z serwerem MCP, klient po kliencie.

Gdy część promptu nie ma zastosowania

  • Asystent, który instaluje wtyczkę, pomija łączenie z serwerem: połączyła go wtyczka. Wtyczka nie instaluje pliku binarnego, więc krok 1 nadal obowiązuje. Jeśli asystent uruchamia serwer wtyczki poza projektem — Codex uruchamia go we własnym folderze wtyczki — umiejętność nakazuje mu wskazać serwerowi folder projektu, jak opisuje sekcja Folder, w którym pracuje serwer.
  • Asystent, który nie instaluje żadnej wtyczki i którego nie ma na liście --agent, pomija instalację umiejętności. Po połączeniu nadal ma dostęp do narzędzi Aggrega przez serwer MCP, a serwer przy połączeniu przekazuje mu własne wskazówki.
  • Asystent, który nie może uruchamiać poleceń — aplikacja czatu bez dostępu do terminala — nie może wykonać promptu. Należy zainstalować plik binarny, jak opisuje Instalacja, i samodzielnie połączyć aplikację, jak opisuje Połączenie z serwerem MCP. Informacje o Claude Desktop zawiera sekcja Claude Desktop poniżej.
  • Serwer uruchamiany przez kogoś innego, dostępny przez HTTPS, nie wymaga ani pliku binarnego, ani wtyczki, ani umiejętności. Zamiast tego należy podać adres klientowi asystenta, jak opisuje Serwer dostępny przez HTTPS.

Claude Desktop

Claude Desktop łączy się z Aggrega przez pakiet rozszerzenia dołączany do każdego wydania, a ten pakiet uruchamia aggrega zainstalowany na komputerze. Oba elementy należy samodzielnie skonfigurować na komputerze:

  1. aggrega instaluje się w PowerShell w systemie Windows poleceniem irm https://aggrega.ai/install.ps1 | iex lub w terminalu w systemie macOS albo Linux poleceniem curl -fsSL https://aggrega.ai/install.sh | sh. Instalacja pliku binarnego opisuje, co robi instalator.
  2. Należy zainstalować pakiet rozszerzenia, ustawić jego Workspace folder i ponownie uruchomić Claude Desktop, jak opisuje Claude Desktop na stronie Połączenie z serwerem MCP.

Sesja Claude Desktop może uruchamiać polecenia w kontenerze w chmurze zamiast na komputerze, więc wklejony do niej powyższy prompt działa w kontenerze. Tam aggrega instaluje się i uruchamia z powłoki sesji, gdy tylko polityka sieciowa kontenera zezwoli na aggrega.ai — zezwala na to właściciel organizacji w ustawieniach dostępu do sieci organizacji. Serwer MCP Aggrega nie jest tam połączony: Claude Desktop dodaje serwer lokalny tylko z ustawień swoich rozszerzeń, a rozszerzenie uruchamia aggrega na komputerze, a nie ten w kontenerze.

aggrega skills install nie ma pozycji dla Claude Desktop, więc sesja Claude Desktop pomija instalację umiejętności. Po zainstalowaniu rozszerzenia ma dostęp do narzędzi Aggrega przez serwer MCP, a serwer przy połączeniu przekazuje jej własne wskazówki.