QuizOffice

Egy 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_exam

A 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_exam_options

Egy 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_exam

Ú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_exam_draft

Egy 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.

get_upload_result

Egy 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_image_file

Feltö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.

create_media_upload

Egy 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.

import_material_image

A 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_my_media

Egy 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_material_images