Baza opisuje współpracujących agentów sztucznej inteligencji, konwersacje, prompty, odpowiedzi oraz wytwarzane artefakty i ich zależności. Agent może mieć koordynatora, odpowiadać na wiele promptów i wytwarzać pliki. Zestaw służy do ćwiczeń SQL w PostgreSQL. Wszystkie dane są fikcyjne; nazwy agentów nie oznaczają rzeczywistego systemu ani rejestru jego pracy.
Skrypty działają w bieżącym schemacie. Nie tworzą osobnej bazy danych ani
konta użytkownika. Pliki są zapisane w UTF-8. W psql, po
przejściu do katalogu z pobranymi skryptami, można wykonać:
\encoding UTF8 \set ON_ERROR_STOP on \i agenci.create.sql \i agenci.insert.sql
Skrypt danych wymaga pustych tabel. Skrypty zawierają własne
transakcje BEGIN–COMMIT; należy uruchamiać je bez
innych niezatwierdzonych zmian. Ponowny import do wypełnionych tabel
spowoduje błąd klucza głównego. Zestaw można odtworzyć, wykonując kolejno
agenci.drop.sql, agenci.create.sql i agenci.insert.sql.
Usuwa to dotychczasowe dane tego zestawu.
Skrypt drop usuwa kolejno tabele zaleznosc,
artefakt, odpowiedz, prompt,
konwersacja i agent. Nie używa CASCADE:
dodatkowe obiekty zależne, np. własne widoki, mogą zablokować usunięcie tabel.
PK oznacza klucz główny, a FK — klucz obcy.
Wszystkie kolumny są obowiązkowe (NOT NULL) poza
agent.id_koordynatora i odpowiedz.ocena.
Identyfikatory mają typ INTEGER i są nadawane jawnie;
nie korzystają z sekwencji ani kolumn tożsamościowych.
id_agenta INTEGER PK nazwa VARCHAR(60) specjalizacja VARCHAR(40) id_koordynatora INTEGER FK → agent.id_agenta; dopuszcza NULL
id_agenta — identyfikator agenta.nazwa — nazwa agenta; nie musi być unikatowa.specjalizacja — jedna z wartości: planowanie, sql, analiza, redakcja, weryfikacja, grafika, testowanie, dane.id_koordynatora — bezpośredni koordynator; NULL oznacza brak koordynatora.
Agent ma najwyżej jednego bezpośredniego koordynatora, ale może koordynować
wielu agentów. Ograniczenie id_koordynatora < id_agenta
wymusza mniejszy identyfikator koordynatora i wyklucza cykle.
Hierarchia jest lasem: może zawierać kilka niezależnych drzew i agentów
bez podwładnych. Schemat nie wyróżnia jednego obowiązkowego korzenia.
id_konwersacji INTEGER PK tytul VARCHAR(160) data_rozpoczecia DATE
id_konwersacji — identyfikator konwersacji.tytul — jej tytuł; różne konwersacje mogą mieć taki sam tytuł.data_rozpoczecia — dzień rozpoczęcia konwersacji.Konwersacja może zawierać wiele promptów albo nie zawierać żadnego.
id_promptu INTEGER PK id_konwersacji INTEGER FK → konwersacja.id_konwersacji tresc VARCHAR(1000) data_dodania DATE
id_promptu — identyfikator promptu, czyli polecenia lub pytania skierowanego do agentów.id_konwersacji — konwersacja, do której należy prompt.tresc — tekst polecenia; nie musi być unikatowy.data_dodania — dzień dodania promptu.Każdy prompt należy do dokładnie jednej konwersacji. Może pozostać bez odpowiedzi.
id_odpowiedzi INTEGER PK id_promptu INTEGER FK → prompt.id_promptu id_agenta INTEGER FK → agent.id_agenta data_wygenerowania DATE liczba_tokenow INTEGER CHECK (liczba_tokenow > 0) ocena SMALLINT dopuszcza NULL; CHECK (ocena BETWEEN 1 AND 5)
id_odpowiedzi — identyfikator pojedynczej odpowiedzi.id_promptu — prompt, na który udzielono odpowiedzi.id_agenta — agent będący jej autorem.data_wygenerowania — dzień wygenerowania odpowiedzi.liczba_tokenow — dodatnia długość odpowiedzi wyrażona w tokenach; token nie musi odpowiadać jednemu słowu.ocena — ocena od 1 do 5; NULL oznacza odpowiedź nieocenioną.
Na jeden prompt może odpowiedzieć wielu agentów, a ten sam agent może
odpowiedzieć na niego wielokrotnie. Para (id_promptu, id_agenta)
nie jest unikatowa. Agent może nie udzielić żadnej odpowiedzi.
COUNT(*) liczy wiersze odpowiedzi, COUNT(ocena) —
wystawione oceny, a AVG(ocena) pomija wartości NULL.
id_artefaktu INTEGER PK id_odpowiedzi INTEGER FK → odpowiedz.id_odpowiedzi nazwa VARCHAR(120) format VARCHAR(10) rozmiar_bajtow INTEGER CHECK (rozmiar_bajtow > 0)
id_artefaktu — identyfikator wytworzonego artefaktu, np. pliku.id_odpowiedzi — odpowiedź, w której artefakt powstał.nazwa — nazwa artefaktu; nie musi być unikatowa.format — jedna z wartości: sql, html, pdf, csv, png, md.rozmiar_bajtow — dodatni rozmiar w bajtach.Każdy artefakt powstaje w dokładnie jednej odpowiedzi. Odpowiedź może wytworzyć wiele artefaktów albo żadnego. Autorem artefaktu jest agent wskazany przez jego odpowiedź; konwersację ustala się przez jej prompt. Po dołączeniu artefaktów jedna odpowiedź może wystąpić w kilku wierszach, co należy uwzględnić przy liczeniu odpowiedzi.
id_artefaktu INTEGER FK → artefakt.id_artefaktu id_wymaganego INTEGER FK → artefakt.id_artefaktu PK (id_artefaktu, id_wymaganego) CHECK (id_wymaganego < id_artefaktu)
Wiersz zaleznosc(A, B) oznacza, że artefakt A wymaga
artefaktu B. Pierwsza kolumna wskazuje artefakt wymagający,
druga — wymagany. Tabela przechowuje zależności bezpośrednie.
Klucz złożony nie pozwala dwukrotnie zapisać tej samej pary.
Artefakt może wymagać wielu innych artefaktów i być wymagany przez wiele
artefaktów. Warunek mniejszego identyfikatora artefaktu wymaganego
wyklucza cykle. Jest to skierowany graf acykliczny, niekoniecznie drzewo:
do tego samego artefaktu może prowadzić kilka ścieżek zależności.
Artefakt bez wpisów jako id_artefaktu niczego nie wymaga.
Zależności pośrednie można wyznaczać za pomocą WITH RECURSIVE.
konwersacja → prompt → odpowiedz → artefakt łączy konwersację z jej wynikami; autora wskazuje odpowiedz.id_agenta.agent pozwala połączyć agenta z jego bezpośrednim koordynatorem; dalsze poziomy hierarchii można przeglądać rekurencyjnie.ON DELETE CASCADE. Usunięcie wiersza, na który wskazują inne wiersze, wymaga wcześniejszego usunięcia lub zmiany tych odwołań.DATE: przechowują dzień, bez godziny i strefy czasowej. Schemat nie wymusza kolejności dat rozpoczęcia konwersacji, dodania promptu i wygenerowania odpowiedzi; w danych początkowych zachowano tę kolejność.| Tabela | Liczba wierszy |
|---|---|
agent | 14 |
konwersacja | 10 |
prompt | 30 |
odpowiedz | 54 |
artefakt | 32 |
zaleznosc | 37 |
Daty są stałe i obejmują okres od 1 października 2025 do 30 października 2026 roku. Nie zależą od dnia uruchomienia skryptu. Spośród 54 odpowiedzi 46 ma ocenę, a 8 pozostaje nieocenionych.
Zestaw zawiera między innymi:
Dane pozwalają ćwiczyć złączenia, złączenia zewnętrzne, samozłączenia, grupowanie i agregacje, podzapytania skorelowane, warunki „nie istnieje” i „dla każdego” oraz zapytania rekurencyjne. Podane liczby i przykłady opisują dane początkowe, a nie dodatkowe ograniczenia schematu.