AGENTER.DK
Agenter.dk
Henter indhold…
Opret en agent, send en opgave, og hent resultatet via API. Samme konto og forbrugsgrænser som på Agenter.dk.
Log ind for at oprette en nøgle til dit serversystem.
Log indTre aktive nøgler · 60 kald/minut pr. nøgle. Nøglen gælder den valgte organisation og udløber senest efter 90 dage. Ændrede loginregler kræver en ny nøgle. Udskiftning tilbagekalder den gamle nøgle med det samme. Hold den på din server.
API-kørsler bruger organisationens modelforbindelser og de samme forbrugsgrænser som opgaver startet i appen. Du kan pause nye kørsler i din konto.
Se de aktuelle kvoter for kørsler, samtidighed og tokens under Forbrug. API-adgang ophæver ingen af grænserne.
Se dit forbrugAgentkørsel kræver, at EU-motoren er tilsluttet. Et utilgængeligt system svarer med 503.
# Gem API-nøglen som AGENTER_API_KEY på din server.
# 1. Opret agent
curl https://agenter-dk.zekj.chatgpt.site/api/v1/agents \
-H "Authorization: Bearer $AGENTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Mødeforbereder","goal":"Forbered salgsmøder","instructions":"Lav et kort brief. Angiv manglende oplysninger."}'
# 2. Start opgave. Brug samme UUID ved gentagelse af kaldet.
curl https://agenter-dk.zekj.chatgpt.site/api/v1/runs \
-H "Authorization: Bearer $AGENTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"key":"<UUID>","agentId":"<agent.id>","input":"Vi mødes med…"}'
# 3. Hent resultat og forbrug
curl 'https://agenter-dk.zekj.chatgpt.site/api/v1/runs?id=<run.id>' \
-H "Authorization: Bearer $AGENTER_API_KEY"POST /runs returnerer 202 og et kørsels-id. Hent status med GET, fx hvert tredje sekund, indtil completed, failed eller stopped. Ved et usikkert forbindelsesbrud tæller reservationen fortsat med i budgettet.
En harness er det system, der styrer agentens arbejdsgang. Med API’et kan dit system i dag starte en hel kørsel på Agenter.dk og hente resultatet. Du kan også hente agentens gemte definition og bruge den som grundlag i dit eget system.
En kommende modelgateway skal lade din harness beholde arbejdsgangen, mens modelkaldene går gennem Agenter.dk. Din harness sender agentens id og opgaven; Agenter.dk indsætter den gemte versions systeminstruktioner og måler forbruget. Direkte modelkald fra en ekstern harness er endnu ikke understøttet af vores API-nøgler.
En hentet definition kan ændres lokalt. Central styring af instruktionerne kræver, at modelkaldene går gennem vores gateway. Lokale værktøjer og handlinger styres fortsat af din harness.
GET /api/v1/agents | Liste eller én agent med ?id= |
|---|---|
POST /api/v1/agents | Opret med name, goal og instructions |
PATCH /api/v1/agents?id= | Opdatér med revision og komplet definition |
DELETE /api/v1/agents?id= | Slet agent og revisioner |
POST /api/v1/runs | Start med key (UUID), input og agentId eller definition |
GET /api/v1/runs | Seneste kørsler og aktive opgaver inden for nøglens adgang; ?id= henter én |
DELETE /api/v1/runs?id= | Anmod om stop; afvent terminal status |
Beløb angives i micro-euro: 1.000.000 = 1 euro. cost er null, mens en kørsel ikke er afsluttet; reserved tæller da med. inputTokens, outputTokens og calls viser udbyderens rapporterede forbrug.
400: ugyldigt input · 401: manglende/tilbagekaldt nøgle · 404: ukendt agent/kørsel · 409: budget, kvote eller revision · 413: for stort input · 429: for mange API-kald · 503: utilgængelig tjeneste. Brug samme key og payload ved gentagelse; en key genbruges aldrig til en ny opgave.
API v1 bruger Bearer-godkendelse fra server til server. Browseradgang med CORS er ikke aktiveret. Eksterne værktøjer er ikke tilkoblet i denne version.