Notatki inżynierskie / Decyzje
Decyzje, które porządkują cały system.
Home AI rozwija się wraz z moimi potrzebami. To decyzje dotyczące integracji i utrzymania, które mają największy wpływ na codzienne działanie projektu.
Gotowe komponenty i własna integracja.
Open WebUI zapewnia interfejs rozmowy, Qdrant przechowuje wektory, a Docker uruchamia część usług. Własny kod łączy te elementy z narzędziami i dokumentacją. Taki podział pozwala rozwijać potrzebne funkcje bez budowania od początku całego stosu.
Dokumentacja i pamięć mają różne zadania.
Bieżącą konfigurację odczytuję z utrzymywanego dokumentu. Historię decyzji i referencje techniczne wyszukuję w odrębnych kolekcjach. Agent może dobrać źródło do pytania, a informacja historyczna nie staje się automatycznie opisem aktualnego stanu.
Stan zadania jest częścią systemu.
Dłuższa operacja może zakończyć się po odpowiedzi HTTP albo przetrwać kilka kroków rozmowy. Narzędzia udostępniają stan zadania i wynik, a Autopilot przechowuje własny przebieg pracy. To ułatwia odróżnienie rozpoczęcia operacji od jej zakończenia.
Restart i dane wymagają osobnych decyzji.
Proces można uruchomić ponownie, ale trzeba wiedzieć, gdzie znajduje się jego stan. Autopilot i kontroler GPU korzystają z trwałych wolumenów. Przy migracji zachowuję dane i możliwość powrotu. Kontrola zdrowia procesu nie zastępuje sprawdzenia poprawności zadania.
Niepewny wynik wymaga sprawdzenia.
Zerwane połączenie nie mówi, czy zdalna operacja zdążyła się wykonać. Obsługa błędów przekazuje tę niepewność dalej. Zanim ponowię działanie, sprawdzam stan urządzenia lub wynik poprzedniego zadania.
Testuję konkretny zakres.
W projekcie są testy walidacji argumentów, pamięci zadań, integracji i zachowania po błędach. Korzystam też z prób przez działające usługi. Wyniki odnoszę do danego scenariusza i wersji — kilka udanych zadań nie dowodzi uniwersalnej skuteczności agenta.
Publiczna strona jako osobne wydanie.
Witryna przedstawia architekturę i przykłady. Kod przygotowywany do udostępnienia będzie miał własną konfigurację demonstracyjną. Celem jest opis i wydanie, które można zrozumieć bez dostępu do mojej prywatnej instalacji.