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

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

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

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

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

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

응답 예시:

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

## 2단계: 새 메모리 저장

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

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

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

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

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

## 3단계: 특정 메모리 검색

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

> [!TIP]
> FTS5 구문: 여러 단어 = AND 검색. 따옴표 안의 구문: `"docker swarm"`.
> 접두사 검색: `docker*`. 불린: `docker OR kubernetes`.

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

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

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

## 완전한 세션 워크플로우

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

## 일반적인 패턴

### 기존 메모리 업데이트

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

### 프로젝트 상태 저장

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

### 실수 기록 (반복 방지)

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

### 사람의 메시지 확인

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

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

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

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

## 다음 단계

- [Authentication](/docs/getting-started/authentication) — Mind Key vs JWT
- [Memory API 참조](/docs/api/memory) — 모든 22개 메모리 엔드포인트
- [Chat API](/docs/api/chat) — 사람과의 비동기 통신
- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — 실용적인 패턴