Tool
Perangkat kreatif untuk agen Anda.
Setiap tool mengembalikan struktur JSON yang konsisten dan dijelaskan kepada agen lewat skema yang kaya dan mudah dipahami AI, sehingga agen bisa memilih tool yang tepat tanpa perlu dituntun.
01
Mulai pembuatan presentasi
generate_presentation_startMemulai job pembuatan presentasi baru. Secara default melakukan long-poll secara inline, sehingga satu panggilan tool biasanya langsung mengembalikan presentasi yang sudah jadi. Prosesnya umumnya selesai dalam 5 hingga 7 menit.
- userPrompt
- Prompt yang menjelaskan presentasi yang diinginkan.
- systemInstructions
- Panduan antar-AI dengan tiga field: designStyle, resourcesToUse, context.
- slideCount
- Target jumlah slide. Antara 1 hingga 25, default 10.
- generateImages
- Menentukan apakah model perlu membuat gambar.
- themeId
- ID tema opsional dari list_available_themes.
- images
- Lampiran gambar opsional (maksimal 8). Masing-masing berupa imageUrl publik yang diteruskan sebagai referensi visual.
- waitForCompletionMs
- Batas waktu long-poll dalam milidetik. Disarankan: 220000. Maksimum: 900000.
02
Cek status pembuatan
generate_presentation_statusMengembalikan status job yang sedang berjalan. Sertakan waitForCompletionMs untuk melakukan long-poll hingga job mencapai status akhir dan menerima notifikasi progres MCP melalui progressToken Anda.
- jobId
- UUID job yang dikembalikan oleh generate_presentation_start.
- waitForCompletionMs
- Batas waktu long-poll dalam milidetik.
03
Batalkan pembuatan
generate_presentation_cancelMembatalkan proses pembuatan yang sedang berjalan. Tidak berpengaruh apa pun jika job sudah mencapai status akhir.
- jobId
- UUID job yang akan dibatalkan.
04
Daftar tema pilihan
list_available_themesMengembalikan katalog tema desain pilihan. Setiap tema dilengkapi string prompt designStyle siap pakai yang dapat Anda teruskan apa adanya sebagai systemInstructions.designStyle.
05
Cek billing dan kredit AI
get_billing_statusMengembalikan billing_plan dan sisa ai_credits milik pengguna yang terautentikasi, beserta URL yang bisa dibagikan jika pengguna perlu upgrade atau isi ulang kredit.
06
Health check
health_checkMengembalikan status dasar proses MCP di backend. Berguna untuk memastikan koneksi berjalan.