Tovább a tartalomhoz
Tudástár

MCP-felület

Az Askalot támogatja a Model Context Protocolt (MCP) – azt a nyílt szabványt, amelyen keresztül az MI-asszisztensek közvetlenül kezelhetik a platformot. Így az MI-ügynökök természetes nyelvű beszélgetésben hozhatnak létre kérdőíveket, kezelhetnek kampányokat, járhatják végig a kérdőívek menetét és elemezhetik az eredményeket.

Az MCP egy szabványos protokoll, amelyen keresztül az olyan MI-rendszerek, mint a Claude, külső eszközökkel és adatforrásokkal dolgozhatnak. Az Askalot MCP-felületével a következőkre nyílik lehetősége:

  • A kérdőíves munkafolyamatok automatizálása – projektek, kérdőívek és kampányok létrehozása MI-vel folytatott beszélgetésben
  • Kérdőívek programozott kitöltése – a kérdőív menetének bejárása és a válaszok beküldése
  • Válaszadók kezelése – a kérdőívek célszemélyeinek importálása, rendszerezése és kampányokhoz rendelése
  • Az auditnapló lekérdezése – a változások nyomon követése és a megfelelőség biztosítása
  • Hozzáférés a dokumentációhoz – az MI-ügynökök háttérként elolvashatják a platform dokumentációját
https://portor.<tenant>.askalot.io/mcp

A <tenant> helyére a szervezete bérlőjének nevét írja.

Ez az összekötő Önnek és a csapatának szól. A válaszadók soha nem ide csatlakoznak: az a kampány, amely felkínálja az MI-asszisztenst, minden válaszadónak külön összekötőt ad (https://portor.<tenant>.askalot.io/respond/mcp), amelyet a kérdőívoldalukon kapott párosítókóddal érnek el, és amely kizárólag a saját kitöltésüket tartalmazza. Lásd: MI-asszisztált önkitöltés.

Az MCP-felület OAuth 2.1-gyel hitelesít, nem beillesztett API-tokennel. Az első eszközhíváskor a Portor 401-es választ ad egy OAuth-felderítési útmutatással, az MCP-kliense (például a Claude Code-hoz készült Askalot bővítmény) pedig végigvezeti egy böngészős bejelentkezésen a platform OIDC-szolgáltatójánál. A kliens ezután eltárolja a kapott hozzáférési és frissítési tokent, és a hozzáférési tokent minden hívásban Authorization: Bearer fejlécben küldi – a bearer értékkel Önnek soha nem kell foglalkoznia.

A végpont beállítása (csak URL):

Egyedül a szerver URL-címét kell megadnia. Az Askalot bővítmény az ASKALOT_MCP_URL környezeti változóból olvassa ki; egy egyszerű .mcp.json-bejegyzés ugyanezt az URL-t tartalmazza, és semmi mást – tokenmező nincs benne:

{
"mcpServers": {
"askalot": {
"type": "http",
"url": "https://portor.<tenant>.askalot.io/mcp"
}
}
}

Bejelentkezés (első használat):

  1. Irányítsa a klienst a bérlőjére (export ASKALOT_MCP_URL=https://portor.<tenant>.askalot.io/mcp).
  2. Hívjon meg egy tetszőleges MCP-eszközt. A kliens megnyitja a böngészőben a Portor /authorize végpontját, amely átirányít a platform OIDC-bejelentkezésére.
  3. Jelentkezzen be. A bejelentkezési oldal az űrlap fölött megnevezi a hozzáférést kérő alkalmazást és azt a címet, ahová a hozzáférése kerül; csak akkor folytassa, ha ezt a kapcsolatot Ön indította abból az alkalmazásból. A kliens a kódot tokenekre cseréli, és megismétli az eredeti hívást.
  4. A böngészős kézfogásra csak egyszer van szükség; ezután a kliens észrevétlenül váltja be a frissítési tokent.

Az MCP-munkamenete egyszerre mindig pontosan egy szervezetben van – ez az aktív szervezete –, és minden eszközhívás erre vonatkozik. A projektek, a kérdőívek, a kampányok, a válaszadók és az adatkészletek mind szervezethez kötöttek, így ez a legfontosabb tudnivaló arról, hol keres egy eszköz.

Hol indul. Egy új munkamenet az otthoni szervezetében indul, abban, amelyhez a fiókja tartozik. Bejelentkezéskor semmi sem kéri, hogy válasszon.

Hogyan látja. A list_organizations visszaadja az összes szervezetet, amelyben a munkamenet dolgozhat, megjelöli az aktívat, és jelzi a lezártakat. A lista pontosan az, amit a böngészőben a Szervezet váltása menü kínál – ha Ön egyetlen szervezethez tartozik, a lista csak abból áll, és nincs mit kezelnie.

Hogyan változtatja meg. A switch_organization a munkamenetet a lista egy másik szervezetébe helyezi át. Minden későbbi hívás az újban fut, és a változás megmarad: ha újraindítja az MCP-kliensét, ott folytatja, ahol abbahagyta. A bérlő a bejelentkezéskor rögzül, és soha nem változik, így a váltás mindig csak egy bérlőn belüli szervezetek között mozgatja.

A belépés joga és a cselekvés joga nem ugyanaz. A lista azokat a szervezeteket tartalmazza, amelyeknek Ön tagja – a tagságot adminisztrátor adja meg és vonja vissza, soha nem maga a munkamenet (egy Askalot-üzemeltető listája a bérlő összes szervezete). A tagság engedi be a munkamenetet; hogy ott mely eszközöket használhatja, azt az abban a szervezetben betöltött szerepkörei döntik el, és a máshol betöltött szerepkör nem öröklődik át. Abban a szervezetben, amelynek tagja, de nincs ott szerepköre, az eszközlista a munkamenet-eszközökre szűkül – list_organizations, switch_organization, list_toolsets, get_my_entitlements és a modellbeállításai –, amíg egy adminisztrátor szerepkört nem ad Önnek ott, így mindig vissza tud váltani. Ha egy adminisztrátor eltávolítja abból a szervezetből, amelyben a munkamenet éppen van, a kapcsolat megszakad; jelentkezzen be újra, és az új munkamenet az otthoni szervezetében indul.

Egyes szervezetek lezártak – ilyen egy válogatott demó, vagy egy korábbi ügyfél adatai, amelyek a megőrzési idejük alatt elérhetők maradnak. A list_organizations megjelöli őket, így cselekvés előtt látja.

Ami le van zárva, az a szervezet kutatási nyilvántartása – projektjei, kérdőívei, kampányai, válaszadói, válaszadói körei, kitöltései, adatkészletei és kutatási tanulmányai. Az olvasást ez nem érinti: mindezek listázása és lekérése továbbra is működik, ahogy a dokumentációs és a módszertani könyvtári eszközök is. Az auditeszközökre a szokásos szabályok vonatkoznak (lásd: Audit és megfelelőség). A létrehozást, módosítást és törlést a rendszer org_sealed válasszal utasítja el. Minden eszköz deklarálja, hogy olvas vagy ír, és az elutasítás ezen a deklaráción alapul – a határ tehát az eszköz tulajdonsága, nem a neve alapján tett találgatás.

Egy mérőeszköz kipróbálása továbbra is működik, mert az előnézet semmit sem változtat a nyilvántartásban. A kampány nélkül hívott create_survey kitöltés helyett előnézetet indít, amelyet a get_survey_current_item, a submit_survey_response és a finish_survey végigjár – így egy lezárt szervezetben is áttekinthet egy kérdőívet az elejétől a végéig. Ha a create_survey kampányt kap, a rendszer elutasítja a hívást: az a bejárás valódi eset lenne, a valódi esetek pedig bekerülnek az adatkészletbe.

A list_organizations és a switch_organization ott is működik, így egy munkamenet mindig látja, hová mehet még, és el tudja hagyni a szervezetet.

A lezárás az adott szervezet API-tokenjeit is letiltja: újat nem hozhat létre, a meglévő pedig nem működik tovább. A fenti OAuth-bejelentkezést ez nem érinti.

Az Askalot háromféle MI-hívást futtat az Ön nevében, és mindegyik külön választja meg a szolgáltatóját és a modelljét: beágyazás (a platform helyi modelljéhez rögzítve – az indexelésnek és a keresésnek ugyanazt kell használnia, ezért nem állítható), közvetlen LLM (egyetlen nyers kiegészítés: kulcsszó-kinyerés a dokumentumkereséshez és a kinyerési lépés egy dokumentum betöltésekor) és következtetés, amely az ügynököket futtatja, és high / medium / low szinttel rendelkezik.

A get_model_configuration megmutatja, mi van érvényben a saját fiókjára, és modellhelyenként azt is, honnan származik az érték:

Forrás Jelentés
user Ön választotta
org a szervezetétől örökölt
platform az Askalot alapértéke (csak a beágyazási modellhelyen)
mixed a szolgáltató és a modell különböző forrásból származik
unconfigured semmi sincs beállítva, és platformszintű alapérték sincs

A közvetlen LLM modellhelye és minden következtetési szint unconfigured értéket mutat, amíg Ön vagy a szervezete nem választ szolgáltatót – és ez a válasz egy gyakori félreértésre: ezeknek a modellhelyeknek szándékosan nincs platformszintű alapértékük, mert a hívások költsége az Ön saját szolgáltatói fiókját terheli. Ha egy dokumentumkeresés vagy egy betöltés „requires an LLM provider — none is configured” üzenettel hiúsul meg, vagy egy ügynök arra kéri, hogy állítson be szolgáltatót, akkor ez az állapot áll fenn, nem hibás kulcs. Egy beállítatlan következtetési szint az effective_config mezőben null értéket mutat.

Az update_model_configuration az Ön saját modellhelyeit módosítja. Összefésüléssel dolgozik: ha a direct_llm értéket adja meg, a következtetési szintjei változatlanok maradnak; ha a reasoning: {"high": …} értéket, a medium és a low érintetlen marad. Egy szintnél null – vagy a clear_direct_llm: true – visszaadja a modellhelyet a szervezete értékének. A három következtetési szintnek végül egy szolgáltatón kell lennie, és a beállítatlan szint eltérésnek számít, ezért az első írásnak mindhármat meg kell neveznie: a csak high beállítását a rendszer elutasítja, mert a medium és a low beállítatlan maradna. Ugyanezért, ha a szervezete sem állít be következtetést, annak törléséhez egyszerre mindhárom szintre null értéket kell megadnia.

A direct_llm és a reasoning egyaránt anthropic_api vagy bedrock értéket fogad el. Találgatás helyett kérdezze le a get_model_configuration eszközzel az elfogadott értékeket és szolgáltatónként az alapértelmezett modellt; az elutasított írás semmit sem változtat, és megnevezi, mi volt a hiba.

A közvetlen LLM modellhelye és a következtetési szintek egy-egy panelt alkotnak Mindig a legújabb modell használata jelölőnégyzettel, amely be van kapcsolva, hacsak Ön ki nem kapcsolta. Amíg be van kapcsolva, az Askalot a panel saját modellhelyeit a legújabb Sonnet (közvetlen LLM), illetve Opus / Sonnet / Haiku (high / medium / low) modellen tartja, és csak akkor vált, ha az adott modellhely hitelesítő adatával végzett próbahívás sikeres; a működését az MI-funkciók és modellbeállítások oldal ismerteti. Az eszközökön keresztül:

  • A get_model_configuration visszaadja az auto_latest értéket (panelenként, a direct_llm és a reasoning esetén: be van-e kapcsolva a jelölőnégyzet) és az auto_status értéket (modellhelyenként: mikor ellenőrizte utoljára, mi lett az eredmény, és melyik volt az utolsó modell, amelynek a próbahívása sikertelen volt). Az eredmények között szerepelhet az ok, a no_newer_model, a pending_verification, a no_credential, a catalog_unreadable, a session_expired, vagy maga a próbahívás elutasítási oka.
  • Az update_model_configuration hívásban egy panel bármely modellhelyére megadott model_id kézi választásnak számít: az adott panel jelölőnégyzete ugyanabban az írásban kikapcsol, a másik panel érintetlen marad. Ha olyan panelnél, amelynek a jelölőnégyzete be van kapcsolva, csak szolgáltatót ad meg (direct_llm={"provider": "bedrock"}, vagy minden következtetési szintet {"provider": …} formában), a modellhelyek a szolgáltató által kínált, az adott modellhely családjába tartozó legújabb modellt kapják, a jelölőnégyzet bekapcsolva marad, a modellhelyeket pedig a rendszer a következő ellenőrzéskor teszteli. A válasz tartalmazza az így kialakult auto_latest értéket.
  • Az eszköz soha nem kapcsolja vissza a jelölőnégyzetet; ezt a profiloldalon teheti meg.

Mindkét eszköz csak a saját fiókjára hat. Ugyanezek a beállítások a profiloldala MI-modellek szakaszában is megtalálhatók, és a módosítás az auditnaplóba kerül, bármelyik úton történt is.

Az MCP-szerver egyike annak a két felületnek, amely ugyanazokat a képességeket nyújtja, és nem tudja jelezni, ha Ön a rosszat választotta: a rossz sáv lassú és sok kontextust emészt fel, de nem hiba.

  • Az MCP egyetlen szemantikus műveletre, egy lekérdezésre vagy bármire szolgál, amihez a szerver megítélése kell. A munka nagy része ide tartozik.
  • A REST (https://portor.<tenant>.askalot.io/api/v1) a tömeges munkára és mindarra szolgál, aminek a küldött adata vagy az eredménye nagy. A ciklusokat és a szűrést a kontextusán kívül végezze, és csak egy összefoglalót tartson meg.

Hogy melyik hitelesítő adat kell, az attól függ, ki hív. Az MCP-munkamenetét hitelesítő OAuth-hozzáférési tokent az /api/v1 is elfogadja Authorization: Bearer <token> formában. A személyes hozzáférési token (PAT) ezzel szemben az X-Api-Token fejlécbe kerül, soha nem Bearerként; lásd: Hitelesítés.

  • A saját tokent birtokló program – egy SDK-ügynök, amely a saját OAuth-munkamenetét kezeli – a REST-en is felhasználhatja. A hitelesítő adat már a kezében van, és egy munkamenet mindkét sávon egyetlen identitás.
  • A sandboxhoz generált kód, vagy bármi, ami túléli az adott fordulót, PAT-ot használ. Ez nem ízlés kérdése: a sandbox nem rendelkezik saját, ezt az API-t elérő hitelesítő adattal. A PAT ráadásul külön visszavonható, a munkamenet-token nem.
  • A csevegőklienst vezérlő modell egyáltalán nem látja a tokent – azt a kliens tárolja. Ha Ön kódot ír, akkor a fenti esetről van szó.

Amit könnyű fordítva megjegyezni:

  • A bulk_create_respondents mindkét sávon hívásonként legfeljebb 100 elemet fogad. A REST ugyanúgy validálja a bemenetet, így 500 válaszadó mindkét úton öt hívás. A REST a hívások számában és a kontextusban nyer, a kötegméretben soha.
  • Az adatfolyam-feladatot indító code_open_ends és derive_silver csak MCP-n érhető el. REST-megfelelőjük nincs, felesleges keresni.
  • Az adatkészletek nem csak MCP-n érhetők el. A list_datasets, a get_dataset, a delete_dataset és az export_dataset mind rendelkezik útvonallal az /api/v1/datasets alatt, és a listázás vagy exportálás éppen az a nagy eredményű munka, amelyre a REST való.
  • A nagy tartalom hivatkozásként érkezik. Az export_dataset, valamint a 32 KB fölötti get_qml_content rövid életű, aláírt download_url címet ad vissza; ezt egyszerű HTTPS-sel töltse le.
  • A QML-mentés megnevezi azt a verziót, amelyből írták. Olvasson a get_qml_content eszközzel, majd adja át annak version_id értékét base_version_id-ként a save_qml_file vagy a finalize_upload hívásnak. Mentés után azt a version_id értéket nevezze meg, amelyet a mentés visszaadott. overlap esetén olvasson újra, és alkalmazza ismét a módosítását; soha ne küldje újra ugyanazt a tartalmat. Részletek: Kérdőíveszközök.
  • Lekérdezzen, ne ciklusban hívjon. Kód-sandbox nélkül ne írjon kézzel több száz egymást követő eszközhívást: indítsa el a feladatot, és kérdezze le a get_task_status eszközzel egy feladatazonosítóra, vagy a get_dataset eszközzel egy adatkészlet-fázisra.

A kapcsolat által látott eszközök szűkítése

Szekció neve “A kapcsolat által látott eszközök szűkítése”

A teljes felület több mint 120 eszközből áll, ami több, mint amennyire egy-egy kutatásnak szüksége van. Egy kapcsolat az URL-ben megnevezheti a kívánt területeket:

https://portor.<tenant>.askalot.io/mcp?toolsets=analysis,campaign

Az értékek vesszővel elválasztott eszközkészlet-nevek. Az a kapcsolat, amely egyet sem nevez meg, mindent megkap; ez az alapértelmezés, és az is marad.

Kilenc eszközkészlet szűrhető így:

Eszközkészlet Mit tartalmaz
project Projektek és tulajdonjoguk
questionnaire Kérdőívek és a QML-életciklus
sampling Válaszadók, válaszadói körök és mintavételi stratégiák
campaign Kampányok és beállításaik
fielding Kitöltések, meghívók, kérdezők, a válaszadási folyamat
analysis Csomagok, adatkészletek és a Bronz/Ezüst/Arany adatfolyam
documents Az Ön által feltöltött referenciadokumentumok
methodology A közös kérdőíves módszertani könyvtár
audit Az auditnapló

További nyolc minden kapcsolaton elérhető, bármit nevez is meg, mert ha elvennénk őket, egy ügynök nem tudná korrigálni a saját irányát: a munkamenet- és szervezeti eszközei, a beszélgetési előzmények, a jogosultságok, a dokumentáció, maga a list_toolsets eszköz, a kutatási tanulmány, az alább ismertetett összetett eszközök és a get_task_status – így egy szűkített kapcsolaton indított összetett feladat mindig lekérdezhető onnan.

Két dolgot érdemes tisztázni arról, mi nem ez a szűkítés:

  • Nem jogosultsági határ. Az URL-t Ön választja, így egy eszközkészlet megnevezése senkit nem zár ki semmiből. Hogy mit tehet, azt az előfizetési csomagja, a szerepköre és a projekt-tulajdonjog dönti el – a paraméter pedig ezek egyikén sem változtat. Azt szűkíti, mi van Ön előtt, nem azt, mit tehet.
  • Nem szerepkör. A paraméter ezeket az eszközkészlet-neveket fogadja el, és semmi mást; nincs ?toolsets=analyst rövidítés.

A list_toolsets hívásával bármikor megnézheti az összes eszközkészletet, az egyes készletek eszközeit, azt, hogy a kapcsolata mit nevezett meg, és mely neveket nem ismert fel. Ha olyan eszközt hív meg, amelyet a kapcsolata kizárt, az elutasítás megnevezi az azt tartalmazó eszközkészletet és azt az URL-paramétert, amely beengedné – így egy rossz tipp ennek az oldalnak az elolvasása nélkül is helyrehozható.

A hatókör a kapcsolat URL-jében van, ezért a módosításához újra kell csatlakoznia. Ez a HTTP-átvitel funkciója; a stdio-kapcsolatnak nincs URL-je, ezért mindig szűkítetlen.

Három gyakori lépéssor egyetlen eszközként is elérhető. Ezek nem lépéseket átugró rövidítések – minden lépés ugyanaz az eszköz, amelyet kézzel hívna, ugyanazokat a rekordokat írja, és ugyanazt az auditnyomot hagyja:

Egy hívás Amit futtat
prepare_campaign_fielding Mintavételi stratégia → válaszadói kör → a válaszadói kör hozzárendelése → a kérdőívverzió közzététele → a kitöltések létrehozása
simulate_campaign_responses A kitöltések létrehozása → szintetikus válaszok generálása hozzájuk
run_bundle_pipeline Bronz kinyerés → Ezüst (kódolás + súlyozás) → Arany

Három tudnivaló a használatuk előtt:

  • A prepare_campaign_fielding a meghívók kiküldése előtt megáll. Soha nem küld; az külön, megfontolt send_campaign_invitations hívás marad, amelyet azután tesz meg, hogy áttekintette, mit épített fel a lánc. Az elküldött e-mail nem vonható vissza.
  • Ha egy lánc félúton megáll, ami addig elkészült, megmarad. Semmit sem von vissza a rendszer. A válasz a stopped_at_step mezőben nevezi meg a lépést; a nem null érték azt jelenti, hogy a lánc nem futott végig, és onnan az egyes eszközökkel folytathatja. A run_bundle_pipeline a leállást a {success: false, error, detail} borítékban jelzi; a másik kettő a szokásos eredményét adja vissza kitöltött error és detail mezővel, success kulcs nélkül.
  • A lánc előre ellenőrzi a teljes lépéssort. Ha az előfizetése egy későbbi lépést nem fed le, ezt még azelőtt megtudja, hogy bármi elkészülne, és nem egy félkész eredményt kap.

A simulate_campaign_responses és a run_bundle_pipeline egy feladatazonosítót ad vissza, amelyet a get_task_status eszközzel kérdezhet le. A run_bundle_pipeline jelenti, melyik lépésig jutott a futása, és a befejezés után az egyes fázisok adatkészletét; a simulate_campaign_responses ugyanazt a kitöltési feladatot adja vissza, mint a nyers mass_fill_surveys eszköz, így a lekérdezés előrehaladást jelez, nem lépéseket.

Az MCP-felület funkciók szerint csoportosított eszközöket kínál.

Eszköz Leírás
list_organizations Azoknak a szervezeteknek a listázása, amelyekbe a munkamenet átválthat; megjelöli az aktívat és jelzi a lezártakat
switch_organization A munkamenet aktív szervezetének áthelyezése – minden későbbi hívás erre vonatkozik
Eszköz Leírás
list_projects Az összes projektje listázása
get_project Projekt részleteinek lekérése
create_project Új projekt létrehozása
add_project_owners Felhasználók felvétele a projekt tulajdonosai közé (az érintett felhasználóknak a projekt szervezete tagjainak kell lenniük)
remove_project_owners Felhasználók eltávolítása a projekt tulajdonosai közül (ugyanez a tagsági szabály érvényes)
Eszköz Leírás
list_questionnaires Az összes kérdőív listázása
get_questionnaire Kérdőív részleteinek lekérése
create_questionnaire Új kérdőív létrehozása QML-tartalomból vagy a könyvtár egy sablonjából (template, amelyet language nyelven másol át, a könyvtár többi nyelvét fordításként csatolva); tartalommal megkaphatja azt az inventory leltárt is, amelyből a tartalom készült, és amelyet a rendszer az 1. verzióval együtt tárol (a nem validálható leltár az egész létrehozást meghiúsítja)
list_questionnaire_templates A kérdőívsablon-könyvtár listázása egyik nyelvén (language; alapértelmezésként az Önén, language_fallback jelöléssel angolul, ha a könyvtár az Ön nyelvén nem érhető el), kategóriánként, a névben és a leírásban való kereséssel
rename_questionnaire Kérdőív átnevezése (az elérési címe nem változik)
delete_questionnaire Kérdőív logikai törlése
restore_questionnaire Nemrég logikailag törölt kérdőív visszaállítása
list_qml_files A szervezet QML-kérdőíveinek listázása
inspect_qml_file Gyors összefoglaló egy kérdőív aktuális verziójáról
preview_qml_item Egy kérdőívelem megjelenítése úgy, ahogy a válaszadó látja; az MCP Apps megjelenítésére képes gazdaalkalmazás a valódi vezérlőit egy írásvédett panelen mutatja
get_qml_content Egy kérdőív aktuális QML-kódjának és version_id értékének lekérése – ezt az alapot nevezi meg a mentés (32 KB fölött a beágyazott tartalom helyett rövid életű letöltési hivatkozást ad vissza)
validate_qml_file Z3 SMT-validálás futtatása egy kérdőív aktuális verzióján (elérhetőség, konzisztencia)
qml_quality_report A D2–D8 tervezésminőségi értékelőlap kiszámítása egy kérdőív aktuális verziójára
save_qml_file A megnevezett verzió (base_version_id, a get_qml_content eszközből) alapján írt QML mentése: ha egy újabb mentés más sorokat érintett, összefésüli vele; ha ugyanazokat, overlap válasszal elutasítja. Hibás piszkozatoknál sem blokkol (a 32 KB fölötti tartalmat elutasítja; ilyenkor használja az alábbi feltöltési eljárást)
request_upload_url / finalize_upload Kétlépéses feltöltés a save_qml_file 32 KB-os korlátját meghaladó QML-tartalom mentéséhez; a finalize_upload szintén megnevezi a base_version_id értéket
request_import_upload_url Egyszer használatos hivatkozás lekérése egy nyomtatott kérdőív (PDF vagy Markdown) projektbe való feltöltéséhez importálás céljából; a fájlt PUT kéréssel küldje rá
import_questionnaire A feltöltött fájl importálása új kérdőívpiszkozatként. Hosszan fut és költséges: a saját MI-szolgáltatóján fut, és beleszámít a havi importálási keretébe. A forrásban kitöltött válaszokat elveti, a feltöltött fájlt pedig törli. task_id azonosítót ad vissza a get_task_status számára. Tervező vagy menedzser szerepkör (vagy üzemeltető) és írási hozzáférés szükséges a projekthez
get_questionnaire_inventory Annak a leltárnak az olvasása, amelyből egy kérdőív készült: a leírt verzió, minden nyomtatott kérdésszám az elemazonosítójával, valamint azok az ellenőrzések, amelyeket nem nyomtattak, hanem hozzáadtak (invented), az importálási jelentéssel együtt
get_questionnaire_import_source Annak a forrásnak az olvasása Markdownként, amelyet egy PDF-importálás beolvasott: mit talált és távolított el (válaszok, élőfej és élőláb, nyomtatott oldalszámok), majd teljes oldalak a from_page oldaltól körülbelül max_chars karakterig (alapértelmezés: 32 000), a következő híváshoz next_page értékkel. Minden oldal egy jelölővel kezdődik, amely megnevezi az oldal helyét a fájlban, a rá nyomtatott számot, és hogy szövegként vagy képfelismeréssel olvasta-e be az importálás; a leltár oldalszámai a fájléi. A nem PDF-ből importált kérdőív import_source_not_found választ ad
list_qml_translations Nyelvenként: teljes-e egy verzió fordítása, mely szövegek nincsenek lefordítva, és hogy a fordítás befagyasztott vagy ember által szerkesztett-e
get_qml_translation Egy verzió egy nyelvű fordítása, a fordítás alapjául szolgáló összes forrásszöveggel és azzal az updated_at értékkel, amelyet a mentés megnevez
save_qml_translation Lefordított szöveg mentése egy nyelvre (részleges, a tárolt fordítással összefésülve; megnevezi a base_updated_at értéket). Csak szöveg: az ismeretlen azonosítókat vagy kódokat és a részleges pozicionális listákat elutasítja
delete_qml_translation Egy verzió egy nyelvű fordításának törlése (befagyasztás után elutasítja)
publish_qml_file Kérdőív közzététele egy kampány számára – formálisan validálja és rögzíti a pontos verziót (az egyetlen ellenőrzött kapu)
move_qml_to_project Kérdőív áthelyezése egy másik projektbe (a verzióelőzmény megmarad)
unpublish_qml_file Kérdőív logikai törlése a verzióelőzmény megtartásával (aktív kampányok esetén letiltva)

Paraméter-referencia – paraméterek, visszatérési sémák, a QML-életciklus, a Z3-kimenet szerkezete

Eszköz Leírás
list_indexed_documents Az MI-alapú szemantikus kereséshez indexelt összes dokumentum listázása, mindegyik a dokumentumkulcsával (például projects/<project-id>/report.pdf)
get_document_summary Egy dokumentum tárolt Markdown-összefoglalójának lekérése a document_key kulcsa alapján
get_document_chunk Egy indexelt dokumentum adott darabjának lekérése (document_key, chunk_index)
search_document_chunks_by_keyword Keresés kulcsszó alapján az indexelt dokumentumdarabokban, igény szerint a document_keys dokumentumokra szűkítve
Eszköz Leírás
read_paper Egy projekt kutatási tanulmányának olvasása – az összeállított fejezetek, valamint minden egység aktuális szerkesztési tokenje
edit_paper_unit Egy pontos szövegrész cseréje a tanulmány egyik egységén belül, miközben minden más bájtra pontosan változatlan marad
read_paper_translation A tanulmány egy nyelvű fordításainak olvasása: egység megadása nélkül minden egység állapota (naprakész, lemaradt, hiányzó) és szerkesztési tokenje; egységgel annak forrásszövege és fordítása egymás mellett
edit_paper_translation Egy egység fordításának írása egy nyelvre, az edit_paper_unit eszközhöz hasonlóan horgonyozva; a régebbi forrásból készült fordítást a rendszer teljes egészében lecseréli

A tanulmány a forrásnyelvén (angolul) készül. A fordítás minden egység mellett külön szöveg, amelyet azok az olvasók látnak, akik az adott nyelven olvassák a tanulmányt, és a rendszer soha nem írja bele a forrásegységbe. Az Askalot bővítmény translate-paper skillje végigvezeti az ügynököt egy fordítási meneten.

Eszköz Leírás
list_campaigns Kampányok listázása (igény szerint projektenként)
get_campaign Kampány részleteinek lekérése
create_campaign Új kampány létrehozása
update_campaign Kampánymezők módosítása (név, dátumok, állapot, önkéntesek fogadása, az MI-asszisztens felkínálása és szövegei)
delete_campaign Kampány törlése
add_interviewers_to_campaign Kérdezők felvétele (kérdező szerepkörű felhasználók)
remove_interviewers_from_campaign Kérdezők eltávolítása egy kampányból
update_campaign_questionnaire A kampányhoz rendelt kérdőív módosítása
assign_pool_to_campaign Válaszadói kör hozzárendelése egy kampányhoz
get_campaign_pool A kampányhoz rendelt válaszadói kör lekérése
send_campaign_invitations Kérdőíves meghívó e-mailek küldése a válaszadóknak

A válaszadók nem közvetlenül kerülnek a kampányba – rendeljen hozzá egy válaszadói kört az assign_pool_to_campaign eszközzel, majd a bulk_create_surveys a válaszadói kör minden válaszadójához létrehoz egy kitöltést.

Paraméter-referencia – paraméterek, visszatérési sémák, kötegelt minták, a meghívhatóság feltételei

Eszköz Leírás
list_respondents Az összes válaszadó (a kérdőívek célszemélyei) listázása
get_respondent Válaszadó részleteinek lekérése
create_respondent Új válaszadó létrehozása
update_respondent Válaszadó adatainak módosítása
delete_respondent Válaszadó eltávolítása
bulk_create_respondents Több válaszadó létrehozása egyszerre
bulk_delete_respondents Válaszadók törlése szűrő alapján (kétlépéses dry_run munkafolyamat)
generate_survey_access_token Belépési link tokenjének kiállítása egy válaszadó kitöltéséhez
send_survey_invitation Belépési linket tartalmazó kérdőíves meghívó e-mailben való elküldése egy válaszadónak

Paraméter-referencia – paraméterek, visszatérési sémák, tömeges létrehozás, demográfiai adatok

A válaszadói körökkel a válaszadókat több kampányban is felhasználható csoportokba rendezheti.

Eszköz Leírás
list_respondent_pools Az összes válaszadói kör listázása
get_respondent_pool Válaszadói kör részleteinek lekérése a válaszadók listájával együtt
create_respondent_pool Új válaszadói kör létrehozása
add_respondents_to_pool Válaszadók felvétele egy meglévő válaszadói körbe
remove_respondents_from_pool Válaszadók eltávolítása egy válaszadói körből
generate_pool_from_strategy Válaszadói kör húzása egy mintavételi stratégiából a kért méretben; a válaszadói kör eltárolja a húzás beállításait
preview_pool_generation Egy húzás előnézete a válaszadói kör létrehozása nélkül
plan_sample_size Írásvédett: egy húzás méretezése a projekt célkitűzéseinek célértékeiből (hibahatár vagy kétcsoportos statisztikai erő, kétoldali, normális közelítéssel), az alkalmassági arányból, a válaszadási arányból és a dizájnhatásból; visszaadja a szükséges befejezett kitöltések számát, a túlmintavételezési szorzót és a meghívandók számát, a mentett célértékek revíziójával együtt. Elérhető POST /api/v1/projects/{project_id}/sample-size-plan formában is
save_sizing_targets Minden célkitűzés célértékének mentése a projekt tanulmányába, megnevezve az olvasott revíziót; az elavult revízió ütközésnek számít (REST 409). Elérhető PUT /api/v1/projects/{project_id}/sizing-targets formában is
refresh_pool_from_strategy Egy meglévő válaszadói kör újrahúzása az általa tárolt húzási beállításokkal
delete_respondent_pool Válaszadói kör törlése

Paraméter-referencia – paraméterek, visszatérési sémák, az ismétlődések kezelése, generálás stratégiából

A mintavételi stratégiák a reprezentatív válaszadói minták létrehozásához szükséges demográfiai célmegoszlásokat határozzák meg. A stratégia nem tartalmaz méretet vagy kiválasztási beállítást – ezeket az egyes húzásoknál kell megadni –, így egyetlen stratégiából bármilyen méretű válaszadói kör húzható.

Eszköz Leírás
list_sampling_strategies Az összes mintavételi stratégia listázása
get_sampling_strategy Stratégia részleteinek lekérése a tényezőkkel együtt
create_sampling_strategy Stratégia létrehozása egyéni válaszadói tényezőkkel
create_default_strategy Stratégia létrehozása a szokásos nemi és életkori tényezőkkel
update_sampling_strategy Meglévő stratégia módosítása
delete_sampling_strategy Mintavételi stratégia törlése

Példa: egyéni mintavételi stratégia létrehozása

AI Assistant: I'll create a sampling strategy targeting your demographics.
→ create_sampling_strategy(
name="Urban Millennials",
project_id="...",
factors=[
{"name": "Gender", "attribute_path": "gender",
"target_distribution": {"male": 0.48, "female": 0.50, "other": 0.02}},
{"name": "Age Group", "attribute_path": "age",
"target_distribution": {"25-34": 0.60, "35-44": 0.40}}
]
)
Strategy created! Now generating a representative pool...
→ generate_pool_from_strategy(strategy_id, pool_name="Urban Millennials Pool",
requested_size=200)

Paraméter-referencia – paraméterek, visszatérési sémák, a tényezők sémája, a megoszlások validálása

Eszköz Leírás
list_users Az aktív szervezete felhasználóinak listázása (a kérdezőket is beleértve) – egy másik szervezet felhasználóinak megtekintéséhez hívja meg a switch_organization eszközt
get_user Felhasználó részleteinek lekérése

Megjegyzés: A kérdezők interviewer szerepkörű felhasználók. Felhasználóként kezelik őket, nem válaszadóként.

A kérdezős kampányoknál (kérdező szerepkörű felhasználókkal) így kezelheti a munkaterhelés elosztását:

Eszköz Leírás
assign_respondents_to_interviewer Válaszadók hozzárendelése egy adott kérdezőhöz (felhasználóhoz)
unassign_respondents_from_interviewer Kérdezői hozzárendelések megszüntetése
get_interviewer_workload A hozzárendelt válaszadók és a kitöltések állapotának megtekintése
get_unassigned_respondents A még hozzá nem rendelt válaszadók megkeresése
Eszköz Leírás
list_surveys Kitöltések listázása (kampány vagy válaszadó szerint szűrve)
create_survey Új kitöltési munkamenet indítása
update_survey Egy kitöltés állapotának és menetállapotának módosítása (a hozzákötött entitások nem módosíthatók)
bulk_create_surveys Kitöltések létrehozása egy kampány összes válaszadójának
bulk_delete_surveys Kitöltések törlése szűrő alapján (kétlépéses dry_run munkafolyamat)
get_survey_current_item Az aktuális kérdés lekérése a válaszlehetőségeivel együtt
submit_survey_response Válasz beküldése és továbblépés (a következő lépést is visszaadja)
finish_survey Egy kitöltés kifejezett lezárása
mass_fill_surveys Aszinkron háttérfeladat sorba állítása, amely szintetikus tesztválaszokkal tölti fel a kitöltéseket ({task_id, status} értéket ad vissza)
get_task_status Egy aszinkron feladat lekérdezése task_id alapján: egy mass_fill_surveys futás, egy simulate_campaign_responses vagy run_bundle_pipeline lánc, vagy egy import_questionnaire futás (az adatkészlet-kódolási feladatokat ehelyett a get_dataset eszközzel kell lekérdezni)

Paraméter-referencia – paraméterek, visszatérési sémák, állapotgép, megoszlási módok, perszónák

A csomag egy projektet, egy kérdőívet és a kampányok egy részhalmazát köti egyetlen lineáris Bronz → Ezüst → Arany adatkészlet-lánchoz. A csomageszközök ezt a kötést kezelik, és a csomag minőségének alakulását mutatják; az adatkészlet-eszközök az egyes csomaghoz kötött fázisokat futtatják – kinyerés, kódolás + súlyozás, finomítás és export.

Eszköz Leírás
create_bundle Adatfolyam-csomag létrehozása
list_bundles Csomagok listázása, igény szerint egy projektre szűkítve
get_bundle Csomag részletei, a fázisreceptekkel együtt (Ezüst kalibrációs célértékek, Arany műveletek)
clone_bundle Egy csomag kész adatkészleteinek és receptjeinek mély másolása egy független változatba
delete_bundle Csomag és adatkészlet-láncának törlése
get_bundle_quality A csomag reprezentativitásának alakulása (kiválasztás, terepen megvalósult, súlyozott, terepmunka-eltolódás, válaszadás)
compare_bundle_quality A Bronz és az Ezüst adatkészlet közötti javulás a csomag aktuális stratégiájához mérten
get_bundle_coding A nyitott válaszok kódolásának állapota – a Bronz adatkészlet által kínált jelöltek, az elemző által mindegyikhez megadott választípus (leíró, nominális vagy azonosító; hiánya = nem besorolt), a kérdések kiválasztása, valamint kérdésenként a javasolt dimenziók, azok kategóriái és hogy melyek vannak kiválasztva
set_coding_selection Annak beállítása, mely nyitott szöveges egységeket kódolja a csomag (menedzser szerepkör, azonosított felhasználó szükséges); elutasítja a nem besorolt vagy azonosító egységet, és egyetlen eszköz sem sorol be egységet
assign_bundle_strategy A csomag aktuális mintavételi stratégiájának hozzárendelése (vagy törlése)
set_calibration_targets A csomag kalibrációs célértékeinek szerkesztése – ez az Ezüst adatkészlet súlyozási specifikációja –, mindegyik raked (súlyozás alapja) vagy benchmark (csak értékelésre); minden mentés ellenőrzi a válaszkódokat a csomag kérdőívével szemben
preview_calibration_targets_copy Egy másik csomag kalibrációs célértékeinek erre a csomagra való másolásának előnézete: melyek illenek (a szerepükkel együtt), és melyek nem, indoklással; semmit sem ír
list_datasets Egy csomag láncához tartozó adatkészletek listázása
get_dataset Adatkészlet részleteinek, mérőszámainak és állapotának lekérése – ez az a szűk felület, amelynek lekérdezését az adatfolyam lépései javasolják
get_dataset_schema Egy adatkészlet oszlopsémájának, vagy csak az oszlopneveinek és vezérlőtípusainak lekérése, igény szerint megnevezett oszlopokra szűkítve
create_bronze_dataset Egy csomag Bronz adatkészletének kinyerése
code_open_ends (alias: derive_silver) A nyitott szöveges válaszok kódolása, majd súlyozás a kalibrációs célértékekhez, amelyből a csomag Ezüst adatkészlete keletkezik
create_gold_dataset Egy csomag Ezüst adatkészletének finomítása Arany adatkészletté az Arany műveletkatalógus segítségével
export_dataset Kész adatkészlet exportálása (CSV, XLSX, SPSS, Parquet, R, JSON)
delete_dataset Adatkészlet törlése

Csomageszközök referenciája – a csomag életciklusának és minőségének paraméterei, visszatérési sémák

Adatkészlet-eszközök referenciája – fázisparaméterek, visszatérési sémák, exportformátumok

Eszköz Leírás
query_audit_events Keresés az auditnaplóban szűrőkkel
get_entity_history Bármely entitás teljes előzményének megtekintése
get_audit_stats Eseményszámok entitástípusonként

Mindhárom csak az Ön bérlőjét és az aktív szervezetét olvassa. Egy másik szervezet naplójának olvasásához előbb váltson át oda. A szervezet nélkül feljegyzett eseményeket, például a rendszer- és szolgáltatásműveleteket, nem adják vissza.

A szervezeten belül az, hogy mit lát, a szerepkörétől függ:

Ki Mit adnak vissza az auditeszközök
Adminisztrátor (a szervezet org_admin felhasználója vagy Askalot-üzemeltető) A teljes szervezet naplóját, a get_audit_stats eszközt is beleértve
manager A saját műveleteit, valamint az Ön tulajdonában lévő projekteknek és azok kérdőíveinek, kampányainak és kitöltéseinek teljes előzményét
Bárki más Csak a saját műveleteit

Egy másik felhasználó műveleteinek, vagy az Ön hatókörén kívül eső entitás előzményének lekérését a rendszer elutasítja. A get_audit_stats csak adminisztrátoroknak érhető el, és a nem felhasználó nevében eljáró kapcsolat egyáltalán nem olvas auditadatot. Abban a szervezetben, ahol minden tag minden projektet olvas – ilyen például a nyilvános Askalot Demo szervezet –, az auditnapló csak adminisztrátoroknak érhető el: a kutatás olvasása nem terjed ki arra, hogy ki mit csinált, mert az auditesemények olyan részleteket is tartalmaznak, mint az IP-címek.

A böngészős auditnézet ugyanezeket a szerepköröket alkalmazza, de ott egy Askalot-üzemeltető és egy átlagos felhasználó messzebbre lát:

Ki Mit mutat a böngészős auditnézet
Askalot-üzemeltető (tenant_admin) A bérlő minden eseményét, az összes szervezetre kiterjedően
Szervezeti adminisztrátor (org_admin) Az aktív szervezet minden eseményét
manager Az aktív szervezeten belül: a saját műveleteit, valamint az Ön tulajdonában lévő projekteknek és azok kérdőíveinek, kampányainak és kitöltéseinek előzményét
Bárki más Csak a saját műveleteit, a bejelentkezéseit is beleértve

A rendszer a bejelentkezést abban a szervezetben rögzíti, amelyben a munkamenet indul, a kijelentkezést vagy a jelszómódosítást pedig abban, amelyben a munkamenet éppen dolgozik, így ezek bármely más művelethez hasonlóan az adott szervezet naplójának részei.

Eszköz Leírás
list_documentation Az elérhető dokumentáció listázása
get_documentation Egy adott dokumentum betöltése
search_documentation Keresés kulcsszó alapján a dokumentációban

Az erőforrások írásvédett hozzáférést adnak a platform adataihoz:

Erőforrás URI-ja Leírás
repository://overview Platformstatisztikák és darabszámok
repository://schema Az entitások kapcsolatai és szerkezete
qml://files A szervezet QML-kérdőívei
docs://primer A platform áttekintése
docs://qml-syntax A QML nyelv referenciája
docs://getting-started Első lépések (gyors útmutató)

További dokumentációs erőforrások tükrözik a tudásbázist (docs://guide, docs://glossary, docs://campaign-management, docs://survey-execution, docs://creating-surveys, docs://data-analysis, docs://quality-metrics).

Kérdőíves kampány létrehozása MI-vel

Szekció neve “Kérdőíves kampány létrehozása MI-vel”
AI Assistant: I'll help you set up a customer satisfaction survey.
1. First, let me create a project...
→ create_project("Customer Research 2026", "Annual satisfaction study")
2. Now I'll register your questionnaire...
→ create_questionnaire("CSAT Survey", qml_content, project_id)
3. Creating the campaign...
→ create_campaign("Q1 CSAT", project_id, questionnaire_id, admits_volunteers=false, offers_ai_channel=false)
4. Adding your respondent list...
→ bulk_create_respondents(100, generate_demographics=true)
→ create_respondent_pool("CSAT Sample", respondent_ids=[...])
→ assign_pool_to_campaign(campaign_id, pool_id)
→ bulk_create_surveys(campaign_id)
Your campaign is ready! 100 respondents have surveys waiting.
AI Assistant: I'll import your paper questionnaire into the project.
1. Getting an upload link for the PDF...
→ request_import_upload_url(project_id, "application/pdf")
PUT the file to upload_url with Content-Type: application/pdf
2. Starting the import (this takes a few minutes)...
→ import_questionnaire(project_id, upload_id, "visitor-survey.pdf")
→ get_task_status(task_id) # until completed or failed
3. Reading what it built...
→ get_questionnaire_inventory(result.questionnaire_id)
Each printed question number maps to its item id; the checks marked
invented were added and are worth reviewing before you publish.
4. Checking a question against what the import read (PDF only)...
→ get_questionnaire_import_source(result.questionnaire_id, from_page=12)

Az elutasított importálás semmit sem indít el, és megmondja, mi szünteti meg az akadályt: unsupported_type (jelenleg csak PDF és Markdown olvasható), too_large, invalid_request, no_ai_slot (a Profilbeállításokban adjon meg egy Anthropic API-kulcsot vagy csatlakoztassa az Amazon Bedrockot, és válasszon Közvetlen LLM modellt) vagy fair_use_exceeded (a havi importálási keret). Az elutasított importáláshoz új feltöltés szükséges, mert a fájl mindenképpen törlődik.

AI Assistant: I'll create a demographically balanced sample for your study.
1. Creating a sampling strategy with your target demographics...
→ create_sampling_strategy(
name="National Representative",
project_id,
factors=[
{"name": "Gender", "attribute_path": "gender",
"target_distribution": {"male": 0.49, "female": 0.51}},
{"name": "Age", "attribute_path": "age",
"target_distribution": {"18-34": 0.30, "35-54": 0.40, "55+": 0.30}}
]
)
2. Generating a pool that matches your targets...
→ generate_pool_from_strategy(strategy_id, pool_name="Q1 Sample Pool",
requested_size=500)
3. Assigning the pool to your campaign...
→ assign_pool_to_campaign(campaign_id, pool_id)
Done! Your campaign now has 500 respondents balanced to match
national demographics.
AI Assistant: I'll walk through the survey and show you each question.
→ create_survey(questionnaire_id, respondent_id)
→ get_survey_current_item(survey_id)
Question 1: "What is your age?"
Type: Integer input (18-100)
User: 35
→ submit_survey_response(survey_id, "q_age", 35)
→ get_survey_current_item(survey_id)
Question 2: "How satisfied are you with our service?"
Type: Scale (1-5)
...

A kérdezők munkaterhelésének kezelése

Szekció neve “A kérdezők munkaterhelésének kezelése”
AI Assistant: Let me distribute the 50 respondents among your 5 interviewers (Users with interviewer role).
→ get_unassigned_respondents(campaign_id)
Found 50 unassigned respondents
→ assign_respondents_to_interviewer(campaign_id, interviewer_user_1, respondents[0:10])
→ assign_respondents_to_interviewer(campaign_id, interviewer_user_2, respondents[10:20])
...
→ get_interviewer_workload(campaign_id, interviewer_user_1)
Assigned: 10 respondents
Completed: 0
In Progress: 0

Az entitásmodell ismerete segít az MCP-felülettel való munkában:

Project
├── Questionnaire (owns a QML version chain)
└── Campaign
├── Respondents (survey targets)
├── Interviewers (Users with interviewer role, optional)
└── Surveys (individual sessions)

Minden kérdőív egy projekthez tartozik, és minden felhasználónak van egy alapértelmezett projektje (is_default: true). Ha egy kérés nem nevez meg projektet, keresse meg az alapértelmezettet a list_projects eszközzel, és annak azonosítóját használja.

  • Válaszadók: a kérdőívek demográfiai adatokkal rendelkező célszemélyei. Az ő kitöltéseik határozzák meg a kampány előrehaladását. A kérdőíveket belépési linken keresztül érik el (platformhitelesítés nélkül).
  • Kérdezők (opcionális): interviewer szerepkörű felhasználók, akik a válaszadók kitöltését segítik. Bejelentkezhetnek a platformra, és segítenek a válaszadóknak kitölteni a kérdőíveket, de maguk nem töltenek ki kérdőívet.

A kérdezőket hozzárendelheti a válaszadókhoz, hogy személyesen vagy telefonon segítsenek nekik. Ha kérdezők vannak hozzárendelve, a kitöltések rögzítik, melyik kérdező segítette az egyes válaszadók kitöltését.

  • A válaszadók a kérdőívek demográfiai adatokkal (életkor, nem, lakóhely) rendelkező célszemélyei. Nincs platformfiókjuk.
  • A felhasználók a hitelesítésre és a kezelésre szolgáló platformfiókok. Az interviewer szerepkörű felhasználók segíthetik a kitöltéseket.
  • A válaszadók és a felhasználók különálló entitások. A kérdezők felhasználók, nem válaszadók.

Az MCP-eszközök strukturált hibaüzeneteket adnak vissza. Kettő minden kategóriára vonatkozik:

  • not_found – az entitás nincs a munkamenet aktív szervezetében. Az üzenet megnevezi a szervezetet, amelyben keresett; lásd: Az Ön aktív szervezete.
  • org_sealed – az aktív szervezet le van zárva. Az olvasás sikeres; ezt az elutasítást csak olyan eszköz adhatja, amely megváltoztatta volna a kutatási nyilvántartást.

A részletes hibamintákat kategóriánként dokumentáljuk: