Kjør AgenticOS på Stav

AgenticOS er en plattform med åpen kildekode for å bygge og kjøre KI-agenter på dine egne servere. Agentene chatter, bruker verktøy, kjører kode og søker i kunnskapsbaser. Siden versjon 1.41.0 er Stav.ai en av modell-leverandørene, med valg av region på hver modell.

Ved å peke den mot Stav trekkes hver runde agenten gjør fra Stav-kreditten din, vises i forespørselsloggen og følger reglene i arbeidsområdet ditt. Velger du Kun EU på en modell, vil forespørslene skje med beregning i EU, eller avvises.

Testet med AgenticOS 1.43.0 mot Stav-API-et, installert med hurtigstart-skriptet i Docker. Tidligere versjoner dekkes under AgenticOS før 1.41.

Før du starter

• En Stav-API-nøkkel. Se Autentisering. Gi den tilgangen inference:chat, og inference:models slik at AgenticOS kan vise modellene.
• AgenticOS 1.41.0 eller nyere. Se hurtigstarten. Du kan starte den med --provider none og legge til Stav etterpå.

Kjøre AgenticOS på en server, ikke på localhost

Når folk bruker AgenticOS via et vertsnavn, må du sette PUBLIC_API_URL, PUBLIC_WS_URL, PUBLIC_SITE_URL, FRONTEND_URL og CORS_ORIGINS i .env-filen. Kjør hurtigstarten først, legg deretter til disse og kjør docker compose up -d. Hurtigstarten skriver bare SECRET_KEY og VAULT_MASTER_KEY når den oppretter .env selv. Hvis filen allerede finnes, startes løsningen uten disse, og hvelvet kan ikke åpne nøklene det lagrer.

Hvis det allerede har skjedd, må du legge til begge nøklene og deretter installere på nytt på en tom database. En nøkkel som er lagret uten disse, kan ikke leses med dem:

cd ~/agenticos   # mappen med docker-compose.yml og .env
printf 'SECRET_KEY=%s\nVAULT_MASTER_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" >> .env
docker compose down -v   # sletter AgenticOS-dataene
curl -fsSL https://raw.githubusercontent.com/vstorm-co/agenticos/main/scripts/quickstart.sh | bash -s -- --yes --provider none --dir .
docker compose exec app agenticos cmd doctor   # skal ende med "Everything this can check is working."

Slik setter du det opp

I AgenticOS er en modell en modellprofil: en leverandør, en modell-ID, en nøkkel fra hvelvet og, for Stav, en region. Åpne en agent, gå til modellen dens og velg Legg til modell. Fyll ut:

• Modellisten kommer fra Stav. AgenticOS leser den fra https://api.stav.ai/v1/models med en Stav-nøkkel fra hvelvet ditt.
• Du velger ikke API selv. Stav oppgir hvilket API som betjener hver modell. AgenticOS bruker Chat Completions der modellen har det, og Responses-APIet for de få modellene som bare betjenes der, som openai/o3-pro. Skjemaet viser hvilken som ble valgt.
• La «Endepunkt» stå tomt. Det brukes bare for et regionalt endepunkt eller et testendepunkt hos Stav.

Samme profil via AgenticOS-APIet:

curl -X POST http://localhost:8000/api/v1/providers/model-profiles \
  -H "Authorization: Bearer $AGENTICOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Stav DeepSeek V4 Flash (EU)",
    "provider": "stav",
    "model": "deepseek-ai/deepseek-v4-flash-0731",
    "secret_id": "<vault secret id of your Stav key>",
    "region": "eu"
  }'

Deretter publiserer du agenten og sender den en melding.

Velg hvor forespørsler skal kjøre: EU, EØS eller globalt

Regionen i profilen sendes til Stav som en X-Stav-Runs-In-header på hver forespørsel. Stav svarer da bare fra leverandørendepunkter som har beregning der, gjør automatisk bytte bare innenfor regionen, og avviser en forespørsel som ikke kan betjenes der. Global sender ingen header, så bare reglene for arbeidsområdet ditt gjelder. En region kan bare snevre inn reglene for arbeidsområdet, aldri utvide dem.

• EU only er standard. En profil som lagres uten region, kjører i EU.
• Profilinnstillingene kan ikke overstyre dette. AgenticOS setter headeren på hver forespørsel selv, så extra_headers eller extra_body i profilens params flytter ikke en EU- eller EØS-profil ut av regionen sin.
• Modellisten filtreres ikke etter region. Den viser alle modeller nøkkelen din har tilgang til. Hvis en modell ikke har noen leverandørendepunkter i regionen, avvises forespørselen med HTTP 403 (se Feilsøking). For å se hvilke modeller som har beregning i EU, kan du filtrere modellkatalogen på beregningsregion.

Opprett én profil per region du vil tilby, for eksempel Stav auto (EU) og Stav auto (global), og velg mellom dem per agent. Forespørselsloggen viser regionen for hver forespørsel, og opplyser at den kom fra headeren. Se Velg hvor en forespørsel kjører.

Bruk Anthropic-API-et i stedet

AgenticOS kan også snakke med Stav via Anthropic Messages-API-et. Stav oversetter dette for alle modeller, ikke bare Claude. Denne profilen har ikke noe felt for region, så sett beregningsregion i arbeidsområdets regler hvis alt må bli værende i EU (se Velg en modell).

Anthropic-SDK-en legger til /v1/messages selv. Gi nøkkelen tilgangen inference:messages i tillegg.

Én nøkkel, én oppføring i hvelvet per leverandør

En hvelvnøkkel i AgenticOS tilhører én leverandør. For å bruke Stav gjennom både Stav.ai- og Anthropic-leverandøren, må du lagre den samme Stav-nøkkelen to ganger: én gang for Stav.ai og én gang for Anthropic.

Velg en modell

På en Global profil kan auto velge en Claude- eller GPT-modell. I testen vår valgte den anthropic/claude-sonnet-5-5 for en agentrunde med verktøy.

For å beholde alt i EU for alle apper, sett beregningsregion til Kun EU i Arbeidsområdet ditt → Styr → Nøkkelpolicy → Rekkevidde. Dette gjelder for hver forespørsel fra hver nøkkel, inkludert auto, modeller du navngir, og profiler lagret som Global. Se Slik håndhever du et suverenitetsgulv.## Knowledge bases

AgenticOS kan ikke sende embeddinger for knowledge-base til Stav ennå. Innstillingene for embedding tar bare et egendefinert endepunkt for én leverandør som kjører selv, og Stav står ikke på listen. Du må derfor utføre embedding for knowledge-bases med en av embeddingleverandørene AgenticOS fører opp. Hvis dokumentene dine må bli i EU, kan du bruke Ollama-leverandøren på ditt eget nettverk.

Agenter som søker i en knowledge-base, svarer fortsatt gjennom Stav.

Dette fungerer

Bildegenerering, tale, nettsøk og andre egenskaper som har egne leverandørinnstillinger, er ikke testet med Stav.

Forbruk

AgenticOS kjenner ikke prisene til Stav, så hver kjøring vises med en kostnad på 0. AgenticOS' egne budsjetter for agenter kan ikke se hva du bruker. Sett heller et forbrukstak på Stav-nøkkelen under Arbeidsområdet ditt → Koble til → API-nøkler. Taket gjelder for hver forespørsel nøkkelen gjør.

Hver runde for en agent sender også AgenticOS' egne instrukser og verktøydefinisjoner før meldingen din. I AgenticOS 1.43.0 utgjorde dette omtrent 57 000 inndatatoken for et spørsmål på én linje med standardagenten (omtrent 2 000 i 1.31.3). På en dyr modell utgjør dette mesteparten av kostnaden: én runde med «Reply with exactly: pong» på openai/o3-pro kostet omtrent 0,75 €. Gi agenter bare egenskapene de trenger, og velg en modell med lav pris på inndata.

AgenticOS før 1.41

Eldre versjoner har ingen Stav.ai-leverandør. Bruk OpenAI-leverandøren med base-URL https://api.stav.ai/v1 (behold /v1), skriv inn modell-ID-en manuelt, og la API stå på Chat Completions. Det finnes ikke noe regionsfelt: sett dette via AgenticOS-API-et som "params": {"extra_headers": {"X-Stav-Runs-In": "eu"}} på profilen. params erstattes i sin helhet når den endres, så husk å ta med headeren hver gang du redigerer, eller oppgrader til 1.41 eller nyere.

Feilsøking

Flere feilkoder: Feil.

Kontroller at det fungerte

Åpne Arbeidsområdet ditt → Overvåk → Forespørselslogg. Hvert modellkall er én rad, med modell, inferensleverandør, land og kostnad. En runde for en agent med et verktøy er to rader: verktøykall og svar. Se Forespørselslogg og promptinnsamling.