Avatarnorge Agent Kit · En gratis AI-agent du kjører selv

01 / Slik bruker du det

Fra zip-fil til din egen agent. I fire steg.

Ingen konto å opprette og ingenting å koble til. Det kjører på din egen maskin fra første minutt, og du kan lese hver eneste linje av det.

STEG 1

Last det ned

Legg igjen navn og e-post, så havner zip-filen i innboksen din. Pakk den ut der du pleier å ha prosjektene dine.

STEG 2

Få det i gang

Fire kommandoer i et terminalvindu, og én API-nøkkel limt inn i en tekstfil. Åpne localhost:8000, så snakker du allerede med den.

STEG 3

Gi det til AI-en din

Åpne mappen med Claude, ChatGPT, Codex eller Cursor og fortell hva du vil at agenten din skal gjøre. Kittet inneholder filen de assistentene leser, så den kommer inn velvitende om hvor alt ligger.

STEG 4

Gjør det til ditt

Skriv om hvem agenten er, legg til verktøyene som når dine egne data, og kjør testene. Du redigerer, du lagrer, og neste melding oppfører seg allerede annerledes.

Ingenting å melde seg på og ingenting å si opp. Last det ned, kjør det, og hvis det ikke er noe for deg, slett mappen.

02 / Hva dette er

En agent du kjører selv. På din egen nøkkel.

Den snakker, den husker hvem den snakker med, og den kan bruke verktøy: slå opp noe, sjekke en ordre, lese dataene dine. Den kommer med en lokal playground så du kan se den jobbe i stedet for å ta noens ord for det.

Den husker

Samtalen lagres og sendes med i hvert kall, så den vet hva som ble sagt tre meldinger tilbake. SQLite på maskinen din, Postgres når det er på tide.

Den bruker verktøy

Et verktøy er en helt vanlig Python-funksjon den kan velge å kalle. Ett følger med og det er ekte: spør hva været er i en hvilken som helst by, så går den ut og henter det.

Den er ikke låst til noen

Claude, OpenAI eller Gemini, byttet fra en nedtrekksmeny mens den kjører. Én nøkkel fra én av dem er nok til å starte.

Kittet kommer med en playground, så du kan snakke med agenten din på din egen maskin. Å koble den til en kanal, chatten på nettsiden din, Messenger, Instagram eller innboksen din, er en egen jobb og den er din å bygge. Kittet kommer ikke med noen kanal inni.

03 / Playground

Playgroundet

Det kjører i nettleseren din, på din egen maskin, og det oppfører seg som en ekte innboks.

Den venter før den svarer

Folk skriver ikke ett ryddig avsnitt. De skriver "hei", så "kjapt spørsmål", så "om prisen". Den venter 2,5 sekunder med stillhet, slår dem sammen og svarer én gang.

Den svarer i korte bobler

Med "skriver…" og en pause mellom dem, i stedet for å slippe en vegg av tekst på noen.

Du kan legge ved et bilde

Som er måten du finner ut om agenten din faktisk klarer å lese et skjermbilde eller et bilde av en ødelagt vare.

Den viser hva den brukte

Modell, tokens og hvilke verktøy den kalte, under hvert svar. Agenten din har beskjed om aldri å nevne verktøyene sine, så den linjen er eneste måte å skille et svar som faktisk slo opp noe fra et modellen fant på selv.

Du bytter modell live

Listen hentes fra leverandøren i stedet for å være skrevet for hånd, så en modell som kom ut i morges ligger i menyen i morges.

Du skriver den om mens den kjører

Systemprompten ligger ved siden av chatten. Rediger den, lagre, og neste melding oppfører seg allerede annerledes. Ingenting starter på nytt.

04 / Verktøyene

Et verktøy er en Python-funksjon. Ikke noe mer enn det.

Å snakke er den enkle delen. Verktøy er det som lar agenten din sjekke en ordre, slå opp hva som er ledig, lese prislisten din eller opprette en sak, i stedet for å gjette. De ligger alle i én fil, og sånn ser ett ut.

src/agent/tools.py

@tool
def weather(place: str) -> str:
    """Tells you the weather right now in a city.

    Use it when you are asked about the weather, the temperature,
    whether it is raining, whether it is cold or warm.

    Args:
        place: The city, ideally with the country.
    """
    # koden din: kall et API, spør databasen din, les en fil

Beskrivelsen er grensesnittet

Den grønne teksten er ikke dokumentasjon for deg. Den er det eneste modellen leser for å avgjøre om den skal kalle dette verktøyet og hva den skal sende det. Skriv den vagt, og du får en agent som kaller feil ting på feil tidspunkt.

En liste bestemmer hva som finnes

Nederst i filen ligger listen over verktøyene agenten kan se. En funksjon som ikke står der finnes ikke for agenten, og å ta en av listen er måten du pensjonerer den på uten å slette noe.

Ett følger med, og det er ekte

Spør agenten din hva været er i en hvilken som helst by, så går den ut og kommer tilbake med dagens tall. Det trenger ingen konto og ingen egen nøkkel, så et verktøy virker første gang du kjører kittet. Les det, og slett det så.

Slett eksempelet så snart du skriver ditt eget, og ikke bare for ryddighetens skyld. Hvert verktøy du har med beskrives for modellen i hver eneste melding, så ett du aldri kaller er tokens brukt for alltid. En agent som svarer på spørsmål om ordrer har ingenting med et værverktøy å gjøre.

05 / Prompten

Prompten er agenten. Resten er rørlegging.

Rammeverket flytter meldinger rundt. Hva agenten din faktisk gjør, hvordan den høres ut og hvor godt den gjør jobben sin, kommer alt sammen ut av én tekstfil. Du redigerer den i playgroundet, du lagrer, og neste melding oppfører seg allerede annerledes.

prompts/system.md

# Role
Hvem den er. Identitet, tone, språk.

# Task
Jobben. Hva den er der for å få gjort.

# Tools
Når den skal bruke hvert enkelt, og når ikke.

# Context
Bedriften din. Åpningstider, priser, regler, alt den trenger å vite.

# Examples
Ekte spørsmål med svaret du vil ha, ord for ord.

# Response format
Hvor langt, hvor mange meldinger, hva den aldri skriver.

# Hard rules
Grensene den ikke går over. Sist, fordi det siste veier tyngst.

Det er ikke fritekst

Det samme skjelettet fungerer for hver agent, uansett jobb. Bare innholdet endrer seg fra en til neste, så når du først har skrevet én kan du skrive den neste på en ettermiddag.

Eksempler slår regler

"Hvis de spør om en pris du ikke har, svar sånn: ..." er verdt mer enn tre avsnitt som beskriver tonen du vil ha. Vis den svaret i stedet for å beskrive det.

Rekkefølgen betyr noe

Den går fra det generelle til det som ikke er forhandlingsbart, fordi det siste en modell leser veier tyngre enn det første. Derfor ligger de harde reglene nederst.

Du starter ikke med blanke ark. Kittet kommer med en komplett agent skrevet i denne strukturen, ved siden av et dokument som går gjennom strukturen del for del. Les de to ved siden av hverandre, og bytt så ut eksempelet med din egen bedrift.

06 / Før du starter

Hva du trenger. Og hvem som tar den vanskelige delen sammen med deg.

Én ting å installere, én nøkkel, og AI-assistenten du allerede bruker. Ingenting å melde seg på hos oss, og ingenting å koble til.

Python

Versjon 3.11 eller nyere, gratis fra python.org. På Windows huker du av "Add python.exe to PATH" på første skjerm i installasjonen, så er du ferdig med den.

Én API-nøkkel

Fra Claude, OpenAI eller Gemini, den du allerede bruker. Én er nok, og du bytter mellom dem senere fra en nedtrekksmeny. Agenten kjører på din nøkkel, så det den bruker havner på din konto og ikke på vår.

AI-assistenten din

Claude, ChatGPT, Codex, Cursor, den du bruker. Kittet kommer med filen de assistentene leser før de rører et prosjekt, så den vet allerede hvor alt ligger: hvilken fil som holder personligheten, hvor verktøylisten er, hva den ikke skal røre, og fellene som kostet oss tid.

Åpne mappen med assistenten din og fortell den hva du vil at agenten din skal gjøre. Så spørsmålet er ikke om du kan kode. Det er om du klarer å beskrive jobben du vil ha gjort.

07 / Spørsmål

Det folk spør om før de laster det ned.

Ja. Vi spør om navn og e-post fordi kittet kommer på e-post.

Du må klare å kjøre fire kommandoer og åpne en tekstfil. Utover det er kittet skrevet for å gis til en kodeassistent sammen med en beskrivelse av hva du vil at agenten din skal gjøre.

Ja på begge. MIT-lisens. Eneste betingelse er at lisensteksten følger med.

Ja. Det er Python, så det kjører likt på Mac, Windows og Linux, og instruksjonene inni gir deg kommandoene for hver av dem. Én Mac-detalj verdt å vite: innstillingsfilen begynner med punktum, så Finder skjuler den. Trykk Cmd + Shift + . for å vise den, eller åpne den fra editoren din.

Selve kittet koster ingenting. Det kaller leverandøren din med din nøkkel, så det den bruker havner på din konto. Det er nettopp derfor tokenbruken står under hvert svar.

Ja. Når vi slipper en viktig oppdatering sender vi deg den nye versjonen, til den samme e-postadressen du ga oss. Og hvis du står fast eller noe er uklart, skriv til hello@avatarnorge.no, så svarer vi.

Hvor skal vi sende det?

Kittet kommer som en zip-fil, i én e-post.

✓

Sendt.

Den er på vei. Se etter en e-post fra hello@avatarnorge.no, og sjekk søppelposten hvis den ikke er der om noen minutter.

Direkte kontakt

Vil du hellerbare skrive til oss?

Fortell oss hvordan bedriften din er og hva du trenger, så tar vi kontakt.

hello@avatarnorge.no

Bygg din egen AI-agent.
Gratis.