Skip to content

Bagian 0 — Orientasi

Ada satu kebiasaan buruk yang umum saat belajar framework baru: langsung mengetik npm install, menyalin contoh pertama dari halaman depan, lalu merasa sudah mulai belajar. Yang sebenarnya terjadi, kamu punya satu contoh yang jalan dan nol pemahaman tentang kenapa contoh itu berbentuk begitu. Begitu contoh berikutnya sedikit berbeda, kamu kembali ke titik nol.

Bagian ini menolak kebiasaan itu. Tiga bab di sini tidak akan membuatmu langsung punya agent yang canggih. Tujuannya lebih mendasar: memastikan kamu punya peta sebelum masuk ke detail — tahu potongan-potongan Mastra itu apa saja, mana yang wajib dan mana yang opsional, dan di mana letak sebuah file saat kamu perlu mengubahnya.

Bab di bagian ini

BabIsiKenapa perlu
0.1Apa itu Mastra dan masalah apa yang dia selesaikanSupaya kamu bisa menilai kapan Mastra tepat dipakai dan kapan berlebihan
0.2Peta ekosistem paket dan anatomi folder proyekSupaya kamu tahu paket mana yang perlu dipasang, dan file mana yang perlu diubah
0.3Proyek pertama, model router, .env, dan StudioSupaya kamu punya lingkungan kerja yang benar sebelum Bagian 1

Yang kamu butuhkan

  • Node.js 22.13 atau lebih baru. Cek dengan node -v. Versi di bawah itu tidak didukung.
  • Satu API key model provider. Materi ini memakai OpenAI sebagai default, tapi Anthropic atau Google juga bisa — lihat bab 0.3.
  • Editor dengan dukungan TypeScript. Mastra sangat bergantung pada inferensi tipe; editor yang menampilkan tipe akan sangat membantu, terutama di Bagian 4.
  • Terminal. Sebagian besar interaksi lewat perintah npm.

Yang tidak kamu butuhkan: pengalaman sebelumnya dengan framework AI agent lain, dan pengetahuan mendalam tentang cara kerja LLM. Cukup tahu bahwa model menerima teks dan mengembalikan teks.

Lanjut ke mana

Mulai dari 0.1 Apa Itu Mastra.

Materi belajar mandiri. Bukan dokumentasi resmi Mastra.