add_questions_bulk
ChatGPTKérdéseket visz fel egy saját, még nem publikált feladatlap-vázlatba (legfeljebb 50-et egyszerre). Vagy minden kérdés bekerül, vagy egyik sem: hiba esetén a válasz kérdésenként felsorolja, mit kell javítani. Ha a kérdésekhez szükséges adat (téma, évfolyam, darabszám, típusok) nem egyértelmű, előbb kérdezd meg a felhasználót. Képes kérdéshez (pl. 'Mit jelent ez a jelzés?') a kérdés imageMediaId-ját, képes válaszokhoz (pl. 'Melyik képen helyes az emelés?', SELECTONE / SELECTMULTIPLE) a válaszok imageMediaId-ját add meg; a képeket a list_my_media (vagy az import_material_image / upload_image_file) adja meg. A kérdés szövege rövid legyen; a hosszabb feladatszöveg, adatok, képletek a kérdés leírásába (description) kerüljenek. Típusonként más válaszmező kell (answers, answerText, items, pairs, statements, fillinText, cardFront/cardBack; a szabályokat a list_question_types adja meg); a feladathoz illő típust válaszd (pl. sorrendhez SORTING, párosításhoz PAIR, több igaz/hamis állításhoz SELECTLIST, rövid beírandó válaszhoz TEXT). Matematikai képletet LaTeX-ben írj: szövegközben \( ... \), külön sorban \[ ... \] (pl. \( \frac{3}{4} + \frac{1}{4} = 1 \)); a $ jelet ne használd képlethatárolónak.
attach_materials
ChatGPTTananyagot csatol egy saját DRAFT feladatlaphoz a felhasználó Tananyagok tárából, azonosító vagy pontos név alapján. Feladatlaponként legfeljebb 10 tananyag lehet; a már csatolt kimarad. Ha a név több tananyagra illik, vagy egyikre sem, a hiba felsorolja a jelölteket: kérdezd meg a felhasználót, melyikre gondol, ne találgass. Azt, hogy a diáknak kitöltés előtt kötelező-e letölteni a tananyagot, az update_exam materialDownloadRequired mezője állítja.
create_exam_draft
ChatGPTÚj, üres feladatlap-vázlatot hoz létre a felhasználó nevében. A vázlat nem publikus; a tanár a quizOffice-ban ellenőrzi és teszi közzé. Ha a felhasználó nem adta meg a címet vagy a témát, kérdezd meg tőle, ne találj ki. A tantárgyat, az évfolyamot és a típust névvel add meg (examCategory, examGroup, examType; pl. 'Történelem', '7. osztály', 'Dolgozat'), ha a kérésből kiderül. A kérdéseket utána az add_questions_bulk-kal vidd fel.
create_material_upload
ChatGPTFeltöltési linket ad tananyaghoz (pdf, docx, xlsx, pptx, jpg, png). Előbb a list_my_materials-szel nézd meg, nincs-e már meg a tananyag (akkor elég csatolni). A felhasználó a linken, a böngészőben tölti fel a fájlokat. Ha a fájlt át tudod adni (pl. ChatGPT-ben a beszélgetéshez csatolt vagy általad generált fájl), ne linket kérj, hanem használd az upload_material_file toolt. A link egyszer használható, 30 percig érvényes. Ha a fájl már megvan a felhasználónál (azonos tartalom), nem tárolódik újra, a meglévő használódik. A feltöltés után a get_upload_result adja meg az azonosítókat.
create_media_upload
ChatGPTFeltöltési linket ad képhez (jpg, png) a kérdés- és válaszképekhez, ha a kép nincs meg a Médiatárban (list_my_media). A túl nagy képet a QuizOffice kicsinyíti. A felhasználó a linken, a böngészőben tölti fel a fájlokat. Ha a fájlt át tudod adni (pl. ChatGPT-ben a beszélgetéshez csatolt vagy általad generált fájl), ne linket kérj, hanem használd az upload_image_file toolt. A link egyszer használható, 30 percig érvényes. Ha a fájl már megvan a felhasználónál (azonos tartalom), nem tárolódik újra, a meglévő használódik. A feltöltés után a get_upload_result adja meg az azonosítókat.
detach_material
ChatGPTLeveszi a tananyagot egy saját DRAFT feladatlapról (mediaId vagy pontos név alapján). A tananyag a felhasználó Tananyagok tárában megmarad. Levétel előtt erősítsd meg a felhasználóval.
get_exam
ChatGPTEgy saját feladatlap alapadatai, kérdései és válaszai (a helyes válaszokkal), valamint a csatolt tananyagai (materials) és az, hogy kitöltés előtt kötelező-e letölteni őket (materialDownloadRequired). Módosítás előtt mindig kérdezd le: a kérdésazonosítókat (questionId) és azt, hogy mi módosítható (editable), ez adja meg.
get_upload_result
ChatGPTEgy feltöltési link (create_material_upload / create_media_upload) állapota és eredménye: waiting (a felhasználó még nem töltött fel), expired (lejárt), done (kész). Kész feltöltésnél fájlonként a mediaId, a név, hogy már korábban is megvolt-e (duplicate), tananyagnál hogy csatolódott-e a feladatlaphoz (attached), illetve a hiba.
import_material_image
ChatGPTEgy feltöltött tananyag képét (imageRef), vagy egy PDF-oldal / pptx-dia (kivágott) részét képként a Médiatárba (a feladatlap mappájába) menti, és visszaadja a mediaId-t, amely kérdés-, válasz- vagy feladatlap-képként (imageMediaId; update_exam: examImageMediaId) használható. A túl nagy képet kicsinyíti; ha a kép már megvan a Médiatárban, a meglévő mediaId jön vissza. Csak a képes kérdésekhez szükséges képeket vedd át.
list_exam_options
ChatGPTA feladatlaphoz választható kategóriák (tantárgyak, alkategóriával, és a tanár saját kategóriái: own=true), évfolyamok és feladatlap-típusok nevei. A create_exam_draft és az update_exam examCategory / examGroup / examType paramétere ezeket a neveket fogadja el.
list_material_images
ChatGPTEgy feltöltött tananyag (PDF, pptx, docx, xlsx vagy kép) képei: hivatkozás (imageRef), hely (oldal, dia, munkalap; Wordnél sorszám és a környező szöveg), méret, és legfeljebb 12 kép kis előnézete. A tananyag szövegét a felhasználó által a beszélgetéshez csatolt fájlból olvasd; ez a tool a képes kérdésekhez kell: a kiválasztott képet az import_material_image veszi át a Médiatárba.
list_my_exams
ChatGPTA felhasználó saját feladatlapjai (a legújabb 100), kérdésszámmal és állapottal. Az MCP-n át csak a DRAFT (vázlat) állapotú módosítható.
list_my_materials
ChatGPTA felhasználó tananyagai a quizOffice Tananyagok tárából: mediaId, név, fajta (pdf, docx, xlsx, pptx, image, link), fájlnév és méret (linknél az URL), mappa, és hány feladatlapon szerepel. Mielőtt feltöltést kérnél a felhasználótól, nézd meg itt, megvan-e már: a meglévőt névvel vagy mediaId-val csatolhatod (attach_materials), nem kell újra feltölteni.
list_my_media
ChatGPTA felhasználó képei a quizOffice Médiatárából (vagy kereséssel a nyilvános képtárból): mediaId, név, mappa, méret. A mediaId a kérdés- és válaszképhez (add_questions_bulk, update_question: imageMediaId) és a feladatlap-képhez (update_exam: examImageMediaId) használható.
list_question_types
ChatGPTA feladatlapokban használható kérdéstípusok és a válaszokra vonatkozó szabályaik.
remove_question
ChatGPTTörli a kérdést egy saját DRAFT feladatlapból. A csak ebben a feladatlapban szereplő saját kérdés véglegesen törlődik; a más feladatlapban is szereplő csak erről kerül le. Törlés előtt erősítsd meg a felhasználóval, melyik kérdésről van szó.
update_exam
ChatGPTEgy saját feladatlap-vázlat alapadatait (cím, leírás, szint, kategória, évfolyam, típus) és kitöltési beállításait (kérdések keverése, megjelenített kérdések száma, próbálkozások, részleges kitöltés, megjelenítési mód, eredmény kijelzése, időkorlát, lehetséges hibák) módosítja; ami nincs megadva, az marad. Csak DRAFT állapotú feladatlap módosítható. A feladatlap-kép (examImageMediaId) beállítható; a borítóképet viszont a QuizOffice a saját szabálya szerint állítja be, azt nem módosíthatod.
update_question
ChatGPTEgy kérdés teljes cseréje (szöveg, magyarázat, válaszok) egy saját DRAFT feladatlapban, az add_questions_bulk szabályaival. Előbb a get_exam-mal kérdezd le a kérdést, és a teljes, javított kérdést add meg: a ki nem töltött explanation törlődik, a score ha nincs megadva, marad. A típus nem változtatható. Csak az a kérdés módosítható, amely a get_exam szerint editable (pl. más feladatlapban nem szerepel, és nincs kitöltése).
upload_image_file
ChatGPTEgy kérdés-, válasz- vagy feladatlap-képet a Médiatárba ment (a feladatlap mappájába), és visszaadja a mediaId-t (add_questions_bulk, update_question: imageMediaId; update_exam: examImageMediaId). A feladatlap-kép a feladatlap tetején, a teljes oldalszélességben jelenik meg (pl. keskeny díszcsík): ehhez széles, alacsony képet készíts. Borítót nem tölthetsz fel: azt a QuizOffice szabálya állítja be. Ha egy kérdéshez kép kell, és nincs meg a tananyagban (list_material_images) vagy a Médiatárban (list_my_media), generálj hozzá saját, egyedi képet, és ezzel töltsd fel. Jogvédett képet, logót, márkajelzést vagy valós személy képét ne másold le és ne utánozd. A túl nagy képet a QuizOffice kicsinyíti. A fájlt a file paraméterben add át. Ha a kliensed nem tud fájlt átadni (nincs letöltési linked), használd a feltöltési linket (create_media_upload). Azonos tartalmú fájl nem tárolódik újra, a meglévő használódik (duplicate).
upload_material_file
ChatGPTA felhasználó által a beszélgetéshez csatolt tananyagfájlt feltölti a QuizOffice Tananyagai közé (és examId-val a feladatlaphoz csatolja), hogy a tanulók a feladatlap mellett megnyithassák, és a képei átvehetők legyenek (list_material_images). Előbb a list_my_materials-szel nézd meg, nincs-e már meg. A fájlt a file paraméterben add át. Ha a kliensed nem tud fájlt átadni (nincs letöltési linked), használd a feltöltési linket (create_material_upload). Azonos tartalmú fájl nem tárolódik újra, a meglévő használódik (duplicate).
