Jawaban singkat: Buka AI agent kamu, berikan API key Eduqat kamu, lalu sampaikan dalam satu kalimat untuk menyambung ke API Eduqat. Agen membaca dokumentasinya sendiri dan langsung bekerja. Setelah itu kamu cukup meminta apa yang kamu inginkan dengan bahasa biasa.

API Eduqat membuka sekolah kamu untuk apa pun yang dapat mengirim HTTP request. Memasangkannya dengan AI agent berarti kamu tidak pernah menulis request itu sendiri.

Setelah tersambung, kamu dapat bertanya seperti ada berapa self-paced course yang saya miliki, dan mana saja yang masih draft, atau meminta buatkan self-paced course bernama Intro to Design Thinking dengan tiga sesi. Agen menentukan panggilan yang diperlukan, menunjukkannya kepada kamu, lalu menjalankannya setelah kamu setujui.

Pemakaian yang umum adalah membangun course, sesi, dan materi, mendaftarkan learner serta memeriksa sertifikat, dan menarik daftar dari sekolah kamu untuk sebuah laporan.

Ini berbeda dengan AI School Assistant. Asisten tersebut berada di dalam Eduqat Dashboard dan tidak memerlukan persiapan apa pun. API digunakan untuk pekerjaan di luar dashboard, dan untuk apa pun yang ingin kamu jadikan skrip, ekspor, atau kamu ulang.

Hanya itu daftarnya. Kamu tidak perlu bisa coding, dan tidak perlu menyentuh terminal untuk memulai.

Hubungi account manager Eduqat kamu dan minta API key untuk sekolah kamu. Key diterbitkan per sekolah, dan tidak ada cara membuatnya sendiri dari dashboard.

Dua hal yang perlu diketahui sebelum key tersebut datang:

Key itu sendiri sudah mengidentifikasi sekolah kamu. Kamu tidak pernah mengirimkan id sekolah, id pengguna, atau peran bersamanya. Semuanya diselesaikan server berdasarkan key tersebut.

Key ini bersifat satu tingkat. Tidak ada key khusus baca saja dan tidak ada key khusus tulis, sehingga satu key memberi akses ke seluruh operasi yang disediakan API. Perlakukan seperti kata sandi.

Buka agen kamu lalu serahkan keynya. Kamu dapat melampirkan key tersebut sebagai berkas atau menempelkannya ke dalam pesan, tergantung dukungan agen kamu.

Lalu kirim ini.

Hanya itu persiapannya. Agen membaca panduan Eduqat untuk AI agent, menemukan spesifikasi terbaca mesin yang ditautkan dari sana, melakukan satu panggilan percobaan untuk memastikan keynya berfungsi, lalu memberitahukan apa yang ditemukannya.

Mengarahkan agen ke https://developers.eduqat.com/docs juga berhasil. Agen akan menemukan jalannya ke panduan yang sama dari sana.

Begitu agen melaporkan koneksinya berhasil, berhentilah memikirkan endpoint dan jelaskan saja pekerjaannya.

Membaca maupun menulis data berjalan dengan cara yang sama. Agen menentukan panggilan yang diperlukan, meminta izin sebelum setiap panggilan, lalu memberitahukan apa yang dikerjakannya.

Dari sana kamu dapat melanjutkan di percakapan yang sama. Meminta agen mengubah jawabannya menjadi spreadsheet, atau merapikan duplikat yang ditemukannya, adalah permintaan lanjutan yang wajar.

Langkah inilah yang paling sering dilewati, dan dari sinilah jawaban yang keliru berasal.

Perhatikan tool call milik agen. Sebelum ada panggilan API, kamu semestinya melihat agen mengambil panduannya, kurang lebih seperti ini.

Jika tidak ada pengambilan sama sekali dan agen langsung menyusun request, berarti agen menebak dari data latihnya, bukan membaca spesifikasi yang berlaku sekarang. Hentikan dan sampaikan hal itu.

Semua yang di atas sudah cukup untuk pekerjaan sekali jalan. Dua langkah tambahan berikut membuat pekerjaan berulang lebih aman dan lebih cepat. Keduanya tidak wajib.

Jauhkan key dari riwayat percakapan. Menempelkan key ke dalam pesan berarti key tersebut tersimpan di riwayat percakapan itu. Menyimpannya sebagai environment variable membuat agen dapat memakainya tanpa nilainya pernah muncul di percakapan.

Di macOS, tambahkan baris ini ke ~/.zshrc. Di Linux, tambahkan ke ~/.bashrc.

Lalu muat ulang shellnya dan pastikan nilainya sudah terisi.

Di Windows, atur sekali melalui Command Prompt atau PowerShell, lalu buka terminal baru agar perubahannya berlaku.

Setelah itu minta agen menggunakan $EDUQAT_API_KEY, bukan memberikan keynya secara langsung.

Buat setiap sesi baru langsung siap. Buat satu folder khusus pekerjaan Eduqat dan letakkan berkas instruksi proyek di dalamnya. Setiap sesi berikutnya yang kamu buka di folder itu sudah siap sebelum kamu mengetik apa pun.

Di Claude Code berkasnya bernama CLAUDE.md. Minta agen kamu membuatnya dengan isi berikut.

Codex, Cursor, dan agen lain masing-masing memiliki berkas konteks atau instruksinya sendiri, jadi periksa dokumentasi agen kamu untuk mengetahui letaknya. Isinya selalu tiga hal yang sama: URL https://developers.eduqat.com/AGENTS.md, nama variabel EDUQAT_API_KEY, dan nama header x-api-key.

Memeriksa sendiri sebuah key. Jika kamu ingin memastikan sebuah key sebelum menyerahkannya ke apa pun, jalankan perintah ini di terminal lalu ganti YOUR_API_KEY.

JSON yang memuat array items berarti keynya berfungsi. 401 berarti keynya salah, dan 403 berarti keynya benar tetapi tidak memiliki izin untuk rute tersebut.

Key ini memberi akses ke seluruh operasi pada sekolah kamu, jadi aturan umumnya berlaku tanpa pengecualian.

Jangan pernah memasukkannya ke git. Jika agen kamu menuliskan key tersebut ke berkas .env, pastikan berkas itu tidak ikut tersimpan ke git.

Jangan pernah menempelkannya ke percakapan bersama, tiket, atau dokumen yang dapat dibaca orang lain. Sesi pribadi dengan agen kamu sendiri tidak masalah, tetapi apa pun yang dapat dibuka orang lain tidak.

Jika kamu menduga keynya bocor, segera beri tahu account manager kamu dan minta key yang baru.

Untuk apa pun yang menyangkut keynya, termasuk 403 yang tidak kunjung hilang, hubungi account manager kamu. Untuk path terdokumentasi yang membalas 404, atau apa pun yang terlihat seperti bug, hubungi kami melalui tombol live chat di pojok kanan bawah layar dan kami akan menelusurinya bersama kamu. Dokumentasi lengkap untuk developer ada di https://developers.eduqat.com/docs.