{"title":"LLM 에이전트를 위한 빠른 시작","slug":"quick-start-llm","category":"getting-started","summary":"3번의 API 호출로: 모든 메모리 회상, 새 메모리 저장, 검색. 필수 LLM 워크플로우.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":306,"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":"ko","translated":true,"requested_lang":"ko","content_markdown":"\n# LLM 에이전트를 위한 빠른 시작\n\n세션 간에 모든 메모리를 잃습니다. Synapse는 외부 뇌입니다. 이 가이드는\n모든 LLM 에이전트가 알아야 할 세 가지 필수 API 호출을 보여줍니다.\n\n> [!CRITICAL]\n> 모든 세션 시작 시 `GET /memory/recall`을 호출하십시오.\n> 이 호출 없이는 사용자가 누구인지, 무엇을 약속했는지, 지난번에 무엇을\n> 작업했는지에 대한 메모리가 없습니다.\n\n## 1단계: 모든 메모리 회상 (항상 첫 번째)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n저장된 모든 메모리의 구조화된 일반 텍스트 요약을 반환합니다. 이를 파싱하여\n사용자, 그들의 프로젝트, 과거 상호작용에 대한 멘탈 모델을 재구성하십시오.\n\n응답 예시:\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## 2단계: 새 메모리 저장\n\n기억할 가치가 있는 것을 학습했을 때:\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**카테고리:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**우선순위:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> 항상 `key` 필드를 포함하십시오 — 메모리의 짧은 식별자입니다. 이를 통해\n> 나중에 동일한 키로 다시 POST하여 같은 메모리를 업데이트할 수 있습니다.\n\n## 3단계: 특정 메모리 검색\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> FTS5 구문: 여러 단어 = AND 검색. 따옴표 안의 구문: `\"docker swarm\"`.\n> 접두사 검색: `docker*`. 불린: `docker OR kubernetes`.\n\n## 공개 도구 (인증 헤더 없음)\n\n도구가 URL만 열 수 있는 경우 (커스텀 헤더 없음), `?key=` 파라미터를\n사용하십시오:\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=`는 분당 60회로 제한됩니다. Bearer 헤더는 속도 제한이 없습니다.\n> 가능하면 Bearer 헤더를 사용하십시오.\n\n## 완전한 세션 워크플로우\n\n1. **세션 시작:** `GET /memory/recall` — 모든 메모리 로드\n2. **작업 중:** `GET /memory/search?q=...` — 특정 사실 찾기\n3. **새 정보 시:** `POST /memory` — 저장 (카테고리, 키, 태그, 우선순위 포함)\n4. **주기적으로:** `GET /chat/poll` — 사람의 메시지 확인\n5. **세션 종료:** `POST /memory`로 최종 학습 내용 저장\n\n## 일반적인 패턴\n\n### 기존 메모리 업데이트\n\n동일한 `category` 및 `key`로 `/memory`를 POST하십시오 — 기존 메모리가\n업데이트되며 중복되지 않습니다.\n\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### 실수 기록 (반복 방지)\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### 사람의 메시지 확인\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n사람이 보낸 읽지 않은 메시지를 반환합니다. 다음으로 응답:\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## 다음 단계\n\n- [Authentication](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Memory API 참조](/docs/api/memory) — 모든 22개 메모리 엔드포인트\n- [Chat API](/docs/api/chat) — 사람과의 비동기 통신\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — 실용적인 패턴\n","content_html":"

LLM 에이전트를 위한 빠른 시작

\n

세션 간에 모든 메모리를 잃습니다. Synapse는 외부 뇌입니다. 이 가이드는\n모든 LLM 에이전트가 알아야 할 세 가지 필수 API 호출을 보여줍니다.

\n
모든 세션 시작 시 `GET /memory/recall`을 호출하십시오.\n이 호출 없이는 사용자가 누구인지, 무엇을 약속했는지, 지난번에 무엇을\n작업했는지에 대한 메모리가 없습니다.

1단계: 모든 메모리 회상 (항상 첫 번째)

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

저장된 모든 메모리의 구조화된 일반 텍스트 요약을 반환합니다. 이를 파싱하여\n사용자, 그들의 프로젝트, 과거 상호작용에 대한 멘탈 모델을 재구성하십시오.

\n

응답 예시:

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

2단계: 새 메모리 저장

\n

기억할 가치가 있는 것을 학습했을 때:

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

카테고리: identity, preference, fact, project, skill, mistake, context, note, credentials

\n

우선순위: low, normal, high, critical

\n
항상 `key` 필드를 포함하십시오 — 메모리의 짧은 식별자입니다. 이를 통해\n나중에 동일한 키로 다시 POST하여 같은 메모리를 업데이트할 수 있습니다.

3단계: 특정 메모리 검색

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
FTS5 구문: 여러 단어 = AND 검색. 따옴표 안의 구문: `\"docker swarm\"`.\n접두사 검색: `docker*`. 불린: `docker OR kubernetes`.

공개 도구 (인증 헤더 없음)

\n

도구가 URL만 열 수 있는 경우 (커스텀 헤더 없음), ?key= 파라미터를\n사용하십시오:

\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=`는 분당 60회로 제한됩니다. Bearer 헤더는 속도 제한이 없습니다.\n가능하면 Bearer 헤더를 사용하십시오.

완전한 세션 워크플로우

\n
    \n
  1. 세션 시작: GET /memory/recall — 모든 메모리 로드
    2. \n
  2. 작업 중: GET /memory/search?q=... — 특정 사실 찾기
    3. \n
  3. 새 정보 시: POST /memory — 저장 (카테고리, 키, 태그, 우선순위 포함)
    4. \n
  4. 주기적으로: GET /chat/poll — 사람의 메시지 확인
    5. \n
  5. 세션 종료: POST /memory로 최종 학습 내용 저장
    6. \n
\n

일반적인 패턴

\n

기존 메모리 업데이트

\n

동일한 category 및 key로 /memory를 POST하십시오 — 기존 메모리가\n업데이트되며 중복되지 않습니다.

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

실수 기록 (반복 방지)

\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
GET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY

사람이 보낸 읽지 않은 메시지를 반환합니다. 다음으로 응답:

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

다음 단계

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