Hop til hovedindhold

Input-byggeklodser

Input-byggeklodser er startpunkter, der leverer data ind i et flow. De henter tekst, skabeloner, dokumenter, lovgivning og overenskomster og sender dem videre til resten af flowet uden at have brug for et forudgående led. De fleste flows begynder med mindst én af dem.

Byggeklodserne falder i fire grupper: tekst (Tekstinput, Skabelon), dokumenter fra AgentBases dokumentbibliotek (Hent Dokument, Dokumentliste, Hent Dokument Indhold, Slå Dokumenter Op, Søg Dokumenter), lovgivning og overenskomster fra eksterne registre (Hent Lovgivning, Hent overenskomst) og to udfasede liste-byggeklodser (Filliste, Tekstliste), der stadig kører i eksisterende flows.

Chat-aktiverede byggeklodser

Flere af byggeklodserne her kan bruges som Sprogmodel-værktøj. Det betyder, at en Sprogmodel-agent selv kan kalde dem under sin arbejdsgang — fx slå dokumenter op eller hente en lov, mens den løser en opgave. Det gælder Hent Dokument, Hent Dokument Indhold, Slå Dokumenter Op, Hent Lovgivning og Hent overenskomst.

Adgang kontrolleres ved kørsel

Alle dokument-byggeklodserne slår op i dokumentbiblioteket med rettighederne for den bruger, der kører flowet — ikke den, der byggede det. En kørsel uden brugerkontekst afvises, og et dokument, brugeren ikke har adgang til, giver en fejl frem for et tomt resultat. Resultaterne caches ikke, så en ny OCR-behandling eller ændret adgang slår igennem med det samme.

Tekst

Tekstinput

Sender en fast tekst uændret videre til sit output. Byggeklodsen har ingen logik ud over gennemløbet: det, der står i feltet Tekst (eller kommer ind via kanten), er præcis det, der kommer ud.

Inputs

FeltTypeBeskrivelse
TekststrDen tekst, der skal sendes videre. Valgfri; standardværdien er en tom streng, så en ukonfigureret byggeklods giver "" som output.

Outputs

  • Tekst (str) — den samme tekst, uændret.

Typiske brugsscenarier

  • Som startpunkt i et flow, hvor brugeren skal skrive en tekst (fx en kundehenvendelse), der sendes videre til en Sprogmodel-byggeklods.
  • Til at indsætte fast tekst — en instruktion, en signatur eller et referencedokument — der skal bruges et andet sted i flowet.
  • Til test og fejlsøgning: udskift midlertidigt et dyrt eller eksternt input med en fast tekst for at afprøve resten af flowet.

Brug når / Undlad når

  • Brug når du har brug for én enkelt, statisk tekstværdi i et flow.
  • Undlad når du skal kombinere flere dynamiske værdier — brug Skabelon, der understøtter {variabel}-syntaks og dynamiske inputs.
  • Undlad når teksten skal hentes fra en ekstern kilde — brug HTTP Forespørgsel eller Hent Dokument; Tekstinput er kun til statisk tekst.
  • Undlad når du skal iterere over flere tekster i en løkke — brug Tekstliste, som giver en liste i stedet for én enkelt værdi.

Resultatet caches som alle andre rene byggeklodser; da output altid er identisk med input, har det ingen praktisk betydning.

Relaterede byggeklodser: Input-byggeklodser (Skabelon, Tekstliste, Hent Dokument), Data-byggeklodser (HTTP Forespørgsel), AI-byggeklodser (Sprogmodel), Logik-byggeklodser (løkker), Oversigt over byggeklodser.

Skabelon

Udfylder en tekstskabelon med værdier fra andre byggeklodser. Hver pladsholder på formen {variabel} i skabelonteksten bliver til et dynamisk input-felt på noden, og resultatet er den færdige tekst med pladsholderne erstattet.

Inputs

FeltTypeBeskrivelse
SkabelonstrSkabelontekst med {variabel}-pladsholdere. Standardværdi: Hej {name}!.
Dynamiske {felt}-inputsvilkårligÉt input-felt pr. pladsholder i skabelonen (fx {kunde} giver feltet kunde). Værdien konverteres til tekst, inden den indsættes.

Variabelnavne må kun bestå af bogstaver, tal og underscore (\w+), så {kunde_navn} virker, men {kunde-navn} og {kunde navn} genkendes ikke som pladsholdere. En pladsholder uden tilsluttet værdi ændres ikke — den står stadig som {variabel} i resultatet. Referencer til organisationens variabler ({database.KEY}) indeholder et punktum og bliver derfor ikke til input-felter; de erstattes i stedet automatisk, inden noden kører.

Outputs

  • Resultat (str) — den udfyldte skabelontekst.

Typiske brugsscenarier

  • Bygge en prompt til Sprogmodel, hvor faste instruktioner kombineres med dokumenttekst eller udtrukne felter fra tidligere trin.
  • Sammensætte en standardbesked (mail, svar til en borger, notat) med navn, sagsnummer og andre værdier fra flowet.
  • Samle output fra flere byggeklodser i ét tekstafsnit med fast struktur, fx inden det sendes videre til Tekst til dokument.

Brug når / Undlad når

  • Brug når du skal flette dynamiske værdier ind i en fast tekst.
  • Undlad når du skal bygge et struktureret JSON-objekt — brug Kombiner, som giver navngivne felter frem for ren tekst.
  • Undlad når teksten ingen pladsholdere har — brug Tekstinput — eller når du har brug for logik, formatering eller regex — brug Python Kode. Skal teksten genereres eller omskrives, er Sprogmodel det rette valg.

Relaterede byggeklodser: Input-byggeklodser (Tekstinput), Data-byggeklodser (Kombiner, Python Kode), AI-byggeklodser (Sprogmodel), Output-byggeklodser (Tekst til dokument), Overblik over byggeklodser.

Dokumenter

Hent Dokument

Henter markdown-indholdet af ét dokument, der allerede er uploadet til AgentBases dokumentdatabase og OCR-behandlet. Byggeklodsen returnerer kun teksten — ingen metadata (titel, type, tags) følger med.

Inputs

FeltTypeBeskrivelse
DokumentstrDokumentet, der skal hentes. Vælges fra en dropdown, der kun viser dokumenter, du har adgang til; kan også forbindes som en kant med et dokument-UUID.

Outputs

  • Markdown Indhold (str) — dokumentets gemte markdown-indhold som ren tekst.

Adfærd og faldgruber

  • Adgang kontrolleres ved kørsel mod den bruger, der kører flowet — ikke den, der byggede det. Deles et flow med en kollega uden adgang til dokumentet, fejler byggeklodsen for vedkommende med "Ingen adgang til dokument".
  • Kørsler uden brugerkontekst afvises (fail-closed), og et dokument-id, der ikke findes, giver fejlen "Dokument ikke fundet". Et id, der ikke er et gyldigt UUID, afvises som ugyldigt input.
  • Resultatet caches ikke: indholdet slås op i databasen ved hver kørsel, så en ny OCR-behandling af dokumentet slår igennem med det samme.
  • Byggeklodsen kan kaldes fra /chat-orkestratoren (chat-aktiveret).

Typiske brugsscenarier

  • Indlæse en fast overenskomst, kontrakt eller politik som kontekst til en AI-byggeklods, hvor dokumentet er kendt på forhånd og hardkodes i flowet.
  • Sende et gemt dokuments tekst videre til en skabelon eller en tekstbehandlende byggeklods uden at skulle uploade filen igen ved hver kørsel.
  • Hente OCR-teksten fra et referencedokument, som andre inputs i flowet skal sammenlignes mod.

Brug når / Undlad når

  • Brug når: dokumentet allerede ligger i dokumentdatabasen, du kun har brug for teksten, og ét bestemt dokument skal vælges ved konfiguration af flowet.
  • Undlad når: du skal behandle nye filer, der uploades i flowet (brug Dokument-OCR), når du skal iterere over flere dokumenter (brug Dokumentliste sammen med Løkke Start), eller når du har brug for metadata sammen med indholdet (brug Hent Dokument Indhold).
  • Undlad når: dokumentet skal findes dynamisk ud fra en søgetekst — brug Søg Dokumenter eller Slå Dokumenter Op først, og send det fundne id videre.

Relaterede byggeklodser: Input-byggeklodser (Dokumentliste, Søg Dokumenter, Hent Dokument Indhold), AI-byggeklodser (Dokument-OCR, Sprogmodel), Logik-byggeklodser (Løkke Start), Sammenhænge mellem byggeklodser.

Dokumentliste

Lader dig vælge flere dokumenter fra AgentBases dokumentdatabase i en dropdown og sender dem videre som en liste af dokument-ID'er (UUID'er). Byggeklodsen henter ikke selve indholdet — den returnerer præcis den liste af ID'er, du har valgt, uden ændringer.

Inputs

FeltTypeBeskrivelse
Dokumenterlist[str]Vælg de dokumenter der skal behandles. Flervalgs-dropdown over dokumenter i dokumentdatabasen, som du har adgang til. Påkrævet.

Outputs

  • Dokumenter (list[str]): Listen af de valgte dokumenters ID'er (UUID'er), i den rækkefølge de blev valgt. Ikke dokumenternes tekst.

Typiske brugsscenarier

  • Batch-behandling af flere allerede uploadede dokumenter: Dokumentliste → Løkke Start → Hent Dokument → [behandling] → Løkke Slut, hvor Hent Dokument henter hvert dokuments markdown-indhold inde i løkken.
  • Sammenligne eller opsummere et fast udvalg af dokumenter, som er valgt manuelt ved opsætning af flowet.
  • Køre samme udtræk eller klassifikation over en fast dokumentsamling og samle resultaterne på Løkke Slut.

Brug når / Undlad når

  • Brug når du skal behandle flere dokumenter, der allerede ligger i dokumentdatabasen, og udvalget kan fastlægges manuelt i editoren.
  • Undlad når du kun skal bruge ét dokument — brug Hent Dokument direkte uden løkke.
  • Undlad når filerne skal uploades i selve flowet i stedet for at hentes fra databasen — brug en fil-upload-byggeklods (fx Dokument-OCR) i stedet.
  • Undlad når listen af dokument-ID'er kommer fra en anden byggeklods — send den direkte til Løkke Start; Dokumentliste er kun til manuel udvælgelse i brugerfladen.

Relaterede byggeklodser: Hent Dokument og øvrige input-byggeklodser, Løkke Start / Løkke Slut, Dokument-OCR, oversigt over byggeklodser

Hent Dokument Indhold

Henter det fulde markdown-indhold og metadata for ét dokument i dokumentbiblioteket ud fra dets ID (UUID). Byggeklodsen er markeret som chat-værktøj, så en Sprogmodel-node eller /chat-orkestratoren kan kalde den dynamisk — typisk med et ID fundet via Slå Dokumenter Op.

Inputs

FeltTypeBeskrivelse
Dokument-IDstrUUID for det dokument der skal hentes (fx 550e8400-e29b-41d4-a716-446655440000). Påkrævet.

Outputs

  • Dokument JSON (str) — én JSON-streng med felterne document_id, document_name, document_type, year, organization_name, industry, tags (liste) og markdown_content (dokumentets fulde tekst, ikke afkortet). Manglende metadata er null; manglende navn/indhold er tom streng.

Typiske brugsscenarier

  • En AI-agent (Sprogmodel med værktøjer) søger først med Slå Dokumenter Op, vælger et ID fra resultatlisten og henter derefter den fulde tekst her for at besvare et spørgsmål.
  • Et dokument-ID leveres som input til et flow (fx fra en app eller et webhook-kald), og indholdet skal læses ind i en efterfølgende Sprogmodel- eller Skabelon-node.
  • Metadata (type, år, organisation, tags) skal bruges sammen med indholdet, fx til at bygge en kilde-reference i det endelige svar.

Brug når / Undlad når

  • Brug når: du har et dokument-UUID fra et tidligere opslag, eller en agent skal slå dokumenter op under kørslen.
  • Brug når: du har brug for både tekst og metadata som struktureret JSON.
  • Undlad når: dokumentet er kendt på forhånd og kan vælges direkte i noden — brug Hent Dokument i stedet.
  • Undlad når: du vil læse en uploadet fil. Wires en fil ind i Dokument-ID-feltet, afvises kørslen med en fejl ("der blev modtaget en fil, ikke et dokument-ID") — brug Dokument-OCR til uploadede filer.

Adfærd og faldgruber

  • Adgangskontrol håndhæves ved kørsel mod den bruger der kører flowet: findes dokumentet ikke, eller har brugeren ikke adgang, fejler noden med en dansk fejlbesked. Mangler brugerkontekst (fx en kørsel uden bruger), fejler den også — den giver aldrig et tomt resultat i stedet.
  • Et ID der ikke er et gyldigt UUID afvises som valideringsfejl (HTTP 422 på kørselsendpoints), ikke som en kørselsfejl.
  • Resultatet caches ikke (cacheable=false), da det er et live-opslag i databasen under brugerens rettigheder.

Relaterede byggeklodser: Input-byggeklodser (Slå Dokumenter Op, Hent Dokument), AI-byggeklodser (Dokument-OCR, Sprogmodel med værktøjskald), Byggeklods-relationer

Slå Dokumenter Op

Søger i eller lister dokumentbiblioteket og returnerer en JSON-liste med dokument-ID, metadata, relevans og et afkortet indholdsuddrag pr. dokument. Byggeklodsen er designet som værktøj for Sprogmodel-nodens agentiske arbejdsgang (den er chat-aktiveret), men kan også bruges direkte i et flow.

Inputs

FeltTypeBeskrivelse
SøgetekststrTekst der matches (uden forskel på store/små bogstaver) mod dokumentnavn, indhold og tags. Både hele teksten, en variant uden bindestreger og de enkelte ord (op til 8 ord på mindst 2 tegn) bruges som søgetermer, så fx "3F" og "over-enskomst" rammer. Tom tekst lister alle tilgængelige dokumenter. Standard: tom.
Max resultaterintMaksimalt antal dokumenter i svaret (1-50). Standard: 10.

Outputs

  • Dokumentliste JSON (str): en JSON-streng med total_results, search_query (den trimmede søgetekst) og documents — en liste hvor hvert element har document_id, document_name, document_type, year, organization_name, industry, tags, relevance_score og content_preview.

Adfærden afhænger af om der er en søgetekst:

  • Med søgetekst: resultaterne scores og sorteres efter relevans (højeste først, dernæst nyeste), og content_preview er de første 2000 tegn af dokumentets markdown-indhold (efterfulgt af ... hvis der er mere).
  • Uden søgetekst: de tilgængelige dokumenter listes uden scoring (relevance_score er 0.0), og content_preview er kun de første 500 tegn.

Søgningen omfatter kun dokumenter den udførende bruger har adgang til (egne private dokumenter, dokumenter delt med brugerens teams og dokumenter delt med organisationen). Kører byggeklodsen uden en brugerkontekst, fejler den med en fejlbesked frem for at returnere et tomt resultat. Resultatet caches ikke, da det er et live-opslag i biblioteket.

Typiske brugsscenarier

  • En Sprogmodel-node der som værktøj skal finde den rette overenskomst eller standardkontrakt blandt mange dokumenter ud fra en ansættelseskontrakt, og derefter henter det fulde indhold med Hent Dokument Indhold.
  • Liste alle dokumenter i biblioteket som udgangspunkt for videre behandling, fx i en løkke.
  • Slå dokumenter op ud fra et emne eller en organisation (fx "3F" eller "ferieregler"), hvor kun ID'et og et kort uddrag er nødvendigt for at vælge det rigtige dokument.

Brug når / Undlad når

  • Brug når dokumentet ikke er kendt på forhånd og skal findes dynamisk under en kørsel eller samtale.
  • Brug når du kun har brug for ID, metadata og et uddrag — ikke hele teksten.
  • Undlad når du kender dokumentet på forhånd; brug Hent Dokument og vælg det direkte i noden.
  • Undlad når du skal bruge ét bestemt dokuments fulde indhold; brug Hent Dokument Indhold med dokument-ID'et.

Relaterede byggeklodser: Hent Dokument Indhold og Hent Dokument under Input, Sprogmodel under AI; se også oversigten over byggeklodser.

Søg Dokumenter

Søger i organisationens uploadede dokumenter ud fra en søgetekst og/eller et kontekstdokument og returnerer de mest relevante træf som en JSON-liste, rangeret efter relevans-score. Søgningen kører i op til tre runder: en sprogmodel afleder søgeforespørgsler (og omformulerer dem, hvis en runde giver nul træf), hvorefter kandidaterne scores deterministisk mod den oprindelige søgetekst.

Inputs

FeltTypeBeskrivelse
SøgetekststrDet du leder efter: dokumentnavn, nøgleord, organisation/år eller en kort beskrivelse. Tåler variationer som "GLS-A"/"GLS A" og korte akronymer.
Kontekstdokument (valgfri)strEt helt dokument (eller længere tekst); byggeklodsen finder dokumenter med lignende indhold i stedet for at matche på nøgleord.
Søgemetodestrauto (standard), specifik eller kontekstuel. auto vælger specifik når kun søgetekst er udfyldt og kontekstuel når kontekstdokumentet er udfyldt (med eller uden søgetekst). specifik kræver søgetekst; kontekstuel kræver kontekstdokument. Er begge felter tomme, fejler kørslen.
Max resultaterintAntal dokumenter der returneres (1–100, standard 5).
Min. relevans-scorefloatDokumenter med score under tærsklen frasorteres (0–20, standard 0 = ingen filtrering; ca. 3 svarer til mindst ét ord matchet i dokumentnavnet).
Inkludér fuldt dokumentindholdboolStandard false: document_content afkortes til de første ca. 300 tegn efterfulgt af .... Sæt til true for at få hele dokumentteksten med.

Outputs

  • Dokumentliste JSON (str) — et JSON-objekt på formen {"documents": [...]}, hvor hvert element har document_id, document_name, document_content (uddrag eller fuld tekst), document_type, year, organization, tags og relevance_score. Listen er sorteret med højeste score først og indeholder højst "Max resultater" elementer.

Søgningen er begrænset til de dokumenter, den kørende bruger har adgang til (egne, organisationens og teamets). Byggeklodsen kræver derfor en brugerkontekst og fejler med en tydelig fejlbesked, hvis kørslen ikke har én. Resultatet caches ikke — hver kørsel slår op i den aktuelle dokumentsamling.

Typiske brugsscenarier

  • Slå den relevante overenskomst eller aftaletekst op ud fra et navn eller nøgleord ("GLS-A 3F overenskomst") og sende document_id videre til Hent Dokument eller Hent Dokument Indhold for at få hele indholdet.
  • Finde politikker eller vejledninger, der ligner en indsendt henvendelse, ved at give henvendelsen som kontekstdokument.
  • Lade en sprogmodel-byggeklods vælge mellem de fundne dokumenter ud fra navn, tags og uddrag, før hele teksten hentes.
  • Bygge et opslag, hvor en bruger i en app skriver et emne og får en kort liste over matchende dokumenter i organisationens bibliotek.

Brug når / Undlad når

  • Brug når du ikke kender dokumentets id på forhånd, men kan beskrive det med nøgleord, eller har et eksempeldokument at sammenligne med.
  • Brug auto som søgemetode; skift kun, hvis resultaterne reelt ikke er gode nok.
  • Undlad at slå "Inkludér fuldt dokumentindhold" til, hvis dokumenterne kan indeholde følsomme persondata (CPR-numre, adresser, kontonumre), som ikke skal sendes videre i flowet — brug uddraget til at vælge og hent ét dokument ad gangen med Hent Dokument eller Hent Dokument Indhold.
  • Undlad at sætte "Min. relevans-score" højt fra start — det frasorterer let relevante dokumenter med afvigende navngivning.

Relaterede byggeklodser: Input-byggeklodser (Hent Dokument, Hent Dokument Indhold), AI-byggeklodser (Sprogmodel til at udvælge blandt træf), Data-byggeklodser (JSON-udtræk af document_id), Sammenhænge mellem byggeklodser.

Lovgivning og overenskomster

Hent Lovgivning

Henter den fulde tekst af én dansk lov, bekendtgørelse eller lignende fra Retsinformation ud fra lovens år og nummer. Teksten hentes live fra retsinformation-api.dk og returneres som markdown.

Inputs

FeltTypeBeskrivelse
ÅrintLovens år (fx 2026). Tilladt interval 1849–2100.
NummerintLovens nummer inden for året (fx 118). Tilladt interval 1–999999.

Begge felter kan udfyldes fast i byggeklodsen eller forbindes fra en forudgående byggeklods, fx Søg lovgivning, som returnerer år og nummer for hvert match.

Outputs

  • Lovtekst (str) — lovens fulde tekst i markdown-format, som Retsinformation leverer den.

Findes loven ikke (år/nummer matcher intet dokument), fejler byggeklodsen med Lov ikke fundet: {år}/{nummer}. Timeout (30 sekunder) og netværksfejl giver ligeledes en fejl i stedet for et tomt output — byggeklodsen returnerer aldrig en tom tekst stiltiende.

Resultatet caches ikke, da teksten hentes live fra Retsinformation ved hver kørsel.

Typiske brugsscenarier

  • Indlæs en konkret lov som kontekst til en Sprogmodel-byggeklods, der skal besvare juridiske spørgsmål eller vurdere en sag mod lovteksten.
  • Kombinér med Søg lovgivning: søg først på fri tekst, træk år og nummer ud af resultatet, og hent derefter den fulde tekst.
  • Udtræk bestemte paragraffer eller definitioner fra en lov med en efterfølgende Sprogmodel- eller Struktureret output-byggeklods.
  • Gør byggeklodsen tilgængelig som værktøj i chatten, så assistenten selv kan slå en lov op, når brugeren nævner år og nummer.

Brug når / Undlad når

  • Brug når du kender lovens år og nummer, eller får dem fra en forudgående byggeklods.
  • Brug når du har brug for hele lovteksten som grundlag for videre analyse.
  • Undlad når du kun kender lovens navn eller emne — brug Søg lovgivning først til at finde år og nummer.
  • Undlad til egne dokumenter eller udenlandsk lovgivning; byggeklodsen dækker kun dansk lovgivning på Retsinformation.
  • Undlad at forbinde den direkte til en liste af love; den henter én lov pr. kørsel, så brug en løkke, hvis du skal hente flere.
note

En tidligere version af byggeklodsen (v1) havde ét enkelt felt, hvor loven blev valgt fra en søgbar dropdown. Eksisterende flows med den version kører fortsat; nye flows får versionen med separate felter for år og nummer.

Relaterede byggeklodser: Data-byggeklodser (Søg lovgivning), Input-byggeklodser (Søg Dokumenter), AI-byggeklodser (Sprogmodel, Struktureret output), Logik-byggeklodser (løkker til flere love), Oversigt over byggeklodser

Hent overenskomst

Henter den fulde tekst af en dansk overenskomst fra overenskomstdatabasen.dk (/agreements/{agreement_id}/text) ud fra et agreement_id, typisk fundet med Søg overenskomst. Teksten returneres som markdown med overenskomstens titel som overskrift (# <titel>), når API'et leverer en.

Inputs

FeltTypeBeskrivelse
Agreement IDintOverenskomstens ID fra Søg overenskomst (fx 406). Heltal mellem 1 og 99 999 999; kan både indtastes og forbindes via handle.

Outputs

  • Overenskomsttekst (str) — overenskomstens fulde tekst i markdown, indledt med titlen. Byggeklodsen bruger API'ets samlede text-felt; mangler det, sammenføjes de enkelte dokumenters tekst på tværs af versioner med tomme linjer imellem.

Fejl stopper kørslen med en dansk fejlbesked: ukendt ID giver "Overenskomst ikke fundet", andre HTTP-fejl giver Kunne ikke hente overenskomst: <statuskode>, og timeout (30 sekunder), netværksfejl, ugyldigt JSON-svar eller et svar uden tekst giver hver sin besked. Der er ingen tom-streng-fallback — et manglende resultat er altid en fejl.

Resultatet caches ikke (live-opslag mod en ekstern database). Byggeklodsen er chat-aktiveret og kan derfor bruges som værktøj af Sprogmodellen og i /chat.

Typiske brugsscenarier

  • Andet trin efter Søg overenskomst: søg på navn, tag agreement_id fra resultatet, og hent den fulde tekst her.
  • Værktøjskald i en Sprogmodel-agent, der besvarer spørgsmål som "Hvad er opsigelsesvarslet efter 9 års anciennitet?" ved selv at slå overenskomsten op og citere bestemmelsen.
  • Sammenligning af en lønseddel eller ansættelseskontrakt mod den gældende overenskomst, hvor teksten sendes videre til en Sprogmodel eller Struktureret output sammen med sagens dokumenter.
  • Udtræk af bestemte paragraffer (fx satser, tillæg, arbejdstid) fra en kendt overenskomst til videre behandling i flowet.

Brug når / Undlad når

  • Brug når du allerede kender agreement_id, eller når et forudgående Søg overenskomst-trin leverer det.
  • Brug når teksten skal læses af en Sprogmodel som værktøjskald — så udtrækker modellen selv det relevante frem for at få hele teksten som fast input.
  • Undlad når du kun har et navn eller en fagforening og ikke et ID — brug Søg overenskomst først.
  • Undlad at sende outputtet ubearbejdet ind i mange efterfølgende byggeklodser: en samlet overenskomst kan fylde over 1 mio. tegn, så teksten bør uddrages eller filtreres, før den bruges videre.

Relaterede byggeklodser: Data-byggeklodser (Søg overenskomst), Input-byggeklodser, Sprogmodel og AI-byggeklodser, Oversigt over byggeklodser

Billeder

Feeds og overvågning

Læs RSS-feed

Henter et RSS- eller Atom-feed — nyheder, opdateringer, udgivelser — og leverer som standard kun de elementer, byggeklodsen ikke har leveret før. RSS 2.0, Atom og RSS 1.0 (RDF) forstås. Det er byggeklodsen til at overvåge en kilde på en tidsplan.

Inputs

FeltTypeBeskrivelse
Feed-URLstrAdressen på feedet. Kun http:// og https://; kald mod localhost og private IP-adresser blokeres (SSRF-beskyttelse), svar over 5 MB afvises, og hele hentningen har 20 sekunder i alt. Ændrer du adressen, starter hukommelsen forfra.
Maks. antal elementerintHøjst så mange elementer pr. kørsel. Mellem 1 og 200, standard 20. Med Kun nyt indhold slået til tælles kun de nye.
Kun nyt indholdboolStandard: til. Byggeklodsen husker, hvad den har leveret, og returnerer kun det nye. Slået fra er den en ren læsning uden hukommelse.

Outputs

  • Elementer (list): Ét objekt pr. element med title, link, published (ISO 8601, tom hvis datoen ikke kunne læses), published_raw (feedets egen datotekst), id (elementets identitet) og summary (ren tekst uden HTML, højst 2000 tegn).
  • Antal (int): Hvor mange elementer der blev leveret.
  • Feedets titel (str): Feedets egen titel.

Typiske brugsscenarier

  • Overvåg nyheder (DR, Børsen, en styrelse) og lad en Sprogmodel opsummere hver ny artikel.
  • Send en e-mail, når et fagsystems feed udgiver noget nyt.
  • Lad et større flow reagere på nyt indhold uden at behandle det samme igen og igen.

Brug når / Undlad når

  • Brug når: kilden udgiver et feed, og du vil behandle nyt indhold på en tidsplan.
  • Undlad når: du skal læse et JSON-API eller en HTML-side uden feed — brug Hent fra API.
  • Undlad når: byggeklodsen skulle stå inde i en løkke — den afvises, når flowet køres. Sæt den foran Løkke Start.
  • Undlad når: hver kørsel skal se alt — slå Kun nyt indhold fra.

Hukommelse mellem kørsler

Kortet viser striben "Husker mellem kørsler". Det betyder:

  • Første kørsel — også efter en kopi af flowet eller "Nulstil hukommelse" — leverer op til Maks. antal elementer og betaler for dem i de efterfølgende trin.
  • Kun de leverede elementer huskes, så et efterslæb større end Maks. antal hentes over de næste kørsler i stedet for at blive sprunget over.
  • De seneste 500 elementer huskes. Ældre glider ud, og et element ældre end de seneste 500 meldes som nyt igen.
  • Hukommelsen hører til én adresse. Ændrer du Feed-URL, glemmes det gamle feed helt — også dets ETag/Last-Modified og titel. Adressen sammenlignes præcis som den står, så en skråstreg til sidst eller en ekstra parameter er en ny adresse; en adresse, der skifter ved hver kørsel, nulstiller derfor hukommelsen hver gang.
  • Feedets titel huskes forkortet (de første 2000 tegn). Er feedet hentet, er outputtet Feedets titel feedets egen, fulde titel; svarer feedet "ikke ændret", er der ingen titel at hente, og outputtet er den forkortede fra hukommelsen.
  • Identiteten er guid (RSS 2.0), id (Atom) eller rdf:about (RSS 1.0), ellers en hash af link + titel. Et feed, der skriver ny guid ved hver udgivelse, slår genkendelsen fra.
  • Test- og QA-kørsler samt "Kør" på selve byggeklodsen starter altid med tom hukommelse og ændrer ikke, hvad det gemte flow husker.
  • "Nulstil hukommelse" i byggeklodsens værktøjslinje sletter det huskede — se Agent-byggeren.

Sådan overvåger du et feed

  1. Byg flowet: Læs RSS-feed → Løkke StartSprogmodel → Løkke Slut (→ fx Send Email). Feed-byggeklodsen skal stå FORAN Løkke Start, og Elementer forbindes til Løkke Starts data-input.
  2. Udgiv flowet via Udgivelse: send til kvalitetskontrol og udgiv appen.
  3. På appens detaljeside: fanen "Tidsplaner" → "Opret tidsplan" → fx "Hver time". Se Planlagt kørsel under "For eksisterende apps".

Resultatet caches ikke: hver kørsel henter feedet live — med ETag/Last-Modified, så et uændret feed koster ingen båndbredde.

Relaterede byggeklodser: Logik-byggeklodser (Løkke Start/Slut), AI-byggeklodser (Sprogmodel), Output-byggeklodser (Send Email), Planlagt kørsel

Billedgalleri

Byggeklods-id: image-gallery

Lader dig uploade et eller flere billeder direkte i flowet og se dem som miniaturer på noden. Billederne sendes videre uændret som en liste af filer, typisk til Billedgenerering (som referencebilleder) eller Sprogmodel (som vedhæftede filer).

Inputs

FeltTypeBeskrivelse
Billederlist[filejson]Et eller flere billeder (PNG, JPEG, WebP, GIF, HEIC). Kan også modtage billeder fra en anden node. Andre filtyper afvises.

Outputs

  • Billeder (list[filejson]): De uploadede billeder som en liste, i den rækkefølge de blev tilføjet.

Resultatet caches ikke — noden udsender binære filer.

Typiske brugsscenarier

  • Saml referencebilleder til Billedgenerering.
  • Upload fotos og lad Sprogmodel beskrive eller sammenligne dem.
  • Iterér over billeder med en løkke.

Brug når / Undlad når

Brug når:

  • Du vil se de billeder, flowet arbejder med, direkte på lærredet.
  • Flere billeder skal ind i flowet på én gang.

Undlad når:

  • Filerne er dokumenter (PDF, Word, Excel) — brug den enkelte nodes eget filfelt.
  • Billederne skal hentes fra en URL — brug HTTP Forespørgsel.

Bemærk: Miniaturerne vises, mens billederne er i din browser; efter en genindlæsning af siden vises filnavnet i stedet. Billederne er stadig gemt i flowet.

Relaterede byggeklodser: Billedgenerering · AI-byggeklodser · Node-oversigt

Udfaset

Følgende byggeklodser er udfaset og bør ikke bruges i nye flows. De ligger under "Udfaset" i byggeklods-vælgeren og er stadig kørbare i eksisterende flows.

Filliste

Uploader flere filer fra din computer og sender dem videre som én liste, typisk som startpunkt for en løkke der behandler filerne én ad gangen. Byggeklodsen ændrer ikke filerne; den returnerer præcis den liste, der blev uploadet.

Udfaset

Filliste er udfaset og vises under "Udfaset" i byggeklods-vælgeren. Eksisterende flows kører fortsat, men der er ikke udpeget en direkte afløser. I nye flows uploader du filerne direkte i den byggeklods, der skal bruge dem — fx feltet DokumenterSortér dokumenter, som selv tager en liste af filer — eller henter dem fra Dokumenter-biblioteket med Dokumentliste.

Inputs

FeltTypeBeskrivelse
Filerlist[filejson]De filer der skal behandles. Alle filtyper accepteres, og der kan vælges flere ad gangen. Hver fil må højst fylde 50 MB (grænsen deles med dokumentindlæsning og styres af platformens indstilling).

Outputs

  • Filer (list[filejson]): den uploadede liste uændret. Hvert element er et filobjekt med filename, mime_type og data (filindholdet som base64), ikke filens tekstindhold.

Resultatet caches ikke: outputtet er selve filerne, og store binære data gemmes bevidst ikke i node-cachen.

Typiske brugsscenarier

  • Uploade en bunke PDF'er og køre dem gennem Løkke Start → Indlæs dokument for at udtrække tekst fra hver enkelt.
  • Behandle en samling billeder eller scanninger i samme kørsel uden at bygge ét flow pr. fil.
  • Aflevere en liste af blandede filer til en byggeklods der selv tager en liste, fx Sortér dokumenter.

Brug når / Undlad når

  • Brug når: du vedligeholder et eksisterende flow, der allerede bygger på Filliste, og filerne kommer fra brugerens egen computer.
  • Undlad når: du kun skal behandle én fil — upload den direkte i Indlæs dokument eller Fildetaljer uden løkke.
  • Undlad når: filerne allerede ligger i Dokumenter-biblioteket (brug Dokumentliste) eller skal hentes fra en URL (brug HTTP Forespørgsel).

Relaterede byggeklodser: Input-byggeklodser (Dokumentliste, Tekstliste), Logik-byggeklodser (Løkke Start / Løkke Slut), AI-byggeklodser (Indlæs dokument, Sortér dokumenter), Data-byggeklodser (HTTP Forespørgsel), Sammenhænge mellem byggeklodser

Tekstliste

Opretter en liste af manuelt indtastede tekststrenge og sender den uændret videre som ét list[str]-output. Byggeklodsen har ingen indgående forbindelser og er tænkt som startpunkt for en løkke, hvor hvert element behandles ét ad gangen.

Udfaset

Tekstliste er markeret som udfaset og findes under kategorien "Udfaset" i byggeklods-vælgeren. Eksisterende flows, der bruger den, kører stadig, men der er ikke angivet en direkte erstatning. Brug i stedet et almindeligt tekstinput til enkeltværdier, eller lad Løkke Start iterere direkte over en liste fra en anden byggeklods (se Logik).

Inputs

FeltTypeBeskrivelse
Elementerlist[str]De tekstelementer der skal behandles. Redigeres i en liste af tekstfelter ("Element 1", "Element 2", …); mindst ét element er påkrævet.

Outputs

  • Elementer (list[str]) — nøjagtig samme liste som blev indtastet, i samme rækkefølge. Byggeklodsen filtrerer, trimmer eller dedublerer ikke.

Typiske brugsscenarier

  • Køre den samme prompt over en fast liste af emner (fx tre produktnavne) via Løkke Start → Sprogmodel → Løkke Slut.
  • Teste et flow med et lille, håndskrevet sæt af inputtekster, før det kobles til rigtige data.
  • Fodre en løkke med en statisk liste af søgeord eller kategorier, der ikke ændrer sig mellem kørsler.

Brug når / Undlad når

  • Brug når listen er kort, kendt på forhånd og skal skrives ind manuelt i editoren.
  • Undlad når du kun har én tekst — et almindeligt tekstinput er enklere.
  • Undlad når teksterne kommer fra dynamiske data (JSON, output fra en anden byggeklods, linjer i én tekst) — forbind da kilden direkte til Løkke Start, eventuelt efter en Python Kode-node der splitter teksten.
  • Undlad når elementerne er filer eller dokumenter — brug Filliste eller Dokumentliste i stedet.

Resultatet caches som andre byggeklodser; da outputtet er identisk med inputtet, har det ingen praktisk betydning.

Relaterede byggeklodser: Input (Filliste, Dokumentliste, Tekstinput), Logik (Løkke Start / Løkke Slut), Data (Python Kode), Oversigt

Typiske kæder

  • Fast tekst eller prompt: Tekstinput eller Skabelon → Sprogmodel
  • Ét kendt dokument: Hent Dokument → Sprogmodel eller Skabelon
  • Dokument fundet ud fra nøgleord: Søg Dokumenter → Data (udtræk document_id) → Hent Dokument → Sprogmodel
  • Agentisk opslag: En Sprogmodel-agent med Slå Dokumenter Op og Hent Dokument Indhold som værktøjer
  • Jura: Søg lovgivning (Data) → Hent Lovgivning → Sprogmodel; Søg overenskomst (Data) → Hent overenskomst → Sprogmodel
  • Overvågning: Læs RSS-feed → Løkke StartSprogmodel → Løkke Slut → Send Email, kørt på en tidsplan

Batch-behandling af flere dokumenter følger typisk denne kæde:

Relaterede sider