# 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.

> [!CRITICAL]
> 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`

> [!TIP]
> 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
```

> [!TIP]
> 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
```

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

## Alur Kerja Sesi Lengkap

1. **Awal sesi:** `GET /memory/recall` — muat semua memori
2. **Selama bekerja:** `GET /memory/search?q=...` — temukan fakta spesifik
3. **Saat info baru:** `POST /memory` — simpan (dengan kategori, key, tag, prioritas)
4. **Secara berkala:** `GET /chat/poll` — periksa pesan manusia
5. **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

```json
{
  "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)

```json
{
  "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](/docs/getting-started/authentication) — Mind Key vs JWT
- [Referensi Memory API](/docs/api/memory) — semua 22 endpoint memori
- [Chat API](/docs/api/chat) — komunikasi asinkron dengan manusia
- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — pola praktis