DevHub · Dla agentów AI
Ograniczenia
Te ograniczenia ustawia użytkownik i jego plan Vartari. Nie zmienisz ich z wnętrza sesji. Gdy wywołanie zostaje odrzucone z ich powodu, powiedz o tym użytkownikowi; nie szukaj obejścia.
DevHub udostępnia narzędzia tylko wtedy, gdy trwa sesja, a konto może uruchomić serwer MCP. Gdy sesja się kończy, każde żądanie dostaje odpowiedź „sign in required”. Bez sieci DevHub używa uprawnień, które dostał ostatnio, przez najwyżej 72 godziny.
Uprawnienia (od 0.8.1)
Dział zatytułowany „Uprawnienia (od 0.8.1)”- Każdy obszar ma poziom: odczyt, zapis lub zarządzanie. To, czy agenci mogą sięgać do obszaru przez MCP, ustawia się osobno.
- Narzędzie jest oferowane tylko wtedy, gdy konto może używać jego obszaru przez MCP na poziomie, którego narzędzie wymaga. Narzędzie, którego nie ma lub które jest odrzucane, wymienia potrzebne uprawnienie.
- Poziomu zarządzania wymagają: usuwanie plików (
file_delete), uruchamianie skryptów (npm_script_run), uruchamianie agentów (agent_run) i robienie zrzutów ekranu (display_screenshot). - Użytkownik może też wyłączyć pojedyncze narzędzia w Ustawieniach. Wyłączone narzędzie jest ukryte i odrzucane, gdy wywołasz je po nazwie.
Pliki i skrypty
Dział zatytułowany „Pliki i skrypty”- Sięgasz tylko do repozytoriów, które użytkownik zarejestrował i włączył. Ścieżki są względne wobec katalogu głównego repozytorium i nie mogą z niego wyjść.
- Nie możesz uruchamiać dowolnych poleceń powłoki.
npm_script_runuruchamia skrypt zadeklarowany wpackage.jsonrepozytorium, z opcjonalnym limitem czasu. file_deletejest nieodwracalne. Najpierw zapytaj użytkownika, chyba że użytkownik o to poprosi.- Odczyt częściowy (offset, limit, budżet tokenów) to nie cały plik. Nie nadpisuj pliku na jego podstawie.
- Zapis binarny jest ograniczony do 20 MB.
- Ekran widzisz tylko przez
display_screenshoti tylko gdy plan użytkownika na to pozwala.
- Widzisz vaulty, które użytkownik włączył dla MCP. Vault z dostępem „disabled” jest niewidoczny; ten, który nie jest do odczytu i zapisu, odrzuca zapisy.
knowledge_searchczyta tylko foldery wiedzy.vault_files_searchczyta każdy folder, ale jego indeks obejmuje pierwsze 5000 notatek vaultu.- Ścieżkę notatki bierz z listy lub wyszukiwania. Nie buduj jej z tytułu.
- Vault mówi, jak aplikacja działa i dlaczego. Spór rozstrzyga kod.
Agenci uruchamiani przez DevHub
Dział zatytułowany „Agenci uruchamiani przez DevHub”- Agent pracuje w swoim repozytorium i w vaultach przypisanych do tego repozytorium, jego projektu i jego organizacji. W niczym innym.
- Agent nie może uruchomić sam siebie ani pozwolić innemu agentowi na uruchamianie agentów.
agent_createtworzy agenta wyłączonego.agent_updatenie może go włączyć, a rozszerzenie możliwości agenta znów go wyłącza. Agenta włącza tylko właściciel.- Agent nie może zamknąć śledztwa.
- Odpowiedź przebiegu jest przechowywana godzinę.
- Krok ma jednego trzymającego. Krok dotykający tych samych plików co krok w toku jest odrzucany, tak samo krok, którego bramki nie są zamknięte.
- Claim wygasa, jeśli nikt go nie odnawia.
- Pracuj w katalogu roboczym, który dał Ci claim. Zamknięcie kroku scala go z powrotem; zamknięcie jako withdrawn niczego nie scala.
Czego nie robić
Dział zatytułowany „Czego nie robić”- Nie uruchamiaj ciężkich zadań równolegle, gdy wystarczy jedno. Dwóch agentów na tych samych plikach jest odrzucanych przy krokach planu; poza planami nic nie powstrzyma ich przed wzajemnym nadpisaniem.
- Nie ponawiaj odrzuconego wywołania bez zmian.
- Nie edytuj plików, które DevHub zapisał w folderze (instrukcje, skille, konfiguracja): następna aktualizacja je nadpisze.
- Nie umieszczaj sekretów ani danych osobowych w notatkach vaultu, śledztwach ani wpisach logu.
- Nie zgaduj identyfikatorów, ścieżek ani adresu MCP.