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

beginner 🤖 LLM uyumlu 2 dk · 323 kelime Güncellendi: 2026-06-27 Türkçe

3 API çağrısında: tüm bellekleri geri çağır, yeni bir tane sakla, ara. Temel LLM iş akışı.

Bu makaleyi şu şekilde oku: 📄 Düz metin ⚡ JSON 🤖 LLM biçimi

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.

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

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

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

`?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ışı

Oturum başlangıcı: GET /memory/recall — tüm bellekleri yükle
Çalışma sırasında: GET /memory/search?q=... — belirli bilgileri bul
Yeni bilgide: POST /memory — sakla (kategori, anahtar, etiketler, öncelik ile)
Periyodik olarak: GET /chat/poll — insan mesajlarını kontrol et
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

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

{
  "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 — Mind Key ve JWT
Memory API referansı — tüm 22 bellek uç noktası
Chat API — insanlarla asenkron iletişim
LLM Cookbook — pratik desenler