Satu Prompt AI Jadi Latihan Soal Lengkap di PapanAjar

Kalau kamu sudah menghubungkan PapanAjar ke ChatGPT lewat MCP, ada satu tool yang bisa menghemat banyak waktu: import_quiz. Alih-alih membuat soal satu per satu, kamu minta AI menyusun seluruh paket latihan sekaligus, lalu tool ini menyimpannya dalam satu kali proses.

Hasilnya: satu latihan baru lengkap dengan wacana, soal, bobot, dan kunci jawaban—langsung siap kamu periksa dan terbitkan.

Apa yang dilakukan import_quiz?

Tool import_quiz menerima satu objek data berisi meta latihan, daftar stimuli (wacana), dan daftar soal. Satu panggilan akan membuat semuanya sekaligus: baris latihan, wacana, soal, hingga kunci jawaban tersimpan terpisah dengan aman.

Menariknya, kamu tidak perlu tahu ID koleksi. Cukup sebutkan collection_slug atau collection_title, dan sistem akan mencocokkannya sendiri. Kalau koleksinya belum ada, minta AI membuatnya lebih dulu dengan tool koleksi.

Prompt yang bisa langsung kamu salin

Kunci agar hasilnya langsung valid adalah menjelaskan rancangan soal dan aturan formatnya. Gunakan prompt berikut, sesuaikan bagian judul, koleksi, dan jumlah soal.

Buat satu paket latihan soal lengkap, lalu simpan ke PapanAjar
langsung dalam SATU kali proses dengan tool import_quiz.
Jangan buat soal satu per satu.

Judul: "Latihan TKA Matematika Kelas 6"
Deskripsi: "Latihan persiapan TKA, materi operasi bilangan dan geometri."
Koleksi: "Matematika Kelas 6" (kalau belum ada, buat dulu dengan create_collection)
Durasi: 60 menit
Kode siswa: terbuka (bebas, boleh mengulang)
Tampilkan skor: ya
Acak soal: tidak, acak opsi: tidak
Status: langsung terbitkan

Rancangan 8 soal:
1) 1 wacana ("Bacaan 1") berisi 3 soal pilihan ganda, opsi A-D, 1 kunci.
2) 1 pilihan ganda kompleks (4 opsi, 2 kunci), scoring partial_proportional, bobot 2.
3) 1 soal menjodohkan (left L1-L3, right R1-R3), bobot 3.
4) 3 isian singkat: 2 teks (accepted boleh beberapa ejaan) dan 1 angka
   dengan numeric: true dan tolerance: 0, bobot 1.

Aturan wajib agar langsung valid:
- type hanya: multiple_choice, multiple_choice_complex, matching, short_answer.
- multiple_choice: 2-5 opsi, answer_key.correct tepat 1 id.
- multiple_choice_complex: 2-8 opsi, answer_key.correct minimal 1 id.
- matching: id pada answer_key.pairs harus ada di options.left/right.
- short_answer: answer_key.accepted minimal 1 jawaban.
- points > 0, tiap opsi berformat { "id": "...", "text": "..." }.
- Maksimal 200 soal dan ukuran data di bawah 1 MB.

Setelah selesai, laporkan quiz_id dan jumlah soal yang berhasil dibuat.

Setelah AI selesai, ia akan melaporkan quiz_id dan jumlah soal yang berhasil dibuat. Buka dashboard latihan, dan paket soalmu sudah tersusun rapi.

Apa yang dikirim di balik layar

Saat kamu memberi perintah, ChatGPT menyusun data dengan bentuk seperti ini lalu mengirimkannya ke tool import_quiz. Kamu tidak perlu mengetiknya sendiri—ini hanya gambaran agar kamu paham struktur yang dihasilkan AI. Hanya title yang wajib; sisanya punya nilai bawaan yang masuk akal.

{
  "title": "Latihan TKA Matematika Kelas 6",
  "description": "Latihan persiapan TKA.",
  "collection_slug": "matematika-kelas-6",
  "duration_minutes": 60,
  "scoring_mode": "scale_100",
  "show_score": true,
  "shuffle_questions": false,
  "shuffle_options": false,
  "student_code_mode": "open",
  "is_published": true,
  "stimuli": [
    {
      "title": "Bacaan 1",
      "content_md": "Teks wacana sebagai konteks soal...",
      "questions": [
        {
          "type": "multiple_choice",
          "prompt": "Pernyataan yang benar adalah ...",
          "points": 1,
          "options": [
            { "id": "A", "text": "Pilihan A" },
            { "id": "B", "text": "Pilihan B" },
            { "id": "C", "text": "Pilihan C" },
            { "id": "D", "text": "Pilihan D" }
          ],
          "answer_key": { "correct": ["A"] }
        }
      ]
    }
  ],
  "questions": [
    {
      "type": "multiple_choice_complex",
      "prompt": "Pilih semua jawaban yang benar.",
      "points": 2,
      "options": [
        { "id": "A", "text": "Pilihan A" },
        { "id": "B", "text": "Pilihan B" },
        { "id": "C", "text": "Pilihan C" },
        { "id": "D", "text": "Pilihan D" }
      ],
      "answer_key": { "correct": ["A", "C"] },
      "scoring": { "mode": "partial_proportional" }
    },
    {
      "type": "short_answer",
      "prompt": "Hasil dari 12 : 4 adalah ...",
      "points": 1,
      "answer_key": { "accepted": ["3"], "numeric": true, "tolerance": 0 }
    }
  ]
}

Kolom meta yang sering dipakai

• duration_minutes — durasi timer; kosongkan jika tanpa batas.
• scoring_mode — raw atau scale_100 (default).
• show_score — tampilkan nilai ke siswa setelah submit.
• shuffle_questions & shuffle_options — acak urutan soal dan opsi.
• student_code_mode — closed (kode terdaftar) atau open (bebas).
• is_published — langsung terbitkan, atau biarkan draf.

Dua hal yang perlu diingat

• Kode siswa tidak dibuat otomatis. Jika memakai mode tertutup, daftarkan kodenya setelah latihan dibuat lewat halaman /dashboard/latihan/[id]/kode. Untuk mode terbuka, tidak perlu apa-apa.
• Jumlah soal dibatasi. Maksimal 200 soal per pemanggilan import_quiz, jadi minta AI memecahnya menjadi beberapa paket bila soalnya sangat banyak.

Menyiapkan koneksi MCP lebih dulu

Supaya cara ini bekerja, PapanAjar harus tersambung ke ChatGPT sebagai konektor MCP. Setelah terhubung, ChatGPT otomatis mengenali tool import_quiz (serta tool koleksi dan soal lain) dan bisa memanggilnya sendiri ketika kamu memintanya.

Kamu tidak perlu menulis atau menempel JSON sama sekali. Cukup ngobrol seperti biasa—AI yang menyusun datanya, lalu mengirimkannya lewat tool MCP. Kalau koleksi yang kamu sebut belum ada, AI juga bisa membuatnya lebih dulu dengan tool create_collection.

Kalau ingin membuat soal lanjutan

Setelah latihan pertama jadi, kamu bisa menambah soal tambahan ke latihan yang sama lewat tool bulk_create_questions, atau mengubah pengaturannya lewat update_quiz. Semua tetap dilakukan dengan percakapan, tanpa membuka dashboard.