SuperCognit to platforma no-code i większość osób nigdy nie potrzebuje niczego więcej: opisz agenta, dołącz swoją wiedzę, opublikuj. Ale w chwili, gdy prowadzisz agentów dla stu klientów, podłączasz rozmowy do CRM albo wbudowujesz SuperCognit we własny produkt, klikanie przestaje się skalować. Do tego służy API — ta sama przestrzeń robocza, sterowana Twoim kodem.

Jeden klucz, jeden nagłówek

Utwórz klucz API w swojej przestrzeni roboczej i wysyłaj go w nagłówku X-Api-Key. Klucze deklarują zakresy — write jest wymagany do wszystkiego, co nie jest GET — a klucz można ograniczyć do jednego produktu i wtedy nie ma dostępu do zasobów na poziomie przestrzeni, takich jak narzędzia, bazy wiedzy czy webhooki. To całe uwierzytelnianie: bez tańca z OAuth, bez SDK do instalowania.

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

Utwórz i opublikuj agenta bez otwierania panelu

Produkt — agent czatu lub serwer MCP — jest tworzony jako wersja robocza, konfigurowany, a potem publikowany. To dokładnie ten sam cykl życia, który stosuje panel, i dlatego agencje używają go, by tworzyć jednego agenta na klienta prosto z własnego procesu onboardingu.

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."
  }'

Odpowiedź zawiera id i slug nowego produktu. Stamtąd dołączasz narzędzia i bazy wiedzy, poprawiasz prompt lub cenę i publikujesz — wszystko przez to samo API.

Co obejmuje API

  • Produkty — tworzenie, aktualizacja, publikowanie i wycofywanie agentów czatu i serwerów MCP.
  • Narzędzia — biblioteka narzędzi przestrzeni roboczej: narzędzia LLM, HTTP i statyczne, ich dane wejściowe i produkty, które ich używają.
  • Bazy wiedzy — wiedza stojąca za Twoimi odpowiedziami i miejsca, do których dołączona jest każda baza.
  • Rozmowy — sesje i pełne zapisy rozmów, z modelem i liczbą tokenów przy każdej wiadomości.
  • Webhooki — punkty końcowe, ich dziennik doręczeń i ponowienia.
  • Portfel — saldo kredytów za zużycie oraz każde doładowanie, obciążenie i zwrot.
  • Użytkownicy końcowi — weryfikacja tokena sesji czatu po stronie serwera, żeby Twoja aplikacja wiedziała, z kim rozmawia.

Zdarzenia wysyłane do Ciebie

Odpytywanie wystarcza do uzupełniania historii, ale dane w czasie rzeczywistym powinny przychodzić same. Zarejestruj punkt końcowy, a SuperCognit będzie wysyłać JSON metodą POST w miarę przebiegu rozmów: conversation.created, gdy ktoś zaczyna rozmowę, message.created dla każdej wiadomości, message.completed, gdy agent kończy odpowiedź. Doręczenia są ponawiane do pięciu razy z wykładniczym odstępem i zapisywane ze statusem odpowiedzi, więc nic nie znika po cichu.

Każde żądanie jest podpisane. Oblicz HMAC-SHA256 SUROWEJ treści z sekretem swojego punktu końcowego i porównaj go z nagłówkiem X-Supercognit-Signature — na dokładnie tych bajtach, które otrzymałeś, nigdy na ponownie zserializowanej kopii 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));

Co zespoły z nim budują

01

Agent dla każdego klienta

Twój onboarding tworzy produkt, dołącza właściwą bazę wiedzy, publikuje go i przekazuje klientowi działającego agenta — zanim dotrze Twój mail powitalny.

02

Rozmowy w CRM

Webhook dla każdej wiadomości przesyła rozmowy i pozyskane kontakty do HubSpot, Salesforce lub Twojej własnej bazy danych, gdzie już żyje reszta Twojego lejka.

03

Wiedza, która nadąża za produktem

Gdy zmienia się Twoja dokumentacja, odśwież źródło zamiast czekać na następne zaplanowane indeksowanie — odpowiedzi pozostają zgodne z tym, co faktycznie dostarczasz.

04

Zużycie, za które możesz wystawić rachunek

Czytaj portfel i zapisy rozmów, by zobaczyć dokładnie, co zużyło dane konto, a potem obciąż za to we własnym produkcie z własną marżą.

REST dla Twoich systemów, MCP dla klientów AI

Te dwie powierzchnie dla deweloperów odpowiadają na różne pytania. API to sposób, w jaki Twój kod steruje SuperCognit. MCP to sposób, w jaki klienci AI — Claude, Cursor, Twoi własni agenci — korzystają z tego, co publikujesz. Oba działają na tej samej przestrzeni roboczej, więc narzędzie zbudowane raz jest dostępne z obu stron, a własny serwer MCP platformy udostępnia te same zasoby w asystencie, w którym już pracujesz.

Zacznij od dokumentacji

Pełna dokumentacja jest publiczna i interaktywna pod adresem api.supercognit.com/docs, generowana z dokumentu OpenAPI 3.1, który możesz wprost podać do generatora klienta. Utwórz klucz, wykonaj pierwsze wywołanie z góry i zobacz, jak Twoja przestrzeń robocza odpowiada w JSON-ie — za darmo przez 7 dni.