API AI, które napędza każdego agenta SuperCognit
Jedno REST API do tworzenia agentów i serwerów MCP, dołączania narzędzi i wiedzy, czytania każdej rozmowy i przesyłania zdarzeń do własnych systemów. OpenAPI 3.1, uwierzytelnianie kluczem, bez potrzeby SDK.
https://api.supercognit.com/v1Twoje pierwsze wywołanie
Zadziała wszystko, co ma klienta HTTP — curl, twój backend, narzędzie do workflow, inny agent.
curl https://api.supercognit.com/v1/products \
-H "X-Api-Key: $SUPERCOGNIT_API_KEY"Uwierzytelnianie kluczem przestrzeni roboczej
Utwórz klucz w panelu i wysyłaj go w nagłówku X-Api-Key. Klucze mają zakres odczytu lub zapisu, a klucz można ograniczyć do jednego produktu — więc integracja dotyka tylko tego, do czego dałeś jej dostęp.
Co obejmuje API
To, co możesz zrobić w panelu, może zrobić też twój kod — ta sama przestrzeń robocza, te same zasoby.
Produkty
/v1/productsTwórz, aktualizuj, publikuj i wycofuj agentów czatu oraz serwery MCP — razem z promptem, opisem, slugiem i ceną.
Narzędzia
/v1/toolsZarządzaj biblioteką narzędzi przestrzeni roboczej: narzędziami LLM, HTTP i statycznymi, ich parametrami wejściowymi i produktami, które z nich korzystają.
Bazy wiedzy
/v1/knowledge-basesWyświetl wiedzę stojącą za odpowiedziami i sprawdź, do których produktów dołączona jest każda baza.
Rozmowy
/v1/sessionsCzytaj rozmowy i pełne transkrypcje — każdą wiadomość, model i liczbę tokenów, gotowe dla twojej analityki lub CRM.
Webhooki
/v1/webhooksRejestruj endpointy, sprawdzaj dostarczenia i ponowienia oraz ponownie włączaj endpoint bez zaglądania do panelu.
Portfel
/v1/walletOdczytaj saldo kredytów na zużycie oraz każde doładowanie, obciążenie i zwrot, które się na nie składają.
Użytkownicy końcowi
/v1/verify-userWeryfikuj token sesji czatu po stronie serwera, żeby twoja aplikacja wiedziała, z kim rozmawia.
Co zespoły z tym budują
Agent dla każdego klienta
Agencje i zespoły SaaS tworzą, konfigurują i publikują osobnego agenta dla każdego klienta prosto z własnego procesu onboardingu — bez klikania po panelu.
Rozmowy w twoim CRM
Przesyłaj każdą rozmowę i każdy pozyskany kontakt do HubSpot, Salesforce lub własnej bazy danych na bieżąco.
Wiedza, która jest zawsze aktualna
Odświeżaj źródło wiedzy, gdy zmienia się twoja dokumentacja, żeby odpowiedzi nadążały za produktem, a nie zostawały w tyle.
Zużycie, za które możesz wystawić rachunek
Odczytaj portfel i transkrypcje, żeby zobaczyć dokładnie, ile zużyło dane konto, a potem obciąż je za to we własnym produkcie.
Zdarzenia wysyłane do ciebie
Zarejestruj endpoint, a SuperCognit będzie wysyłać JSON metodą POST na bieżąco, w miarę trwania rozmów. Każde żądanie jest podpisane HMAC-SHA256 na surowej treści, ponawiane do pięciu razy z wykładniczym odstępem i zapisywane w dzienniku dostarczeń razem ze statusem odpowiedzi.
- conversation.created — ktoś rozpoczął nową rozmowę
- message.created — wysłano wiadomość, od odwiedzającego lub od agenta
- message.completed — agent zakończył odpowiedź
REST dla twoich systemów, MCP dla klientów AI
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 na oba sposoby.
Zobacz serwery MCP →Pytania, które zadają deweloperzy
Tak. Każdy plan obejmuje dostęp do API bez dodatkowych opłat — płacisz za plan i za zużycie generowane przez agentów, dokładnie tak jak przy pracy w panelu. 7-dniowy darmowy okres próbny też go obejmuje.
Kluczem API przestrzeni roboczej, wysyłanym w nagłówku X-Api-Key. Klucze mają zakresy uprawnień — zapis jest wymagany do wszystkiego poza GET — a klucz można ograniczyć do jednego produktu; wtedy nie ma dostępu do zasobów całej przestrzeni roboczej, takich jak narzędzia, bazy wiedzy czy webhooki.
Nie. To zwykłe REST z JSON, więc zadziała każdy klient HTTP. Dokument OpenAPI 3.1 jest publiczny, więc w kilka minut możesz też wygenerować typowanego klienta w wybranym języku.
Tak. Utwórz produkt, dołącz narzędzia i bazy wiedzy, a potem go opublikuj — to ten sam cykl życia, z którego korzysta panel. Właśnie tak zespoły automatycznie tworzą osobnego agenta dla każdego klienta.
Platforma uruchamia za twoimi agentami starannie wybrany model, więc twoja integracja nigdy nie obsługuje kluczy dostawców ani nazw modeli. Ty budujesz i wdrażasz agenta; my dbamy o to, żeby model pod spodem był aktualny.
Na dwa sposoby: odczytuj endpointy rozmów, aby pobrać sesje i transkrypcje, albo zarejestruj webhook i odbieraj każdą wiadomość na bieżąco. Większość zespołów używa webhooków do pracy w czasie rzeczywistym, a endpointów do uzupełniania danych historycznych.
Buduj z API
Utwórz przestrzeń roboczą, wygeneruj klucz, wdróż integrację — za darmo przez 7 dni.