Quick Start untuk Agen LLM

beginner 🤖 Ramah LLM 2 mnt · 343 kata Diperbarui: 2026-06-27 Bahasa Indonesia

Dalam 3 panggilan API: recall semua memori, simpan yang baru, cari. Alur kerja LLM esensial.

Baca artikel ini sebagai: 📄 Teks biasa ⚡ JSON 🤖 Format LLM

Quick Start untuk Agen LLM

Anda kehilangan semua memori antar sesi. Synapse adalah otak eksternal Anda. Panduan ini menunjukkan tiga panggilan API esensial yang harus diketahui setiap agen LLM.

Panggil `GET /memory/recall` di AWAL setiap sesi. Tanpa panggilan ini, Anda tidak memiliki memori tentang siapa pengguna, apa yang telah Anda janjikan, atau apa yang sedang Anda kerjakan terakhir kali.

Langkah 1: Recall Semua Memori (SELALU PERTAMA)

GET /memory/recall
Authorization: Bearer YOUR_MIND_KEY

Mengembalikan ringkasan teks polos terstruktur dari semua memori yang disimpan. Parse ini untuk membangun kembali model mental Anda tentang pengguna, proyek mereka, dan interaksi masa lalu.

Contoh respons:

Mind: Michael's Mind
Memories: 12 total (10 verified)

[001] identity (CRITICAL)
  user_name
  Michael Schäfer
  Tags: person, identity

[002] preference (HIGH)
  communication_style
  Prefers concise technical responses, no fluff
  Tags: communication, preference

[003] project (HIGH)
  project_synapse
  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.
  Tags: synapse, deployment
  ...

Langkah 2: Simpan Memori Baru

Saat Anda mempelajari sesuatu yang patut diingat:

POST /memory
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json

{
  "category": "fact",
  "key": "user_name",
  "content": "The user's name is Michael Schäfer",
  "tags": ["person", "identity"],
  "priority": "critical"
}

Kategori: identity, preference, fact, project, skill, mistake, context, note, credentials

Prioritas: low, normal, high, critical

Selalu sertakan field `key` — identifier pendek untuk memori. Ini memungkinkan Anda memperbarui memori yang sama nanti dengan POST ulang dengan key yang sama.

Langkah 3: Cari Memori Spesifik

GET /memory/search?q=Docker+Swarm
Authorization: Bearer YOUR_MIND_KEY

Sintaks FTS5: beberapa kata = pencarian AND. Frasa dalam tanda kutip: `"docker swarm"`. Pencarian prefix: `docker*`. Boolean: `docker OR kubernetes`.

Alat Terbuka (Tanpa Header Auth)

Jika alat Anda hanya dapat membuka URL (tanpa header khusus), gunakan parameter ?key=:

GET /memory/recall?key=YOUR_MIND_KEY
POST /memory?key=YOUR_MIND_KEY (+ JSON body)
GET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff

`?key=` di-rate-limit ke 60 permintaan/menit. Header Bearer tidak memiliki rate limit. Gunakan header Bearer kapan pun memungkinkan.

Alur Kerja Sesi Lengkap

Awal sesi: GET /memory/recall — muat semua memori
Selama bekerja: GET /memory/search?q=... — temukan fakta spesifik
Saat info baru: POST /memory — simpan (dengan kategori, key, tag, prioritas)
Secara berkala: GET /chat/poll — periksa pesan manusia
Akhir sesi: Simpan pembelajaran akhir melalui POST /memory

Pola Umum

Perbarui memori yang ada

POST /memory dengan category dan key yang sama — memori yang ada diperbarui, tidak diduplikasi.

Simpan status proyek

{
  "category": "project",
  "key": "project_synapse_status",
  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.",
  "tags": ["synapse", "deployment", "status"],
  "priority": "high"
}

Catat kesalahan (agar tidak mengulangi)

{
  "category": "mistake",
  "key": "mistake_npm_version_bump",
  "content": "Always bump package.json version after changes — npm publish fails otherwise.",
  "tags": ["npm", "ci", "deployment"],
  "priority": "high"
}

Periksa pesan manusia

GET /chat/poll
Authorization: Bearer YOUR_MIND_KEY

Mengembalikan pesan belum dibaca dari manusia. Balas dengan:

POST /chat/reply
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json

{"content": "Got it! Working on it now."}

Langkah Berikutnya

Autentikasi — Mind Key vs JWT
Referensi Memory API — semua 22 endpoint memori
Chat API — komunikasi asinkron dengan manusia
LLM Cookbook — pola praktis