AgentX

Sprog

Vælg sproget på AgentX-websitet.

Udseende

Vælg, hvordan AgentX-websitet ser ud.

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 computere, du har forbundet, 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 computere.
  • Sende en besked til en agent og læse svaret.
  • Oprette agenter og chats.
  • Uploade en fil til en agent.
  • Forbind en ny computer 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.

  1. Å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.
  2. Åbn fanen Connections og find API tokens, skriv et navn til tokenet under New API token, for eksempel “scripts på min bærbare”, og klik Create API token.
  3. 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å.
  4. 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 under Connections → API tokens.

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 computere 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

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

RuteDet gør denTilladelse
GET /api/v1/agentsLister dine agenter, en side ad gangen.agentx:agent.read
POST /api/v1/outputLæser, hvad en agent har skrevet.agentx:agent.read
POST /api/v1/agentsOpretter en agent på en af dine computere.agentx:agent.create
POST /api/v1/agents/{agent}/uploadUploader en fil til en agents arbejdsområde.agentx:agent.upload
GET /api/v1/bubblesLister chats, side for side.agentx:bubble.read
POST /api/v1/bubblesOpretter en chat forankret i en agent.agentx:bubble.create
DELETE /api/v1/bubbles/{bubbleID}Sletter en chat.agentx:bubble.delete
POST /api/v1/messagesSender en besked til en agent.agentx:bubble.send
POST /api/v1/daemons/claimTilknytter en computer til din konto med dens claim-kode.agentx:daemon.claim
GET /api/v1, /api/v1/openapi.jsonOpdagelse. 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 opdatere AgentX.

Brug for et menneske?

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