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.
Mi az MCP?
Szekció neve “Mi az MCP?”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
Csatlakozás az MCP-felülethez
Szekció neve “Csatlakozás az MCP-felülethez”Végpont
Szekció neve “Végpont”https://portor.<tenant>.askalot.io/mcpA <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.
Hitelesítés
Szekció neve “Hitelesíté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):
- Irányítsa a klienst a bérlőjére (
export ASKALOT_MCP_URL=https://portor.<tenant>.askalot.io/mcp). - Hívjon meg egy tetszőleges MCP-eszközt. A kliens megnyitja a böngészőben a Portor
/authorizevégpontját, amely átirányít a platform OIDC-bejelentkezésére. - 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.
- 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 Ön aktív szervezete
Szekció neve “Az Ön aktív szervezete”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.
Lezárt szervezetek
Szekció neve “Lezárt szervezetek”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 Ön MI-modellbeállításai
Szekció neve “Az Ön MI-modellbeállításai”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.
Mindig a legújabb modell használata
Szekció neve “Mindig a legújabb modell használata”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_configurationvisszaadja azauto_latestértéket (panelenként, adirect_llmés areasoningesetén: be van-e kapcsolva a jelölőnégyzet) és azauto_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 azok, ano_newer_model, apending_verification, ano_credential, acatalog_unreadable, asession_expired, vagy maga a próbahívás elutasítási oka. - Az
update_model_configurationhívásban egy panel bármely modellhelyére megadottmodel_idké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 kialakultauto_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 és a REST közötti választás
Szekció neve “Az MCP és a REST közötti választás”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_respondentsmindké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ésderive_silvercsak MCP-n érhető el. REST-megfelelőjük nincs, felesleges keresni. - Az adatkészletek nem csak MCP-n érhetők el. A
list_datasets, aget_dataset, adelete_datasetés azexport_datasetmind rendelkezik útvonallal az/api/v1/datasetsalatt, é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öttiget_qml_contentrövid életű, aláírtdownload_urlcí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_contenteszközzel, majd adja át annakversion_idértékétbase_version_id-ként asave_qml_filevagy afinalize_uploadhívásnak. Mentés után azt aversion_idértéket nevezze meg, amelyet a mentés visszaadott.overlapeseté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_statuseszközzel egy feladatazonosítóra, vagy aget_dataseteszkö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,campaignAz é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=analyströ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.
Egy teljes lánc egyetlen hívásban
Szekció neve “Egy teljes lánc egyetlen hívásban”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_fieldinga meghívók kiküldése előtt megáll. Soha nem küld; az külön, megfontoltsend_campaign_invitationshí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_stepmező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. Arun_bundle_pipelinea 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ötterrorésdetailmezővel,successkulcs 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.
Elérhető eszközök
Szekció neve “Elérhető eszközök”Az MCP-felület funkciók szerint csoportosított eszközöket kínál.
Munkamenet és szervezetek
Szekció neve “Munkamenet és szervezetek”| 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 |
Projektkezelés
Szekció neve “Projektkezelés”| 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) |
Kérdőívműveletek
Szekció neve “Kérdőívműveletek”| 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
Dokumentumfelderítés
Szekció neve “Dokumentumfelderítés”| 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 |
Kutatási tanulmány
Szekció neve “Kutatási tanulmány”| 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.
Kampánykezelés
Szekció neve “Kampánykezelés”| 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
Válaszadókezelés
Szekció neve “Válaszadókezelés”| 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
Válaszadói körök
Szekció neve “Válaszadói körök”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
Mintavételi stratégiák
Szekció neve “Mintavételi stratégiák”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
Felhasználókezelés
Szekció neve “Felhasználókezelés”| 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ők munkaterhelése
Szekció neve “A kérdezők munkaterhelése”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 |
Kérdőívek kitöltése
Szekció neve “Kérdőívek kitölté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
Adatelemzés
Szekció neve “Adatelemzés”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
Audit és megfelelőség
Szekció neve “Audit és megfelelőség”| 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.
Hozzáférés a dokumentációhoz
Szekció neve “Hozzáférés a dokumentációhoz”| 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 |
MCP-erőforrások
Szekció neve “MCP-erőforrások”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).
Munkafolyamat-példák
Szekció neve “Munkafolyamat-példák”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.Nyomtatott kérdőív importálása
Szekció neve “Nyomtatott kérdőív importálása”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.
Reprezentatív minta létrehozása
Szekció neve “Reprezentatív minta létrehozása”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 matchnational demographics.Kérdőív programozott kitöltése
Szekció neve “Kérdőív programozott kitöltése”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: 0A platform fogalmai
Szekció neve “A platform fogalmai”Az entitásmodell ismerete segít az MCP-felülettel való munkában:
Entitáshierarchia
Szekció neve “Entitáshierarchia”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 és kérdezők
Szekció neve “Válaszadók és kérdezők”- 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):
interviewerszerepkö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.
Válaszadók és felhasználók
Szekció neve “Válaszadók és felhasználók”- 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
interviewerszerepkö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.
Hibakezelés
Szekció neve “Hibakezelés”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:
- Kampányeszközök – kötegelt minták (added/skipped/reasons), a meghívhatóság feltételei
- Kitöltési eszközök – az állapotgép átmenetei, menethibák
- Adatkészlet-eszközök – fázisvalidálás, formátumhibák
- Válaszadóikör-eszközök – az ismétlődések kezelése, a stratégia validálása
- Mintavételi eszközök – a tényezők sémájának validálása, az alapértelmezett stratégia védelme
- Kérdőíveszközök – életciklus-korlátozások, az aktív kampányok ellenőrzése
- Válaszadói eszközök – a tömeges létrehozás hibái