SuperCognit je platforma bez koda i većini ljudi nikad ne treba ništa drugo: opiši agenta, dodaj svoje znanje, objavi. Ali čim vodiš agente za stotinu klijenata, povezuješ razgovore s CRM-om ili ugrađuješ SuperCognit u vlastiti proizvod, klikanje se prestaje skalirati. Za to služi API — isti radni prostor, kojim upravlja tvoj kod.

Jedan ključ, jedno zaglavlje

Stvori API ključ u svom radnom prostoru i šalji ga kao zaglavlje X-Api-Key. Ključevi definiraju opsege — write je potreban za sve što nije GET — a ključ se može zaključati na jedan proizvod, pa tada ne može dirati resurse na razini radnog prostora poput alata, baza znanja ili webhookova. To je cijela priča o autentifikaciji: bez OAuth plesa, bez SDK-a za instalaciju.

curl https://api.supercognit.com/v1/products \
  -H "X-Api-Key: $SUPERCOGNIT_API_KEY"

Stvori i objavi agenta bez otvaranja nadzorne ploče

Proizvod — chat agent ili MCP poslužitelj — stvara se kao skica, konfigurira i zatim objavljuje. To je točno onaj životni ciklus koji prati i nadzorna ploča, zbog čega ga agencije koriste kako bi po jednog agenta za svakog klijenta otvorile izravno iz vlastitog postupka uključivanja.

curl -X POST https://api.supercognit.com/v1/products \
  -H "X-Api-Key: $SUPERCOGNIT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "kind": "chat_agent",
    "title": "Acme support",
    "intro": "Hi! Ask me anything about Acme.",
    "systemPrompt": "You answer Acme customer questions from the attached knowledge."
  }'

Odgovor sadrži id i slug novog proizvoda. Odande dodaješ alate i baze znanja, mijenjaš prompt ili cijenu i objavljuješ ga — sve preko istog API-ja.

Što API pokriva

  • Proizvodi — stvaranje, ažuriranje, objava i povlačenje chat agenata i MCP poslužitelja.
  • Alati — biblioteka alata radnog prostora: LLM, HTTP i statički alati, njihovi ulazi i proizvodi koji ih koriste.
  • Baze znanja — znanje iza tvojih odgovora i gdje je svaka baza dodana.
  • Razgovori — sesije i potpuni zapisi razgovora, s modelom i brojem tokena uz svaku poruku.
  • Webhookovi — krajnje točke, njihov dnevnik isporuka i ponavljanja.
  • Novčanik — stanje kredita za potrošnju i svaka nadoplata, terećenje i povrat.
  • Krajnji korisnici — provjera tokena chat sesije na strani poslužitelja, kako bi tvoja aplikacija znala s kim razgovara.

Događaji koji ti stižu sami

Povremeno dohvaćanje u redu je za nadoknadu podataka, ali ono u stvarnom vremenu trebalo bi stizati samo. Registriraj krajnju točku i SuperCognit šalje JSON metodom POST dok se razgovori događaju: conversation.created kada netko započne razgovor, message.created za svaku poruku, message.completed kada agent dovrši odgovor. Isporuke se ponavljaju do pet puta s eksponencijalnim odmakom i bilježe sa statusom odgovora, pa ništa ne nestaje tiho.

Svaki je zahtjev potpisan. Izračunaj HMAC-SHA256 NEOBRAĐENOG tijela s tajnim ključem krajnje točke i usporedi ga sa zaglavljem X-Supercognit-Signature — s točno onim bajtovima koje si primio, nikad s ponovno serijaliziranom kopijom JSON-a.

import { createHmac, timingSafeEqual } from "node:crypto";

const expected = "sha256=" + createHmac("sha256", WEBHOOK_SECRET).update(rawBody).digest("hex");
const valid = timingSafeEqual(Buffer.from(expected), Buffer.from(signatureHeader));

Što timovi s njim grade

01

Agent po klijentu

Tvoj postupak uključivanja stvara proizvod, dodaje pravu bazu znanja, objavljuje ga i klijentu predaje agenta koji radi — prije nego što stigne tvoja e-poruka dobrodošlice.

02

Razgovori u CRM-u

Webhook po poruci šalje razgovore i prikupljene kontakte u HubSpot, Salesforce ili tvoju vlastitu bazu podataka, gdje već živi ostatak tvog prodajnog lijevka.

03

Znanje koje prati proizvod

Kada se tvoja dokumentacija promijeni, osvježi izvor umjesto da čekaš sljedeće zakazano indeksiranje — odgovori ostaju usklađeni s onim što stvarno isporučuješ.

04

Potrošnja koju možeš naplatiti

Čitaj novčanik i zapise razgovora kako bi vidio točno što je neki račun potrošio, a zatim to naplati unutar vlastitog proizvoda uz vlastitu maržu.

REST za tvoje sustave, MCP za AI klijente

Dvije razvojne površine odgovaraju na različita pitanja. API je način na koji tvoj kod upravlja SuperCognitom. MCP je način na koji AI klijenti — Claude, Cursor, tvoji vlastiti agenti — koriste ono što objaviš. Oboje radi na istom radnom prostoru, pa je alat koji izradiš jednom dostupan s obje strane, a vlastiti MCP poslužitelj platforme izlaže iste resurse unutar asistenta u kojem već radiš.

Počni od referentne dokumentacije

Potpuna referentna dokumentacija javna je i interaktivna na api.supercognit.com/docs, generirana iz OpenAPI 3.1 dokumenta koji možeš izravno predati generatoru klijenata. Stvori ključ, pokreni prvi gornji poziv i gledaj kako ti radni prostor odgovara u JSON-u — besplatno 7 dana.