Kør AgenticOS på Stav

AgenticOS er en open source-platform til at bygge og køre AI-agenter på dine egne servere. Dens agenter chatter, foretager verktøykald, kører kode og søger i vidensdatabaser. Siden version 1.41.0 har Stav.ai været en af dens modeludbydere, med en region på hver model.\n\nNår du peger den mod Stav, trækkes hver runde fra dine Stav-kredit, vises i din forespørgselslog og følger dit arbejdsområdes regler. Vælg Kun EU på en model, så kører dens forespørgsler på beregning i EU eller afvises.\n\nTestet med AgenticOS 1.43.0 mod Stav-API'et, installeret med dens quickstart-script i Docker. Tidligere versioner er dækket under AgenticOS før 1.41.\n\n## Før du starter\n\n- En Stav-API-nøgle. Se Autentificering. Giv den adgangen inference:chat og inference:models, så AgenticOS kan indlæse modellerne.\n- AgenticOS 1.41.0 eller nyere. Se dens quickstart. Du kan starte den med --provider none og tilføje Stav bagefter.\n\n### Kørsel af AgenticOS på en server, ikke på localhost\n\nNår brugere tilgår AgenticOS via et værtsnavn, skal du indstille PUBLIC_API_URL, PUBLIC_WS_URL, PUBLIC_SITE_URL, FRONTEND_URL og CORS_ORIGINS i dens .env. Kør quickstart først, tilføj derefter disse og kør docker compose up -d. Quickstart skriver kun SECRET_KEY og VAULT_MASTER_KEY, når den selv opretter .env. Hvis filen allerede findes, startes løsningen uden dem, og boksen kan ikke åbne de nøgler, den gemmer.\n\nHvis det allerede er sket, skal du tilføje begge nøgler og derefter geninstallere på en tom database. En nøgle gemt uden dem kan ikke læses med dem:\n\nbash\ncd ~/agenticos # mappen med docker-compose.yml og .env\nprintf 'SECRET_KEY=%s\\nVAULT_MASTER_KEY=%s\\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" >> .env\ndocker compose down -v # sletter AgenticOS-dataene\ncurl -fsSL https://raw.githubusercontent.com/vstorm-co/agenticos/main/scripts/quickstart.sh | bash -s -- --yes --provider none --dir .\ndocker compose exec app agenticos cmd doctor # bør slutte med "Everything this can check is working."\n\n\n## Sådan gør du

I AgenticOS er en model en modelprofil: en leverandør, et model-id, en nøgle fra din vault og, for Stav, en region. Åbn en agent, gå til dens model, og vælg Tilføj model. Udfyld:

• Modellisten kommer fra Stav. AgenticOS læser den fra https://api.stav.ai/v1/models med en Stav-nøgle fra din vault.
• Der skal ikke vælges et API. Stav bestemmer, hvilket API der betjener hver model. AgenticOS bruger Chat Completions, hvor modellen understøtter det, og Responses-API'et til de få modeller, der kun betjenes der, som f.eks. openai/o3-pro. Formularen viser, hvilket API der blev valgt.
• Lad Endepunkt være tomt. Det er kun til et regionalt endepunkt eller et testendepunkt hos Stav.

Den samme profil via AgenticOS-API'et:

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"
  }'

Udgiv derefter agenten, og send den en besked.

Vælg, hvor forespørgsler kører: EU, EØS eller globalt

Regionen på profilen sendes til Stav som headeren X-Stav-Runs-In på hver forespørgsel. Stav svarer derefter kun fra leverandørendepunkter, der har beregning der, foretager kun automatisk skift inden for regionen og afviser en forespørgsel, der ikke kan betjenes der. Global sender ingen header, så kun dit arbejdsområdes regler gælder. En region kan kun indsnævre dit arbejdsområdes regler, aldrig udvide dem.

• EU only er standard. En profil, der gemmes uden en region, kører i EU.
• Profilens indstillinger kan ikke ændre det. AgenticOS sætter selv headeren på hver forespørgsel, så extra_headers eller extra_body i profilens params flytter ikke en EU- eller EØS-profil ud af dens region.
• Modellisten filtreres ikke efter region. Den viser alle modeller, din nøgle har adgang til. Hvis en model ikke har et leverandørendepunkt i regionen, afvises kørslen med HTTP 403 (se Fejlfinding). For at se, hvilke modeller der har beregning i EU, kan du filtrere modelkataloget på beregningsregion.

Opret én profil per region, du vil tilbyde, for eksempel Stav auto (EU) og Stav auto (global), og vælg mellem dem per agent. Forespørgselsloggen viser regionen for hver forespørgsel og angiver, at den kom fra headeren. Se Vælg, hvor en forespørgsel kører.

Brug Anthropic-API'et i stedet

AgenticOS kan også tale med Stav via Anthropic Messages-API'et. Stav oversætter det til alle modeller, ikke kun Claude. Denne profil har intet felt til region, så indstil Beregningsregion i dit arbejdsområdes regler, hvis den skal blive i EU (se Vælg en model).

Anthropic-SDK'et tilføjer selv /v1/messages. Giv også nøglen adgangen inference:messages.

Én nøgle, én boksindgang per leverandør

En boksnøgle i AgenticOS hører til én leverandør. For at bruge Stav gennem både Stav.ai- og Anthropic-leverandøren skal du gemme den samme Stav-nøgle to gange: én gang til Stav.ai og én gang til Anthropic.

Vælg en model

På en Global profil kan auto vælge en Claude- eller GPT-model. I vores test valgte den anthropic/claude-sonnet-5-5 til en agent-runde med værktøjer.

For at beholde alt i EU for alle apps skal du indstille Beregningsregion til Kun EU under Dit arbejdsområde → Styr → Nøglepolicy → Rækkevidde. Det gælder for alle forespørgsler fra alle nøgler, inklusive auto, modeller du navngiver, og profiler gemt som Global. Se Håndhæv et bundniveau for suverænitet.## Knowledge bases

AgenticOS kan endnu ikke sende embeddings til knowledge bases til Stav. Indstillingerne for embeddings bruger et brugerdefineret endepunkt for kun én leverandør, og Stav er ikke på listen. Foretag embedding af knowledge bases med en af de leverandører, AgenticOS lister. Hvis dine dokumenter skal blive i EU, kan du bruge deres Ollama-leverandør på dit eget netværk.

Agenter, der søger i en knowledge base, svarer stadig gennem Stav.

Hvad der virker

Billedgenerering, tale, web-research og de andre egenskaber, der har deres egne leverandørindstillinger, er ikke testet med Stav.

Forbrug

AgenticOS kender ikke Stavs priser, så hver kørsel vises med en pris på 0. Dets egne agentbudgetter kan ikke se, hvad du bruger. Sæt i stedet et forbrugsloft på Stav-nøglen under Dit arbejdsområde → Forbind → API-nøgler. Loftet gælder for hver forespørgsel, nøglen foretager.

Hver runde med en agent sender også AgenticOS' egne instruktioner og værktøjsdefinitioner før din besked. I AgenticOS 1.43.0 svarede det til ca. 57.000 inddata-tokens for et spørgsmål på én linje med standardagenten (ca. 2.000 i 1.31.3). På en dyr model udgør dette størstedelen af prisen: én runde med "Reply with exactly: pong" på openai/o3-pro kostede ca. 0,75 €. Giv kun agenter de egenskaber, de har brug for, og vælg en model med en lav pris på inddata.

AgenticOS før 1.41

Ældre versioner har ikke Stav.ai som leverandør. Brug OpenAI-leverandøren med base-URL https://api.stav.ai/v1 (behold /v1), skriv model-id'et, og lad API stå på Chat Completions. Der er intet regionsfelt: Indstil det via AgenticOS-API'et som "params": {"extra_headers": {"X-Stav-Runs-In": "eu"}} på profilen. params erstattes som en helhed, når det ændres, så husk at inkludere headeren igen ved hver redigering, eller opgrader til 1.41 eller nyere.

Fejlfinding

Flere fejlkoder: Fejl.

Kontrollér, at det virker

Åbn Dit arbejdsområde → Overvåg → Forespørgselslog. Hvert modelkald er én række med model, inferensleverandør, land og pris. En runde med en agent, der bruger et værktøj, er to rækker: værktøjskaldet og svaret. Se Forespørgselslog og promptcaching.