Agenci

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.

Pliki i uruchomienie

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.

Tabele i kolumny

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.

agent

id_agenta        INTEGER      PK
nazwa            VARCHAR(60)
specjalizacja    VARCHAR(40)
id_koordynatora  INTEGER      FK → agent.id_agenta; dopuszcza NULL

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.

konwersacja

id_konwersacji    INTEGER       PK
tytul             VARCHAR(160)
data_rozpoczecia  DATE

Konwersacja może zawierać wiele promptów albo nie zawierać żadnego.

prompt

id_promptu      INTEGER        PK
id_konwersacji    INTEGER        FK → konwersacja.id_konwersacji
tresc           VARCHAR(1000)
data_dodania    DATE

Każdy prompt należy do dokładnie jednej konwersacji. Może pozostać bez odpowiedzi.

odpowiedz

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)

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.

artefakt

id_artefaktu   INTEGER       PK
id_odpowiedzi   INTEGER       FK → odpowiedz.id_odpowiedzi
nazwa          VARCHAR(120)
format         VARCHAR(10)
rozmiar_bajtow  INTEGER       CHECK (rozmiar_bajtow > 0)

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.

zaleznosc

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.

Powiązania i ograniczenia modelu

Dane początkowe

TabelaLiczba wierszy
agent14
konwersacja10
prompt30
odpowiedz54
artefakt32
zaleznosc37

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.

Sprawdź poprawność XHTML 1.0 Strict


Przykładowe schematy baz danych