Integrációs pontok
Az Askalot három, egymást kiegészítő integrációs felületet kínál. Ugyanazokon a platformképességeken és jogosultsági modellen osztoznak – válassza azt, amelyik illeszkedik ahhoz, ahogyan a rendszere az Askalottal kommunikál.
| Integráció | Mire a legalkalmasabb | Hitelesítés |
|---|---|---|
| Claude (MCP + bővítmény) | MI-ügynökök, amelyek beszélgetésben viszik végig a kutatási életciklust | OAuth 2.1 böngészős bejelentkezés |
| REST API | Szerverek közötti automatizálás, CI, egyedi alkalmazások | Személyes API-token (X-Api-Token fejléc) |
| A kérdőív megjelenítési formátuma | Élő kérdőívek megjelenítése az Ön saját alkalmazásának felületén | Ugyanazok a REST-hitelesítő adatok |
Claude MCP-n keresztül
Szekció neve “Claude MCP-n keresztül”Az Askalot MCP-szervere lehetővé teszi, hogy a Claude (Claude.ai, Claude Desktop, Claude Code) közvetlenül, beszélgetésben kezelje a projekteket, a kérdőíveket, a kampányokat és az adatelemzést. A Claude Code felhasználói ezenfelül telepíthetik az Askalot bővítményt (plugin) is – a skilleket, a perjeles parancsokat és az MCP-eszközöket egyetlen csomagban. A hitelesítés interaktív OAuth 2.1 folyamattal történik; API-kulcsot nem kell kezelnie.
→ Útmutató a Claude-integrációhoz
REST API
Szekció neve “REST API”Minden platformentitás – projektek, kérdőívek, kampányok, válaszadók, kitöltések, csomagok, válaszadói körök, stratégiák – elérhető a https://portor.<tenant>.askalot.io/api/v1 címen, OpenAPI 3.0 specifikációval és a /api/v1/docs címen interaktív Swagger UI-val.
A hitelesítés személyes API-tokennel történik:
- Jelentkezzen be a
https://roundtable.<tenant>.askalot.iocímen, és nyissa meg a Profilbeállítások → API-tokenek oldalt - Hozzon létre egy tokent (a lejáratot Ön választja meg; a token csak egyszer jelenik meg)
- Minden kérésben küldje el az
X-Api-Tokenfejlécben
A token örökli a fiókja szerepköreit és jogosultságait, és bármikor visszavonható – a visszavonás azonnal érvénybe lép. A REST API-n az Authorization: Bearer fejléc az OAuth-hozzáférési tokenek (az MCP-átvitel által használt hitelesítő adat) számára van fenntartva; az API-tokeneket mindig az X-Api-Token fejlécben kell küldeni.
A kérdőív megjelenítési formátuma
Szekció neve “A kérdőív megjelenítési formátuma”Ahelyett, hogy egy Askalot-stílusú kérdőívoldalt ágyazna be, az alkalmazása elemről elemre vezérelheti a kitöltést, és minden kérdést a saját UI-komponenseivel jeleníthet meg. Minden lépés önálló JSON-dokumentumként érkezik – a kérdés felirata, a beviteli vezérlő leírása és az érvényes opciók –, miközben a menet logikája, az elágazások és a validáció az Askalot motorjában, a szerveroldalon marad.
→ A kérdőív megjelenítési formátuma
Ez a dokumentáció Markdownként
Szekció neve “Ez a dokumentáció Markdownként”Az MI-ügynökök és -eszközök HTML helyett egyszerű Markdownként is olvashatják ezt a dokumentációt:
| Mire van szüksége | Hol találja |
|---|---|
| Az összes oldal jegyzéke, mindegyik egysoros összefoglalóval | https://docs.askalot.io/llms.txt |
| A teljes dokumentáció egyetlen fájlban | https://docs.askalot.io/llms-full.txt |
| Egyetlen oldal | Fűzze hozzá az index.md részt az oldal címéhez, például https://docs.askalot.io/integrations/claude/index.md |
| Egyetlen oldal, a címe megváltoztatása nélkül | Kérje le az oldalt az Accept: text/markdown fejléccel |
A Markdown ugyanazt a tartalmat hordozza, amelyet az oldalon lát, a benne lévő hivatkozások pedig abszolútak, így egy ügynök bármely kiindulópontról követheti őket. Az MCP-n keresztül csatlakoztatott Claude a dokumentációs eszközökkel is kereshet és olvashat a dokumentációban.