Wpis 001 / Notatka o zakresie

Najpierw zakres, potem wyniki.

Co ten projekt próbuje osiągnąć, czego blog będzie, a czego nie będzie twierdzić, i co musi zawierać każdy opis testu.

W jednym akapicie

Projekt 001 to próba zbudowania agenta AI, który pomaga projektować sieci światłowodowe do domów (FTTH). Korzysta z lokalnego modelu językowego, publicznych polskich danych mapowych i zwykłego kodu do obliczeń. Ten pierwszy wpis ustala zasady bloga. Nie opisuje zakończonego eksperymentu, działającego projektowania od początku do końca ani sprawdzonej sieci.

Dlaczego najpierw zasady, a potem wyniki

Model językowy potrafi bardzo przekonująco wyjaśnić przebieg trasy kabla. To nie znaczy, że trasa jest poprawna. O tym decydują geometria, jakość danych wejściowych, liczby i założenia zadania.

Dlatego właściwe pytanie nie brzmi „czy model wygeneruje projekt?”, tylko „czy da się tę pracę sprawdzić?”. Każdy wynik opublikowany tutaj ma pokazywać, jak powstał i dlaczego można mu ufać albo nie.

Co znajdzie się w każdym wpisie z testem

  • 1Pytanie

    Co jest sprawdzane i co oznacza sukces, ustalone przed uruchomieniem.

  • 2Dane wejściowe

    Jakie dane publiczne albo przykład syntetyczny, z datą, warunkami użycia i układem współrzędnych.

  • 3Środowisko

    Wersje modelu i narzędzi, ustawienia, sprzęt i dokładna wersja kodu.

  • 4Co się stało

    Rzeczywisty wynik i logi, z wynikami narzędzi oddzielonymi od interpretacji modelu.

  • 5Niezależna kontrola

    Porównanie z wzorcem albo znanymi regułami, z jednostkami i tolerancjami.

  • 6Co z tego wynika

    Co zawiodło, co zmieniono, co pokazał ponowny test i co wciąż jest otwarte.

To jest format przyszłych wpisów. Żaden z tych testów nie jest tu jeszcze opisany.

Możliwa pierwsza kontrola

Mały przykład syntetyczny: kilka punktów o znanych współrzędnych, zadeklarowany układ współrzędnych i odległość policzona wcześniej niezależnie. Kontrola sprawdza, czy narzędzie używa właściwych jednostek i pokazuje dość obliczeń, żeby ktoś inny mógł zweryfikować wynik.

Ten test nie został jeszcze opisany, więc nie ma zmierzonego błędu, czasu ani wyniku zaliczony/niezaliczony. Nawet zaliczona kontrola odległości potwierdzi tylko tę jedną wąską rzecz. To, czy trasę da się zbudować i czy projekt sieci jest poprawny, to osobne pytania.

Czego nie będzie na tym blogu

  • Danych klientów ani materiałów pracodawcy.
  • Założenia, że dane publiczne są kompletne, aktualne i wolne do użycia tylko dlatego, że są w internecie. Każdy zbiór danych dostaje własną notkę o źródle i warunkach użycia.
  • Poglądowej mapy przedstawionej jako wynik inżynierski.
  • Liczb o wydajności bez warunków, w jakich je zmierzono.

Dalej

Opisać jedno prawdziwe uruchomienie: dane wejściowe, oczekiwane zachowanie, co się stało i kontrolę. Jeśli coś się nie uda, najpierw opisany zostanie błąd, a dopiero potem poprawka.

← Wszystkie wpisy (EN)Opis projektu →