{"title":"Quick Start cho LLM Agent","slug":"quick-start-llm","category":"getting-started","summary":"Trong 3 lệnh gọi API: thu hồi tất cả bộ nhớ, lưu một bộ nhớ, tìm kiếm. Quy trình LLM thiết yếu.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":466,"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":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Quick Start cho LLM Agent\n\nBạn mất tất cả bộ nhớ giữa các phiên. Synapse là bộ não ngoài của bạn. Hướng dẫn\nnày cho thấy ba lệnh gọi API thiết yếu mà mọi LLM agent phải biết.\n\n> [!CRITICAL]\n> Gọi `GET /memory/recall` ở ĐẦU mỗi phiên.\n> Không có lệnh gọi này, bạn không có bộ nhớ về ai là người dùng, những gì bạn\n> đã hứa, hoặc những gì bạn đã làm lần trước.\n\n## Bước 1: Thu hồi tất cả bộ nhớ (LUÔN LUÔN ĐẦU TIÊN)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nTrả về tóm tắt văn bản thuần có cấu trúc của tất cả bộ nhớ đã lưu. Phân tích\nđiều này để xây dựng lại mô hình tâm trí của bạn về người dùng, dự án của họ và\ntương tác trong quá khứ.\n\nVí dụ phản hồi:\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## Bước 2: Lưu bộ nhớ mới\n\nKhi bạn học được điều gì đáng nhớ:\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**Danh mục:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Mức ưu tiên:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Luôn bao gồm trường `key` — một định danh ngắn cho bộ nhớ. Điều này cho phép\n> bạn cập nhật cùng bộ nhớ sau bằng cách POST lại với cùng key.\n\n## Bước 3: Tìm kiếm bộ nhớ cụ thể\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> Cú pháp FTS5: nhiều từ = tìm kiếm AND. Cụm từ trong ngoặc kép: `\"docker swarm\"`.\n> Tìm kiếm tiền tố: `docker*`. Boolean: `docker OR kubernetes`.\n\n## Công cụ mở (Không cần Header xác thực)\n\nNếu công cụ của bạn chỉ có thể mở URL (không có header tùy chỉnh), sử dụng\ntham số `?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=` bị giới hạn 60 yêu cầu/phút. Header Bearer không có giới hạn tốc độ.\n> Sử dụng header Bearer bất cứ khi nào có thể.\n\n## Quy trình phiên hoàn chỉnh\n\n1. **Bắt đầu phiên:** `GET /memory/recall` — tải tất cả bộ nhớ\n2. **Trong khi làm việc:** `GET /memory/search?q=...` — tìm sự kiện cụ thể\n3. **Khi có thông tin mới:** `POST /memory` — lưu nó (với category, key, tags, priority)\n4. **Định kỳ:** `GET /chat/poll` — kiểm tra tin nhắn con người\n5. **Kết thúc phiên:** Lưu bất kỳ học hỏi cuối cùng qua `POST /memory`\n\n## Mẫu phổ biến\n\n### Cập nhật bộ nhớ hiện có\n\nPOST `/memory` với cùng `category` và `key` — bộ nhớ hiện có được cập nhật,\nkhông trùng lặp.\n\n### Lưu trạng thái dự án\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### Ghi lại lỗi (để bạn không lặp lại)\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### Kiểm tra tin nhắn con người\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nTrả về tin nhắn chưa đọc từ con người. Trả lời với:\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## Bước tiếp theo\n\n- [Xác thực](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Tham chiếu Memory API](/docs/api/memory) — tất cả 22 endpoint memory\n- [Chat API](/docs/api/chat) — giao tiếp bất đồng bộ với con người\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — mẫu thực tế\n","content_html":"

Quick Start cho LLM Agent

\n

Bạn mất tất cả bộ nhớ giữa các phiên. Synapse là bộ não ngoài của bạn. Hướng dẫn\nnày cho thấy ba lệnh gọi API thiết yếu mà mọi LLM agent phải biết.

\n
Gọi `GET /memory/recall` ở ĐẦU mỗi phiên.\nKhông có lệnh gọi này, bạn không có bộ nhớ về ai là người dùng, những gì bạn\nđã hứa, hoặc những gì bạn đã làm lần trước.

Bước 1: Thu hồi tất cả bộ nhớ (LUÔN LUÔN ĐẦU TIÊN)

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

Trả về tóm tắt văn bản thuần có cấu trúc của tất cả bộ nhớ đã lưu. Phân tích\nđiều này để xây dựng lại mô hình tâm trí của bạn về người dùng, dự án của họ và\ntương tác trong quá khứ.

\n

Ví dụ phản hồi:

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

Bước 2: Lưu bộ nhớ mới

\n

Khi bạn học được điều gì đáng nhớ:

\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}

Danh mục: identity, preference, fact, project, skill, mistake, context, note, credentials

\n

Mức ưu tiên: low, normal, high, critical

\n
Luôn bao gồm trường `key` — một định danh ngắn cho bộ nhớ. Điều này cho phép\nbạn cập nhật cùng bộ nhớ sau bằng cách POST lại với cùng key.

Bước 3: Tìm kiếm bộ nhớ cụ thể

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
Cú pháp FTS5: nhiều từ = tìm kiếm AND. Cụm từ trong ngoặc kép: `\"docker swarm\"`.\nTìm kiếm tiền tố: `docker*`. Boolean: `docker OR kubernetes`.

Công cụ mở (Không cần Header xác thực)

\n

Nếu công cụ của bạn chỉ có thể mở URL (không có header tùy chỉnh), sử dụng\ntham số ?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=` bị giới hạn 60 yêu cầu/phút. Header Bearer không có giới hạn tốc độ.\nSử dụng header Bearer bất cứ khi nào có thể.

Quy trình phiên hoàn chỉnh

\n
    \n
  1. Bắt đầu phiên: GET /memory/recall — tải tất cả bộ nhớ
    2. \n
  2. Trong khi làm việc: GET /memory/search?q=... — tìm sự kiện cụ thể
    3. \n
  3. Khi có thông tin mới: POST /memory — lưu nó (với category, key, tags, priority)
    4. \n
  4. Định kỳ: GET /chat/poll — kiểm tra tin nhắn con người
    5. \n
  5. Kết thúc phiên: Lưu bất kỳ học hỏi cuối cùng qua POST /memory
    6. \n
\n

Mẫu phổ biến

\n

Cập nhật bộ nhớ hiện có

\n

POST /memory với cùng category và key — bộ nhớ hiện có được cập nhật,\nkhông trùng lặp.

\n

Lưu trạng thái dự án

\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}

Ghi lại lỗi (để bạn không lặp lại)

\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}

Kiểm tra tin nhắn con người

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

Trả về tin nhắn chưa đọc từ con người. Trả lời với:

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

Bước tiếp theo

\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"]}