Jak połączyć Codex z Obsidianem i zbudować własną bazę wiedzy?

Obsidian świetnie sprawdza się jako miejsce do przechowywania notatek, dokumentacji i wiedzy projektowej. Problem pojawia się wtedy, gdy materiałów zaczyna przybywać, a ręczne przeglądanie, opisywanie i porządkowanie kolejnych plików zajmuje coraz więcej czasu.

W takiej sytuacji możemy połączyć Obsidiana z Codexem. Dzięki temu zyskujemy system, który nie tylko przechowuje wiedzę, ale również pomaga ją tworzyć, aktualizować, porządkować i przeszukiwać.

W filmie pokazuję krok po kroku, jak przekształcić folder z dokumentami PDF w uporządkowaną bazę wiedzy w Obsidianie. Jako przykład wykorzystuję rozporządzenia dotyczące BHP i warunków technicznych, ale ten sam proces można zastosować do norm, instrukcji, dokumentacji projektowej, wytycznych firmowych oraz materiałów szkoleniowych.

Dlaczego warto połączyć Codex z Obsidianem?

Obsidian pozwala tworzyć lokalną bazę wiedzy składającą się z plików Markdown. Możemy w niej przechowywać notatki, łączyć powiązane informacje, używać tagów i szybko przeszukiwać zgromadzone materiały.

Codex dodaje do tego możliwość pracy z wykorzystaniem modelu językowego.

Połączenie obu narzędzi działa w dwie strony.

Codex może:

• tworzyć nowe notatki
• edytować istniejące materiały
• porządkować strukturę folderów
• konwertować dokumenty do formatu Markdown
• wyszukiwać informacje w wielu plikach jednocześnie
• przygotowywać podsumowania
• łączyć powiązane informacje
• aktualizować istniejącą bazę wiedzy

Jednocześnie Obsidian dostarcza Codexowi kontekst. Model może korzystać z zapisanych norm, przepisów, wcześniejszych projektów, instrukcji oraz zasad obowiązujących w danym biurze.

Dzięki temu nie pracuje wyłącznie na podstawie pojedynczego polecenia. Otrzymuje dostęp do materiałów związanych z konkretnym projektem i może lepiej dopasować wyniki do naszych potrzeb.

Tworzenie bazy wiedzy z dokumentów PDF

W filmie zaczynam od folderu zawierającego kilkanaście rozporządzeń zapisanych w formacie PDF.

Celem jest wykonanie automatycznej konwersji dokumentów do plików Markdown, które następnie będą mogły zostać otwarte i przeszukiwane w Obsidianie.

Nie chodzi jednak wyłącznie o skopiowanie tekstu z PDF-a.

Dobrze przygotowana konwersja powinna zachować:

• strukturę dokumentu
• nagłówki i podziały treści
• tabele
• zdjęcia i grafiki
• informacje o numerach stron
• odnośniki do plików źródłowych
• metadane dotyczące dokumentu

Dzięki temu baza wiedzy pozostaje czytelna, a w razie problemów z konwersją zawsze możemy wrócić do oryginalnego PDF-a.

Jak przygotować prompt do konwersji dokumentów?

Jednym z najważniejszych elementów całego procesu jest odpowiednio przygotowane polecenie.

Prompt powinien przede wszystkim wskazywać trzy rzeczy:

• Gdzie znajdują się pliki źródłowe.
• Do jakiego formatu mają zostać przekonwertowane.
• W jakim programie będą później wykorzystywane.

W tym przypadku Codex otrzymuje informację, że ma odczytać pliki PDF, przekonwertować je do formatu Markdown i utworzyć strukturę zgodną z bazą Obsidiana.

Pliki źródłowe nie muszą znajdować się w tym samym folderze co projekt. Możemy wskazać dowolną lokalizację, pod warunkiem że model otrzyma jasną informację, z jakich materiałów ma skorzystać.

W przypadku większej lub bardziej zróżnicowanej bazy cały proces można podzielić na mniejsze etapy. Możemy najpierw przeanalizować rodzaje dokumentów, następnie ustalić strukturę folderów, a dopiero później rozpocząć konwersję.

Zachowanie oryginalnych dokumentów

Podczas automatycznej konwersji zawsze warto zachować oryginalne pliki.

OCR i ekstrakcja tekstu nie zawsze działają idealnie. Jakość wyniku zależy między innymi od jakości skanu, układu dokumentu, rodzaju czcionki oraz liczby tabel i grafik.

Dlatego w przygotowanym poleceniu warto poprosić Codexa o przeniesienie oryginalnych PDF-ów do odpowiedniego podfolderu oraz utworzenie odnośników prowadzących do plików źródłowych.

Pozwala to szybko porównać treść notatki z oryginalnym dokumentem i zweryfikować interesujący nas zapis.

Jest to szczególnie istotne przy pracy z:

• normami
• rozporządzeniami
• dokumentacją techniczną
• instrukcjami producentów
• kartami katalogowymi
• zeskanowanymi dokumentami
• materiałami zawierającymi dużo tabel

OCR, tabele, zdjęcia i numery stron

Jeżeli PDF nie posiada warstwy tekstowej, przed konwersją należy wykonać OCR.

Dopiero po rozpoznaniu tekstu dokument może zostać poprawnie zapisany w formacie Markdown. Warto uwzględnić ten etap bezpośrednio w poleceniu, aby Codex sam sprawdził rodzaj każdego pliku i dobrał właściwy sposób przetwarzania.

Kolejnym problemem są numery stron.

Plik Markdown jest ciągłym dokumentem tekstowym i nie posiada naturalnego podziału na strony. Przy pracy z przepisami lub normami możliwość wskazania konkretnej strony może jednak mieć duże znaczenie.

Dlatego podczas konwersji można dodać oznaczenia informujące, z której strony dokumentu pochodzi dany fragment.

Podobnie wygląda sytuacja ze zdjęciami i tabelami. Bez odpowiedniej instrukcji część tych informacji może zostać pominięta. W filmie pokazuję bazę, w której Codex wyodrębnił grafiki z PDF-ów, zapisał je w odpowiednim folderze i umieścił w odpowiednich miejscach notatek.

Tryb planowania przed rozpoczęciem pracy

Przed rozpoczęciem konwersji korzystam z trybu planowania.

Zamiast od razu modyfikować pliki, Codex najpierw:

• analizuje zawartość folderu
• rozpoznaje rodzaje dokumentów
• przygotowuje strukturę bazy
• opisuje sposób wykonania OCR
• planuje konwersję plików
• określa sposób zachowania załączników i metadanych

Gotowy plan można sprawdzić i zatwierdzić. Jeżeli jakieś założenie jest nieprawidłowe, możemy je poprawić przed rozpoczęciem właściwej pracy.

Jest to szczególnie przydatne podczas pracy z większą liczbą dokumentów. Pozwala uniknąć sytuacji, w której model rozpocznie konwersję według nieodpowiedniej struktury, a wszystkie pliki trzeba będzie później tworzyć ponownie.

Plik AGENTS.md, czyli instrukcja obsługi bazy

W projekcie tworzony jest również plik AGENTS.md.

Można potraktować go jako instrukcję przeznaczoną dla modelu językowego. Zapisujemy w nim informacje dotyczące celu bazy, jej struktury oraz zasad dalszej pracy.

Plik może zawierać między innymi:

• opis przeznaczenia bazy
• strukturę folderów
• sposób odczytywania dokumentów
• zasady tworzenia nowych notatek
• reguły konwersji kolejnych plików
• sposób nazywania plików
• wymagane metadane
• informacje o plikach źródłowych

Dzięki temu nie musimy przy każdym kolejnym zadaniu ponownie wyjaśniać, jak Codex ma pracować.

Wystarczy otworzyć projekt i zlecić dodanie kolejnych dokumentów. Model może odczytać zapisane instrukcje i zastosować wcześniej ustalone zasady.

Jak wygląda gotowa baza w Obsidianie?

Po zakończeniu konwersji każdy dokument PDF otrzymuje własną notatkę.

Tytuł notatki może odpowiadać nazwie pliku źródłowego. W jej właściwościach mogą znaleźć się dodatkowe informacje, takie jak:

• lokalizacja oryginalnego dokumentu
• data utworzenia notatki
• informacja o zastosowaniu OCR
• liczba znaków
• typ dokumentu
• zastosowane tagi

Poniżej metadanych znajduje się właściwa treść dokumentu wraz z nagłówkami, tabelami i grafikami.

Tak przygotowane materiały można przeglądać bezpośrednio w Obsidianie. Nadal możemy korzystać ze wszystkich jego funkcji, w tym wyszukiwania, tagowania, linkowania notatek i tworzenia własnej struktury wiedzy.

Wyszukiwanie informacji za pomocą Codexa

Gotowa baza nie służy wyłącznie do przeglądania dokumentów.

Codex może przeszukiwać wszystkie notatki i odpowiadać na pytania na podstawie ich zawartości.

W filmie proszę go o znalezienie przepisów BHP dotyczących udźwigu. Model przeszukuje bazę i wskazuje notatki zawierające interesujące informacje wraz z ich dokładną lokalizacją.

Zamiast ręcznie otwierać kilkanaście rozporządzeń, możemy zadać pytanie językiem naturalnym i otrzymać listę pasujących fragmentów.

W podobny sposób można szukać:

• minimalnych odległości
• wymaganych szerokości
• dopuszczalnych obciążeń
• wymagań przeciwpożarowych
• zasad montażu
• parametrów urządzeń
• wytycznych projektowych
• zapisów dotyczących konkretnego rodzaju instalacji

Odpowiedź modelu nadal należy zweryfikować w oryginalnym dokumencie. Automatyczne wyszukiwanie znacznie skraca jednak czas potrzebny na dotarcie do właściwego miejsca.

Baza wiedzy jako kontekst do dalszej pracy

Wyszukiwanie informacji jest tylko jednym z możliwych zastosowań.

Do bazy możemy dodać:

• normy i rozporządzenia
• firmowe standardy
• dobre praktyki
• instrukcje
• wcześniejsze projekty
• przykładowe opisy techniczne
• założenia projektowe
• wytyczne inwestora
• dokumentację producentów

Na podstawie takiego kontekstu Codex może pomagać w bardziej rozbudowanych zadaniach.

Może przykładowo przygotować strukturę opisu technicznego, porównać projekt z zapisanymi wytycznymi, wskazać brakujące dane albo odnaleźć wcześniejsze rozwiązanie zastosowane w podobnym projekcie.

Możliwe jest również wykorzystanie bazy podczas wykonywania obliczeń, przygotowywania zestawień i tworzenia roboczej dokumentacji.

Im lepiej uporządkowane i opisane są materiały źródłowe, tym łatwiej wykorzystać je podczas kolejnych zadań.

Czy trzeba tworzyć bazę od początku?

Nie.

W filmie pokazuję proces tworzenia nowej bazy, ponieważ pozwala to przejść przez wszystkie etapy konwersji. Codex może jednak pracować również z istniejącym zbiorem notatek.

Możemy poprosić go o:

• uporządkowanie struktury folderów
• dodanie brakujących metadanych
• ujednolicenie nazw plików
• utworzenie tagów
• połączenie powiązanych notatek
• skrócenie zbyt rozbudowanych materiałów
• rozdzielenie długich notatek
• utworzenie stron zbiorczych
• dodanie nowych dokumentów

Cały proces powinien odbywać się pod naszym nadzorem. Model może wykonać znaczną część pracy technicznej, ale to użytkownik powinien kontrolować przyjętą strukturę i jakość wyników.

Podsumowanie

Połączenie Codexa z Obsidianem pozwala stworzyć lokalną bazę wiedzy, która nie jest tylko archiwum dokumentów.

Codex może pomóc w konwersji plików PDF, wykonaniu OCR, zachowaniu tabel i zdjęć, utworzeniu struktury folderów oraz przygotowaniu instrukcji dalszej pracy. Później może przeszukiwać zgromadzone materiały i wykorzystywać je jako kontekst podczas kolejnych zadań.

Takie rozwiązanie może być szczególnie przydatne dla osób pracujących z dużą liczbą norm, rozporządzeń, instrukcji i dokumentacji technicznej.

W filmie pokazuję pełny proces krok po kroku, od przygotowania folderu i promptu, przez planowanie konwersji, aż po wyszukiwanie konkretnych przepisów w gotowej bazie.

Obejrzyj film i zobacz, jak zbudować własną bazę wiedzy w Obsidianie:

Jeżeli korzystasz już z Obsidiana, możesz rozpocząć od niewielkiego folderu zawierającego kilka dokumentów. Po sprawdzeniu wyników strukturę można stopniowo rozbudowywać o kolejne normy, projekty i materiały.

Sprawdź również:

• 10 darmowych alternatyw open-source, które zastąpią Twoje drogie subskrypcje
• Podsumowanie spotkań z AI, pipeline OBS Studio, transkrypcja, baza wiedzy
• Alternatywy dla Obsidiana, Logseq, Notion, Capacities
• Rozmawiaj z Excelem, jak połączyć Codexa z arkuszem kalkulacyjnym
• GitHub jako repozytorium dokumentacji projektowej, wersjonowanie opisów i zestawień