# 컨텍스트 조회

## GET /api/v1/personas/{id}/context

인증 없이 현재 공개된 기본 컨텍스트를 반환합니다.

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

| 옵션 | 기본값 | 설명 |
| --- | --- | --- |
| format | json | json 또는 text |
| task | 빈 문자열 | 참고 경험·지식 우선순위를 정할 작업 맥락. 최대 2,000자 |
| token_budget | 4096 | UTF-8 바이트 기준 보수적 한도. 256~8192 |
| include | 없음 | knowledge: 예산 내 지식 본문 함께 반환 |
| version | 현재 | versions 목록의 보관 버전 |
| directions | 기본 설정 | 축 ID:0~100을 쉼표로 연결. 선호 강도이며 실측 분포 아님 |

```bash
curl "https://personawiki.app/api/v1/personas/developer/context?include=knowledge&token_budget=8192&directions=pace:30,change:60"
```

knowledge_documents는 별도의 참고 데이터입니다. persona_instructions에 합치지 않습니다. include=knowledge일 때 지침·경험·지식 본문을 합산해 예산을 검사합니다. 예산 때문에 제외한 지식은 usage.omitted_knowledge_documents에 표시합니다. 참조 링크 등 탐색 메타데이터는 예산 밖입니다.

## 버전 고정

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

현재·보관 버전과 현재 버전에서 달라진 항목을 확인할 수 있습니다. 고정된 판단 구조·지식과 별개로 승인 취소·수정된 경험은 제외합니다. 결과가 변경되면 context_fingerprint로 확인합니다.

## 응답 필드

| 필드 | 내용 |
| --- | --- |
| persona_id | 고정 ID |
| version | 지식 연결도 반영한 공개 컨텍스트 버전 |
| persona_instructions | 관리자 판단 지침 배열 |
| knowledge_data | 승인된 경험의 참고 데이터 배열 |
| knowledge_references | 관련 이론·지식의 ID, 버전과 조회 링크 |
| knowledge_version | 연결된 지식 내용과 매핑의 버전 |
| provenance | 경험 ID, 작성 유형과 버전 |
| usage | 역할 지침·참고 경험의 한도, 바이트 기반 추정치와 경험 수 |

token_budget은 모델별 정확한 토큰 수가 아닙니다. 기본 지침이 한도를 넘으면 422를 반환하며, 참고 데이터는 남은 한도 안에서 포함합니다.

knowledge_references는 별도로 조회하는 탐색 메타데이터이며 token_budget에 포함되지 않습니다. 지식 본문은 필요한 항목만 별도 조회한 뒤 모델 입력 한도에 맞게 선택합니다.

## 텍스트 응답

```bash
curl "https://personawiki.app/api/v1/personas/developer/context?format=text"
```