Kanesh
GitHub ★ Star

AI & Agent

Prompt untuk agent

Salin prompt ke Codex atau Claude Code untuk membuat client, halaman, atau job sinkronisasi di atas API Kanesh-mu.

Agent kamu bisa menulis kode API untukmu. Prompt ini berfungsi di Codex atau Claude Code dengan langganan yang sudah kamu punya. Ganti bagian yang ditulis dengan huruf kapital, lalu tempel.

Sebelum menempel

  • Beri agent token API pribadi lewat variabel environment, seperti KANESH_ACCESS_TOKEN, jangan di dalam prompt.
  • Arahkan ke servermu dengan KANESH_URL, misalnya http://127.0.0.1:8080.
  • Nyalakan MCP agar agent bisa membaca koleksi dan field-mu sendiri.

Buat client bertipe

Tulis client TypeScript kecil untuk API Kanesh-ku.
Server: KANESH_URL. Token: KANESH_ACCESS_TOKEN, dikirim sebagai Authorization: Bearer.
Workspace ID: YOUR_WORKSPACE_ID.
Baca koleksi dari GET /api/v1/workspaces/:workspace/collections dan buat satu tipe per koleksi.
Tambahkan list (limit, offset, query), get, create, update dengan If-Match, dan delete untuk record.
Respons membungkus hasil di data; error punya error.code dan error.message. Lempar error bertipe untuk masing-masing.

Tampilkan record di halaman

Tambahkan halaman ke aplikasiku yang menampilkan daftar record dari koleksi Kanesh YOUR_COLLECTION.
Ambil data di server dengan token di KANESH_ACCESS_TOKEN, jangan pernah di browser.
Pakai GET /api/v1/workspaces/:workspace/collections/:collection/records dengan limit=20 dan offset untuk paging,
dan meta.pagination.has_more untuk menampilkan tombol "Muat lebih banyak".
Tambahkan kotak pencarian yang mengirim query={"search":"..."}.

Sinkronkan dari sistem lain

Tulis job Go yang menyalin baris dari file CSV-ku ke koleksi Kanesh YOUR_COLLECTION.
Cocokkan record yang sudah ada lewat field YOUR_KEY_FIELD: query dengan filters [{"field":"YOUR_KEY_FIELD","operator":"eq","value":...}].
Update yang cocok dengan PATCH dan buat sisanya dengan POST.
Hormati 429 rate_limited dengan menunggu Retry-After. Catat request_id dari setiap panggilan yang gagal.

Tulis query laporan

Dengan koneksi MCP Kanesh-ku, lihat koleksi YOUR_COLLECTION dan tulis query GraphQL
untuk POST /api/v1/workspaces/:workspace/graphql yang mengembalikan 10 record teratas berdasarkan YOUR_NUMBER_FIELD,
difilter dengan YOUR_CONDITION. Pakai variabel query dengan filters dan sort, lalu jelaskan setiap bagiannya.

Tips

  • Minta agent membaca Ikhtisar API lebih dulu; format respons dan kode error di sana mencegah sebagian besar tebakan.
  • Mulai dengan panggilan baca saja. Biarkan agent menulis hanya setelah kamu memeriksa hasil bacanya.
  • Pakai token dengan akses paling sedikit yang dibutuhkan job, dan cabut saat job selesai.
Traktir kopi