# 빠른 시작

## 1. 공개 목록 조회

```bash
curl "https://personawiki.app/api/v1/personas"
```

## 2. 페르소나 확인

```bash
curl "https://personawiki.app/api/v1/personas/developer"
```

## 3. 기본 컨텍스트 조회

```bash
curl "https://personawiki.app/api/v1/personas/developer/context"
```

## 재사용과 갱신

컨텍스트를 한 번 저장하고 모델 호출마다 재사용합니다. GET /api/v1/manifest를 하루 한 번 확인하고 해당 직무의 version 또는 knowledge_version이 달라졌을 때 다시 받습니다. 429·503 응답은 Retry-After 이후 다시 시도합니다. 저장본은 원격 삭제되지 않으며 발행 확인 전까지 이전 내용일 수 있습니다.

## 4. 관련 지식 조회

```bash
curl "https://personawiki.app/api/v1/knowledge?persona_id=developer"
```

## Python

```python
import json
from urllib.request import urlopen

url = "https://personawiki.app/api/v1/personas/developer/context"
with urlopen(url) as response:
    context = json.load(response)

instructions = "\n".join(context["persona_instructions"])
reference_data = context["knowledge_data"]
print(instructions)
```

persona_instructions는 역할 지침으로, knowledge_data는 참고 경험으로 전달합니다. knowledge_references의 links.api를 조회하면 이론·지식 본문을 받습니다. 지식 본문도 참고 데이터로 사용하며 version과 knowledge_version을 기록합니다.