Web-API

Styr dine agenter fra dine egne scripts.

AgentX' web-API er et JSON-API, som du bruger til at oprette og styre dine agenter fra dine egne scripts og værktøjer. Det ser alle agenter på alle de daemons, du har tilknyttet, ligesom din konsol.

Lad din kodeagent skrive kaldene

Anbefalet

Indsæt denne prompt i Claude Code, Codex eller en anden kodeagent. Den læser API-vejledningen, hjælper dig med at sætte et token op uden selv at se det, og skriver kaldene sammen med dig. Den spørger dig, hvad du vil have gjort.

Hjælp mig med at bruge AgentX' web-API fra denne computer.
Læs https://www.agentxhq.com/api.md og følg den.
Spørg mig derefter, hvad mine agenter skal gøre, og foreslå et par eksempler.

API-vejledning til AI-assistenter (api.md) →OpenAPI-beskrivelse (openapi.json) →

Det kan API'et.

Liste dine agenter og chats på tværs af alle daemons.
Sende en besked til en agent og læse svaret.
Oprette agenter og chats.
Uploade en fil til en agent.
Tilknytte en ny daemon med dens claim-kode.

Hent et API-token.

Du opretter tokenet i din browser og holder det ude af alle chats. Kun ejere og administratorer af kontoen kan oprette og bruge tokens.

Åbn Settings i konsollen og log ind. Tjek, at den konto, du vil scripte, er valgt: et token virker kun for den konto, det blev oprettet i.
Find kortet API tokens, skriv et navn til tokenet under New API token, for eksempel “scripts på min bærbare”, og klik Create API token →.
Den næste side viser tokenet én gang. Det starter med tok_. Kopiér det nu; det bliver aldrig vist igen. Siden viser også, hvad tokenet må.
Læg det direkte i en miljøvariabel som AGENTX_API_TOKEN i den terminal, hvor dine scripts kører. Indsæt det aldrig i en chat.

bash eller zsh

read -rs AGENTX_API_TOKEN && export AGENTX_API_TOKEN

Indsæt tokenet og tryk Enter. Intet vises på skærmen.

PowerShell

$env:AGENTX_API_TOKEN = Read-Host -MaskInput "AgentX API token"

Et token fra Settings udløber ikke og kan alt i tabellen nedenfor. Du tilbagekalder det ved at klikke Revoke → ud for det på samme kort.

Basis-URL og login.

Hvert kald er almindelig HTTPS med JSON. Hent OpenAPI-beskrivelsen først: den er facit for feltnavne og formater, og den kræver intet token.

Basis-URL: https://www.agentxhq.com. Alle stier starter med /api/v1.
Godkendelse: Authorization: Bearer $AGENTX_API_TOKEN på alle kald undtagen de to opdagelsesruter.
Indhold: JSON med Content-Type: application/json, højst 1 MiB. Filupload er multipart.
Opdagelse: /api/v1/openapi.json (OpenAPI 3.1), /api/v1 med et kort indeks over alle ruter og /.well-known/api-catalog.

Prøv det

List dine agenter. Er listen unreachable i svaret ikke tom, kunne en af dine daemons ikke nås, og listen er ufuldstændig.

List agenter

curl -s https://www.agentxhq.com/api/v1/agents \
  -H "Authorization: Bearer $AGENTX_API_TOKEN"

Endepunkter

Otte ruter i version 1. Hver kræver præcis én tilladelse, og et token fra Settings har dem alle.

Rute	Det gør den	Tilladelse
GET /api/v1/agents	Lister alle agenter på tværs af alle dine daemons.	agentx:agent.read
POST /api/v1/output	Læser, hvad en agent har skrevet.	agentx:agent.read
POST /api/v1/agents	Opretter en agent på en af dine daemons.	agentx:agent.create
POST /api/v1/agents/{agent}/upload	Uploader en fil til en agents arbejdsområde.	agentx:agent.upload
GET /api/v1/bubbles	Lister chats, side for side.	agentx:bubble.read
POST /api/v1/bubbles	Opretter en chat forankret i en agent.	agentx:bubble.create
POST /api/v1/messages	Sender en besked til en agent.	agentx:bubble.send
POST /api/v1/daemons/claim	Tilknytter en daemon til din konto med dens claim-kode.	agentx:daemon.claim
GET /api/v1, /api/v1/openapi.json	Opdagelse. Kræver intet token.	intet

Feltnavne, forespørgslernes indhold og svar står i OpenAPI-beskrivelsen. Kun de ruter, der står der, findes.

Når et kald bliver afvist

Hver afvisning er JSON i samme form, {"error":{"code":…,"message":…}}, med samme kode i svarhovedet X-Error-Code. Læs koden og beskeden; de siger, om du skal rette kaldet, oprette et nyt token eller starte eller opgradere din daemon.

Brug for et menneske?

AgentX-support er på Discord. Tag statuskoden og fejlkoden fra svaret med.