ontology

• Haluat, että agentti muistaa jäsenneltyä tietoa istuntojen välillä (esim. "Muista, että Alice omistaa projektin X").
• Sinun täytyy linkittää toisiinsa liittyviä objekteja ja kulkea näitä linkkejä pitkin myöhemmin (esim. "Näytä kaikki tehtävät projektille Z", "Mistä X riippuu?").
• Useat taidot tarvitsevat jaetun tilan ilman raakaa tekstiä — yksi taito kirjoittaa Commitment-olion, toinen lukee sen Task-oliona.
• Olet suunnittelemassa monivaiheista työtä ja haluat, että jokainen vaihe mallinnetaan validoituna graafitransformaationa, jossa on palautusmahdollisuus rajoitteen loukkauksen yhteydessä.

• Tarvitset vain lyhytaikaisen, yksittäisen vuorovaikutuksen kontekstin eikä sinulla ole tarvetta pysyvyydelle agenttiajojen välillä.
• Datasi on puhtaasti rakenteetonta (vapaamuotoista tekstiä) ilman merkityksellisiä entiteettisuhteita mallinnettavaksi.
• Tarvitset tuotantotasoisen graafitietokannan korkealla samanaikaisuudella — suurille tai monimutkaisille graafeille SKILL.md itse suosittelee siirtymistä SQLiteen.

Sisältää kattavan joukon ennalta määriteltyjä tyyppejä, jotka kattavat toimijat (Person, Organization), työn (Project, Task, Goal), ajan ja paikan (Event, Location), tiedon (Document, Message, Note) sekä resurssit (Account, Device, Credential). Jokaisella tyypillä on tyypitetyt ominaisuudet ja valinnaiset kentät, joten voit mallintaa todellisen maailman ilman että sinun tarvitsee keksiä skeemoja tyhjästä.

Jokainen mutaatio validoidaan memory/ontology/schema.yaml-tiedostossa määriteltyjä sääntöjä vasten ennen sen tallentamista. Rajoitukset sisältävät pakolliset kentät, enum-arvot, kielletyt ominaisuudet (esim. raakojen salaisuuksien esto Credential-kohteessa), relaatiotyypin/kardinaliteetin säännöt, asyklisyystarkistukset sekä ajalliset järkevyystarkistukset, kuten end >= start Event-kohteessa.

Graafia tallennetaan vain-liitäntäisenä memory/ontology/graph.jsonl-tiedostona — jokainen luonti-, päivitys- ja suhteutusoperaatio lisää uuden rivin, säilyttäen täydellisen historian. Monimutkaisille graafeille SKILL.md suosittelee siirtymistä SQLite-tietokantaan samaa rajapintaa käyttäen.

scripts/ontology.py-komentorivityökalu tarjoaa komennot kaikkiin keskeisiin toimintoihin: create, query, get, related, relate, validate ja schema-append. Tämä mahdollistaa skriptaamisen mistä tahansa komentotulkin vaiheesta tai agentin toiminnosta ilman mukautetun graafin koodin kirjoittamista.

Taidot voivat julistaa ontology-sopimuksen omassa SKILL.md-tiedostossaan määrittäen, mitä tyyppejä ne reads (lukee) ja writes (kirjoittaa) sekä esi- ja jälkiehdot. Tämä tekee taitojen välisistä riippuvuuksista eksplisiittisiä ja tarkastettavia, muuttaen ontologyn tyypitetyksi viestiväyläksi eri kykyjen välille.

Monivaiheisia suunnitelmia voidaan mallintaa järjestettyinä sekvensseinä graafitransformaatioita (LUO → YHDISTÄ → LUO …). Jokainen vaihe validoidaan ennen suoritusta, ja koko suunnitelma voidaan peruuttaa rajoitusrikkomuksen sattuessa. Tämä antaa agenteille jäsennellyn ja tarkasteltavissa olevan suunnittelukerroksen.

Agentti luo Person- ja Project-entiteetit ensimmäisellä kerralla, kun ne mainitaan, ja yhdistää ne sitten has_owner- tai has_member-relaatioilla. Myöhemmissä vuoroissa kysely "Mitä tiedän Alicesta?" kulkee graafin läpi ja tuo esiin kaikki liittyvät projektit, tehtävät ja tapahtumat ilman, että se nojaa keskusteluhistoriaan.

Sähköpostinlukutaito poimii sitoumuksen viestistä ja kirjoittaa Commitment-entiteetin ontologyyn. Erillinen tehtävänhallintataito kyselee säännöllisesti odottavia Commitment-objekteja ja luo automaattisesti linkitettyjä Task-entiteettejä — kahden taidon välille ei tarvita suoraa kytkentää.

Suunnitteluagentti mallintaa projektin joukkona Task-entiteettejä, joilla on blocks-relaatioita. Syklittömyysrajoitus estää kehämäisten riippuvuuksien tallentamisen, ja related-kysely näyttää välittömästi, mitä täytyy suorittaa ennen kuin tietty tehtävä voi alkaa.

Ennen monimutkaisen työnkulun suorittamista (esim. "Aikatauluta tiimipalaveri ja määritä seurantatehtävät") agentti muuntaa jokaisen vaiheen validoiduksi graph-operaatioksi. Jos jokin vaihe rikkoo rajoitetta, koko sekvenssi peruutetaan, mikä tarjoaa turvallisen ja tarkastettavissa olevan suorituspolun Action-tyypin lokin kautta.