AI API iza svakog SuperCognit agenta
Jedan REST API za izradu agenata i MCP poslužitelja, dodavanje alata i znanja, čitanje svakog razgovora i slanje događaja u vlastite sustave. OpenAPI 3.1, autentifikacija ključem, bez potrebe za SDK-om.
https://api.supercognit.com/v1Tvoj prvi poziv
Radi sve što ima HTTP klijent — curl, tvoj backend, alat za automatizaciju, drugi agent.
curl https://api.supercognit.com/v1/products \
-H "X-Api-Key: $SUPERCOGNIT_API_KEY"Autentifikacija ključem radnog prostora
Izradi ključ na nadzornoj ploči i šalji ga u zaglavlju X-Api-Key. Ključevi imaju opseg čitanja ili pisanja, a ključ se može ograničiti na jedan proizvod — tako integracija dira samo ono što si joj dao.
Što API pokriva
Ono što možeš na nadzornoj ploči može i tvoj kod — isti radni prostor, isti resursi.
Proizvodi
/v1/productsIzrađuj, ažuriraj, objavljuj i povlači chat agente i MCP poslužitelje — uključujući prompt, sažetak, slug i cijenu.
Alati
/v1/toolsUpravljaj bibliotekom alata radnog prostora: LLM, HTTP i statičnim alatima, njihovim ulazima i proizvodima koji ih koriste.
Baze znanja
/v1/knowledge-basesPregledaj znanje iza svojih odgovora i vidi kojim je proizvodima pojedina baza dodijeljena.
Razgovori
/v1/sessionsČitaj razgovore i potpune transkripte — svaku poruku, model i broj tokena, spremno za tvoju analitiku ili CRM.
Webhookovi
/v1/webhooksRegistriraj krajnje točke, pregledaj isporuke i ponovne pokušaje te ponovno uključi krajnju točku bez otvaranja nadzorne ploče.
Novčanik
/v1/walletPročitaj stanje kredita za potrošnju i svaku nadoplatu, terećenje i povrat iza njega.
Krajnji korisnici
/v1/verify-userProvjeri token chat sesije na strani poslužitelja kako bi tvoja aplikacija mogla vjerovati s kim razgovara.
Što timovi s tim grade
Agent za svakog klijenta
Agencije i SaaS timovi izrađuju, postavljaju i objavljuju po jednog agenta za svakog klijenta izravno iz vlastitog procesa uključivanja — bez klikanja po nadzornoj ploči.
Razgovori u tvom CRM-u
Šalji svaki razgovor i prikupljeni kontakt u HubSpot, Salesforce ili vlastitu bazu podataka u trenutku kad se dogodi.
Znanje koje ostaje ažurno
Osvježi izvor znanja kad se tvoja dokumentacija promijeni, tako da odgovori prate tvoj proizvod, a ne zaostaju za njim.
Potrošnja koju možeš naplatiti
Čitaj novčanik i transkripte da točno vidiš što je pojedini račun potrošio, a zatim to naplati unutar vlastitog proizvoda.
Događaji koji stižu k tebi
Registriraj krajnju točku i SuperCognit šalje JSON (POST) dok se razgovori odvijaju. Svaki je zahtjev potpisan HMAC-SHA256 potpisom nad sirovim tijelom, ponavlja se do pet puta s eksponencijalnim odgodama i bilježi u zapisnik isporuka sa statusom odgovora.
- conversation.created — netko je započeo novi razgovor
- message.created — poslana je poruka, od posjetitelja ili od agenta
- message.completed — agent je završio odgovor
REST za tvoje sustave, MCP za AI klijente
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 izgradiš jednom dostupan na oba načina.
Pogledaj MCP poslužitelje →Pitanja koja postavljaju programeri
Da. Svaki plan uključuje pristup API-ju bez dodatne naknade — plaćaš svoj plan i potrošnju koju stvaraju tvoji agenti, točno kao i s nadzorne ploče. Uključen je i u besplatno probno razdoblje od 7 dana.
API ključem radnog prostora, poslanim u zaglavlju X-Api-Key. Ključevi definiraju opsege — za sve što nije GET potreban je opseg pisanja — a ključ se može ograničiti na jedan proizvod, pa tada ne može dirati resurse na razini radnog prostora poput alata, baza znanja ili webhookova.
Ne. Riječ je o običnom REST-u preko JSON-a, pa radi bilo koji HTTP klijent. OpenAPI 3.1 dokument je javan, pa za nekoliko minuta možeš generirati i tipizirani klijent u jeziku po izboru.
Da. Izradi proizvod, dodaj alate i baze znanja, a zatim ga objavi — isti životni ciklus koji koristi nadzorna ploča. Tako timovi automatski postavljaju po jednog agenta za svakog klijenta.
Platforma iza tvojih agenata pokreće pažljivo odabran model, pa tvoja integracija nikad ne barata ključevima pružatelja ni nazivima modela. Ti gradiš i pokrećeš agenta; mi ispod njega održavamo model ažurnim.
Na dva načina: čitaj krajnje točke razgovora za sesije i transkripte ili registriraj webhook i primaj svaku poruku u trenutku kad nastane. Većina timova koristi webhookove za stvarno vrijeme, a krajnje točke za naknadno dohvaćanje.
Gradi s API-jem
Izradi radni prostor, generiraj ključ, pokreni svoju integraciju — besplatno 7 dana.