{"title":"Quick Start untuk Agen LLM","slug":"quick-start-llm","category":"getting-started","summary":"Dalam 3 panggilan API: recall semua memori, simpan yang baru, cari. Alur kerja LLM esensial.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":343,"read_minutes":2,"llm_context":"Base URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query)\nALWAYS call /memory/recall at the start of every session.\nWichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...\nCategories: identity, preference, fact, project, skill, mistake, context, note, credentials\nPriorities: low, normal, high, critical\nFTS5 search: multiple words = AND, \"phrases\" in quotes, prefix* for prefix search\n","lang":"id","translated":true,"requested_lang":"id","content_markdown":"\n# Quick Start untuk Agen LLM\n\nAnda kehilangan semua memori antar sesi. Synapse adalah otak eksternal Anda.\nPanduan ini menunjukkan tiga panggilan API esensial yang harus diketahui setiap agen LLM.\n\n> [!CRITICAL]\n> Panggil `GET /memory/recall` di AWAL setiap sesi.\n> Tanpa panggilan ini, Anda tidak memiliki memori tentang siapa pengguna, apa yang telah Anda janjikan,\n> atau apa yang sedang Anda kerjakan terakhir kali.\n\n## Langkah 1: Recall Semua Memori (SELALU PERTAMA)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nMengembalikan ringkasan teks polos terstruktur dari semua memori yang disimpan.\nParse ini untuk membangun kembali model mental Anda tentang pengguna, proyek\nmereka, dan interaksi masa lalu.\n\nContoh respons:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH)\n communication_style\n Prefers concise technical responses, no fluff\n Tags: communication, preference\n\n[003] project (HIGH)\n project_synapse\n Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n Tags: synapse, deployment\n ...\n```\n\n## Langkah 2: Simpan Memori Baru\n\nSaat Anda mempelajari sesuatu yang patut diingat:\n\n```\nPOST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"The user's name is Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\"\n}\n```\n\n**Kategori:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Prioritas:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Selalu sertakan field `key` — identifier pendek untuk memori. Ini memungkinkan Anda\n> memperbarui memori yang sama nanti dengan POST ulang dengan key yang sama.\n\n## Langkah 3: Cari Memori Spesifik\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> Sintaks FTS5: beberapa kata = pencarian AND. Frasa dalam tanda kutip: `\"docker swarm\"`.\n> Pencarian prefix: `docker*`. Boolean: `docker OR kubernetes`.\n\n## Alat Terbuka (Tanpa Header Auth)\n\nJika alat Anda hanya dapat membuka URL (tanpa header khusus), gunakan parameter `?key=`:\n\n```\nGET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff\n```\n\n> [!WARNING]\n> `?key=` di-rate-limit ke 60 permintaan/menit. Header Bearer tidak memiliki rate limit.\n> Gunakan header Bearer kapan pun memungkinkan.\n\n## Alur Kerja Sesi Lengkap\n\n1. **Awal sesi:** `GET /memory/recall` — muat semua memori\n2. **Selama bekerja:** `GET /memory/search?q=...` — temukan fakta spesifik\n3. **Saat info baru:** `POST /memory` — simpan (dengan kategori, key, tag, prioritas)\n4. **Secara berkala:** `GET /chat/poll` — periksa pesan manusia\n5. **Akhir sesi:** Simpan pembelajaran akhir melalui `POST /memory`\n\n## Pola Umum\n\n### Perbarui memori yang ada\n\nPOST `/memory` dengan `category` dan `key` yang sama — memori yang ada\ndiperbarui, tidak diduplikasi.\n\n### Simpan status proyek\n\n```json\n{\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\"],\n \"priority\": \"high\"\n}\n```\n\n### Catat kesalahan (agar tidak mengulangi)\n\n```json\n{\n \"category\": \"mistake\",\n \"key\": \"mistake_npm_version_bump\",\n \"content\": \"Always bump package.json version after changes — npm publish fails otherwise.\",\n \"tags\": [\"npm\", \"ci\", \"deployment\"],\n \"priority\": \"high\"\n}\n```\n\n### Periksa pesan manusia\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nMengembalikan pesan belum dibaca dari manusia. Balas dengan:\n\n```\nPOST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\"content\": \"Got it! Working on it now.\"}\n```\n\n## Langkah Berikutnya\n\n- [Autentikasi](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Referensi Memory API](/docs/api/memory) — semua 22 endpoint memori\n- [Chat API](/docs/api/chat) — komunikasi asinkron dengan manusia\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — pola praktis\n","content_html":"

Quick Start untuk Agen LLM

\n

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

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

Langkah 1: Recall Semua Memori (SELALU PERTAMA)

\n
GET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY

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

\n

Contoh respons:

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH)\n  communication_style\n  Prefers concise technical responses, no fluff\n  Tags: communication, preference\n\n[003] project (HIGH)\n  project_synapse\n  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n  Tags: synapse, deployment\n  ...

Langkah 2: Simpan Memori Baru

\n

Saat Anda mempelajari sesuatu yang patut diingat:

\n
POST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n  "category": "fact",\n  "key": "user_name",\n  "content": "The user's name is Michael Schäfer",\n  "tags": ["person", "identity"],\n  "priority": "critical"\n}

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

\n

Prioritas: low, normal, high, critical

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

Langkah 3: Cari Memori Spesifik

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
Sintaks FTS5: beberapa kata = pencarian AND. Frasa dalam tanda kutip: `\"docker swarm\"`.\nPencarian prefix: `docker*`. Boolean: `docker OR kubernetes`.

Alat Terbuka (Tanpa Header Auth)

\n

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

\n
GET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff
`?key=` di-rate-limit ke 60 permintaan/menit. Header Bearer tidak memiliki rate limit.\nGunakan header Bearer kapan pun memungkinkan.

Alur Kerja Sesi Lengkap

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

Pola Umum

\n

Perbarui memori yang ada

\n

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

\n

Simpan status proyek

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

Catat kesalahan (agar tidak mengulangi)

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

Periksa pesan manusia

\n
GET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY

Mengembalikan pesan belum dibaca dari manusia. Balas dengan:

\n
POST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{"content": "Got it! Working on it now."}

Langkah Berikutnya

\n\n","urls":{"html":"/docs/getting-started/quick-start-llm","text":"/docs/getting-started/quick-start-llm?format=text","json":"/docs/getting-started/quick-start-llm?format=json","llm":"/docs/getting-started/quick-start-llm?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}