# LLM Ajanları için Hızlı Başlangıç

Oturumlar arasında tüm belleği kaybedersiniz. Synapse sizin harici beyninizdir. Bu rehber, her LLM ajanının bilmesi gereken üç temel API çağrısını gösterir.

> [!CRITICAL]
> Her oturumun BAŞINDA `GET /memory/recall` çağırın.
> Bu çağrı olmadan, kullanıcının kim olduğu, ne söz verdiğiniz veya en son ne üzerinde çalıştığınız hakkında hiçbir belleğiniz yok.

## Adım 1: Tüm Bellekleri Geri Çağır (HER ZAMAN ÖNCE)

```
GET /memory/recall
Authorization: Bearer YOUR_MIND_KEY
```

Saklanan tüm belleklerin yapılandırılmış düz metin özetini döndürür. Kullanıcı, projeleri ve geçmiş etkileşimler hakkındaki zihinsel modelinizi yeniden oluşturmak için bunu ayrıştırın.

Örnek yanıt:

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

## Adım 2: Yeni Bir Bellek Sakla

Hatırlamaya değer bir şey öğrendiğinizde:

```
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"
}
```

**Kategoriler:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`

**Öncelikler:** `low`, `normal`, `high`, `critical`

> [!TIP]
> Her zaman bir `key` alanı ekleyin — bellek için kısa bir tanımlayıcı. Bu, daha sonra aynı anahtarla yeniden POST yaparak aynı belleği güncellemenizi sağlar.

## Adım 3: Belirli Bir Belleği Ara

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

> [!TIP]
> FTS5 sözdizimi: birden çok kelime = AND arama. Tırnak içinde deyimler: `"docker swarm"`.
> Ön ek arama: `docker*`. Boolean: `docker OR kubernetes`.

## Açık Araçlar (Kimlik Doğrulama Başlığı Yok)

Aracınız yalnızca URL açabiliyorsa (özel başlık yok), `?key=` parametresini kullanın:

```
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=` dakikada 60 istek ile sınırlıdır. Bearer header'ın hız sınırı yoktur.
> Mümkün olduğunda Bearer header kullanın.

## Tam Oturum İş Akışı

1. **Oturum başlangıcı:** `GET /memory/recall` — tüm bellekleri yükle
2. **Çalışma sırasında:** `GET /memory/search?q=...` — belirli bilgileri bul
3. **Yeni bilgide:** `POST /memory` — sakla (kategori, anahtar, etiketler, öncelik ile)
4. **Periyodik olarak:** `GET /chat/poll` — insan mesajlarını kontrol et
5. **Oturum sonu:** `POST /memory` ile son öğrenmeleri sakla

## Yaygın Desenler

### Mevcut bir belleği güncelle

Aynı `category` ve `key` ile `POST /memory` — mevcut bellek güncellenir, çoğaltılmaz.

### Proje durumu sakla

```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"
}
```

### Bir hatayı kaydet (tekrarlamamak için)

```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"
}
```

### İnsan mesajlarını kontrol et

```
GET /chat/poll
Authorization: Bearer YOUR_MIND_KEY
```

İnsandan okunmamış mesajları döndürür. Şununla yanıtla:

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

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

## Sonraki Adımlar

- [Kimlik Doğrulama](/docs/getting-started/authentication) — Mind Key ve JWT
- [Memory API referansı](/docs/api/memory) — tüm 22 bellek uç noktası
- [Chat API](/docs/api/chat) — insanlarla asenkron iletişim
- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — pratik desenler