Insekthaver-agent

Agenten arbejder på en lokal database (SQLite) der er et 1:1-spejl af WooCommerce-kataloget (alle varer + deres attributter). Den henter data fra flere godkendte kilder for at verificere og berige produktdataene, men insekthaver.dk er aldrig selv en kilde — det er det, der verificeres. Det hele kører i et foreslå → godkend-flow: intet ændres uden din godkendelse.

Knappen i menuen starter en baggrundskørsel, der lag for lag:

Synkroniserer WooCommerce-kataloget til databasen (1:1-spejl; nye/ændrede/fjernede varer).
Oversætter relevans-nøgleord (DA↔EN) — forudsætning for søgning & scoring.
Henter kilder via GBIF-publishers (danske bio-institutioner).
Gemmer nye kildeforslag (pending) — aktiveres aldrig automatisk.
Søger nettet efter nye kilder med dine nøgleord (kræver søge-API; kan slås fra) → videnskabelige fund i Kildeforslag, havefaglige i Have-forslag.
Scorer kilder mod nøgleordene (antal hits).
Genererer manglende beskrivelser for alle varer ud fra deres egne attributter i databasen (deterministisk).

Verifikation mod kilderne kører ikke her længere — den er flyttet til on-demand på et udvalgt filter (se Katalog). Stop ved uforståede nøgleord: agenten spørger dig om en afklaring og fortsætter.

Den lokale database vist som tabel — et 1:1-spejl af WooCommerce med navn, latin, kategorier og attributter (højde, jord, lys, herkomst …). Filtrér i kolonneoverskrifterne, sortér og bladr. Du kan redigere beskrivelse og status inline og gemme direkte i databasen.

Det filtrerede udvalg er agentens arbejdssæt: "Kør agent på de filtrerede" genererer beskrivelser (fra varernes egne attributter) og verificerer dem mod kilderne (faktaforslag) — kun for de viste varer. "Eksportér CSV" henter de viste varer (eksport til WordPress forfines senere).

Nye kilder agenten har fundet. Klik kildenavnet for at åbne siden og tjekke den. Godkend aktiverer kilden; Afvis lægger den gråtonet nederst i listen. Agenten foreslår den aldrig selv igen — medmindre du genaktiverer den, hvorefter den igen kan godkendes.

Agenten har sammenlignet flere godkendte kilder pr. felt og foreslår ændringer (≠) eller nye (+) værdier. Hver række viser kilde, tillid (afledt af kilde-enighed + troværdighed) og WooCommerce nu til side-om-side sammenligning. Godkend skriver værdien i hovedbogen.

Fuld proveniens pr. plante (for alle varer i kataloget): hvilke kilder bidrog med hvert felt, hvor de er uenige (og hvori), den vægtede konsensus — og hvordan det står mod insekthaver.dk's egne data, med afvigelser flagget og kilde-reference.

Kører on-demand på et udvalgt filter (Katalog → "Kør agent på de filtrerede"), ikke i den almindelige agentkørsel — fordi det er tungt at spørge mange kilder pr. plante. For hvert felt spørges flere kilder (DA-/EN-Wikipedia, GloBI + godkendte GBIF-institutioner + evt. have-kilder). Ens svar klynges, vinderen vægtes efter troværdighed, og tilliden afledes: høj (≥2 enige) · mellem · lav (én kilde) · konflikt (uenige → kræver dit blik). Resultatet bliver til faktaforslag på dashboardet.

De 8 standardspørgsmål besvaret pr. plante — for alle varer i kataloget — groundet i insekthaver.dk's egne attributter + Wikipedia og formuleret af den valgte AI-model (lokal eller online — vælges under Konfiguration). Klik en plante for at se svarene; første gang genereres de og gemmes derefter.

Bruges en lille lokal model (fx på Hailo'en), skriver den engelsk, der oversættes til dansk; en dansk-stærk eller online-model svarer direkte på dansk. Uanset model er svarene groundet i verificerede fakta — modellen formulerer, den finder ikke på. Dansk-/online-modeller skriver desuden i samme varme, fortællende tone som jeres reference-dokument (Aften-Pragtstjerne), der er lagt ind som stil-skabelon — kun stil, aldrig fakta.

Gem layout låser placeringen; Ændre layout låser op; Nulstil gendanner det gemte. ⛶ maksimerer en widget oven på de andre; ? viser hjælp. Hver side husker sit eget layout.

Rediger WooCommerce-nøgler og kørselstidspunkt. Hemmelige felter vises aldrig — tomt felt bevarer den eksisterende værdi. Her styrer du også relevans-nøgleord. Alle valg gemmes (i config.env) og er bevaret efter en app-genstart. Hold musen over ? ud for hvert felt for en kort forklaring.

Model-udbyder (Q&A). Vælg lokal eller online:

Lokal model — en model via Ollama/Hailo på maskinen selv (intet sendes til skyen). Vælg model i dropdown'en. Standard er gemma3n:e4b; på vision (Hailo-10H) er det llama3.2:3b.
Online model — en vilkårlig model via en OpenAI-kompatibel udbyder. Angiv API-base-URL, nøgle og model-id. Mistral (api.mistral.ai/v1) har en hurtigvalgs-dropdown med priser og batch-estimat; du kan også selv indtaste fx en OpenRouter-, OpenAI- eller Groq-model.

Oversæt Q&A → dansk. Små lokale modeller skriver flydende engelsk, men ikke dansk — slå derfor til/fra her: til lader modellen svare på engelsk og oversætter automatisk til dansk (gratis via MyMemory). En dansk-stærk model (gemma3n) sætter du til fra. Online-modeller skriver dansk selv, så oversættelsen springes altid automatisk over der — uanset flaget.

Stor engangs-batch. Genererer du Q&A for hele kataloget med en online-model, køres det robust: kaldene throttles under udbyderens grænse, fejlede kald prøves igen med backoff, og færdige planter springes over — så en afbrudt batch genoptages bare ved at køre igen.

Skift udbyder/model når som helst, frem og tilbage — det er ren konfiguration, ingen kode. Q&A-svar caches: skifter du model, beholder allerede-genererede planter de gamle svar til du trykker ↻ Regenerér. Beskrivelser er deterministiske og bruger ikke en AI-model.

Kildeopdagelse. Agenten spørger GBIF's organisations-API (country=DK) og får danske biovidenskabs-institutioner, der udgiver forskningsdata til GBIF. De er troværdige per konstruktion og lægges i forslags-køen — aldrig aktiveret automatisk. Med en søge-API-nøgle (SerpAPI) søger agenten desuden på nettet med dine relevans-nøgleord: hvert fund rangeres efter hvor mange nøgleord der rammer og klassificeres efter troværdighed i to tiers — videnskabelige → kildeforslag, kommercielle/havefaglige → have-forslag. Kun danske sider (.dk) medtages (udenlandske .com frafiltreres). Styres under Konfiguration med til/fra + antal søgninger pr. kørsel.

Have-tier (planteskoler m.fl.). Kommercielle/havefaglige sider findes ikke via GBIF. Tilføj i stedet en betroet planteskole under Kildebibliotek: den lokale model læser dens planteside og udtrækker praktiske felter (især så-vejledning). De vægtes lavt — udfylder huller, men kan aldrig overstemme de videnskabelige kilder.

Vægtning (troværdighed). Kendt institution scorer højest. Ellers point efter nøgleord: universitet/gbif = 5, museum/forskning/styrelse/herbarium = 4, institut/videnskab = 3. shop, blog, forum, wiki trækker 3 fra. Label: høj ≥5 · mellem ≥3 · lav >0.

Vægtning (konsensus). Når flere kilder svarer på samme felt, klynges ens svar, og hver klynges samlede troværdighed lægges sammen. Vinderen er klyngen med størst samlet troværdighed.

Relevans-scoring. Din redigerbare nøgleord-liste er omdrejningspunktet: agenten bygger søge-queries af nøgleordene og rangerer hvert fund efter hvor mange nøgleord der rammer (helord; udvidet DA↔EN). Kort: relevans bestemmer rangeringen, troværdighed bestemmer tier.

Database / katalog — agentens lokale SQLite-database (catalog.db) = et 1:1-spejl af WooCommerce-kataloget plus vores arbejdsfelter (beskrivelse, status). Eneste sandhedskilde; alle visninger (Katalog, Q&A, Kilde-data) og agentens arbejde læser herfra.

Hovedbog — agentens facit-liste over menneske-godkendte fakta. Når du godkender et faktaforslag, skrives værdien i hovedbogen, som nye kilde-data sammenlignes imod.

Proveniens — et datapunkts oprindelse: hvilke(n) kilde(r) det stammer fra (vist på Kilde-data).

Konsensus — den værdi flere kilder tilsammen peger på; vinderen vægtes efter troværdighed.

Provider / kilde — et sted agenten henter data fra (Wikipedia, GloBI, godkendte GBIF-institutioner). Insekthaver.dk er aldrig en kilde.

Troværdighed — hvor pålidelig en kilde vurderes; videnskabelige institutioner rangerer højt, citizen-science lavere.

Have-tier — lavt-vægtet kildetype til betroede planteskoler; modellen læser siden og udtrækker praktiske havefakta.

Tillid — hvor sikker agenten er på et felt, afledt af enighed + troværdighed: høj (≥2 enige) · mellem · lav (én kilde) · konflikt.

Konflikt — kilderne er uenige uden klar vinder; flagges, så du afgør det.

Grounding (groundet) — at give AI-modellen konkrete, verificerede fakta at svare ud fra, så den formulerer frem for at finde på.

Attribut — et struktureret datafelt på et WooCommerce-produkt (Højde, Jordbundsforhold, Herkomst …). Insekthavers egne data.

WooCommerce — webshop-systemet insekthaver.dk kører på. Agenten læser produkter (kun læsning) og spejler dem ind i databasen.

GBIF — international database over arters forekomster; de godkendte institutioner udgiver data her (agenten henter bl.a. plantefamilie).

GloBI — database over arters samspil, fx hvilke insekter der bestøver en plante.

Ollama — programmet der kører den lokale AI-model (fx gemma3n) på din egen maskine, så intet sendes til skyen.

Model-udbyder — hvor Q&A-modellen kører: lokal (Ollama/Hailo på maskinen) eller online (en sky-udbyder). Skiftes under Konfiguration.

Online model — en AI-model hos en sky-udbyder, brugt via et OpenAI-kompatibelt endpoint. Med OpenRouter kan du nå næsten enhver model (Claude, GPT, Gemini …) gennem ét endpoint.

Hailo — AI-accelerator-chippen (Hailo-10H) i vision, der kan køre den lokale model direkte på enheden i stedet for CPU'en.

Oversættelse (Q&A) — små lokale modeller skriver engelsk, der oversættes til dansk (gratis via MyMemory). Dansk-stærke og online-modeller skriver dansk direkte, så oversættelsen springes over.

Vejledning — sådan fungerer agenten