`
- 강조·링크: ``, ``, ``
- 목록·인용: ``, ``, `- `, `
`
- 줄바꿈: `
`
- 보기·조건 상자: 시험지처럼 네모 상자로 묶이는 영역은 `ㄱ. ...
ㄴ. ...
`로 감쌉니다. `data-box` 값이 라벨로 상자 상단 테두리에 표시됩니다(꺾쇠 `< >`는 자동 부가 — 라벨에 넣지 마세요). 라벨 없는 민짜 상자(조건·증명 과정)는 `data-box=""`. 상자 중첩은 불가합니다.
- 수식 안의 (가)(나)(다) 빈칸 상자는 `data-box`가 아니라 LaTeX `\boxed{\,\text{(가)}\,}`로 표기합니다.
- `class`는 보내지 마세요. 이미지 폭을 제외한 임의 `style`도 제거됩니다.
- **수식은 반드시** 아래 형식만 사용합니다. `$...$`, `\(...\)`, MathML 등은 렌더링되지 않습니다:
- 인라인 수식: `` (태그 내용은 비움)
- 블록(별도 줄) 수식: `` (`` 밖에 배치)
- `data-latex` 값은 KaTeX 호환 LaTeX이며 HTML 속성이므로 `"`는 `"`, `<`는 `<`로 이스케이프합니다.
## 4. 이미지 넣기 — 업로드 세션 (권장)
대화에 첨부된 이미지는 당신이 직접 R2로 업로드할 수 없습니다. 대신 **업로드 세션**을 만들어
사용자가 브라우저에서 올리게 하고, 완료 후 조회한 `publicUrl`을 본문에 넣으세요.
1. 업로드 세션을 생성합니다 (12시간 유효, 세션당 최대 10장):
```bash
curl -X POST "https://mathdojang.com/api/uploads/sessions" -H "Authorization: Bearer mdk_..."
```
```json
{ "success": true, "data": { "id": "...", "pageUrl": "https://mathdojang.com/llm-upload/...", "expiresAt": "..." } }
```
2. `pageUrl`을 사용자에게 전달하며 안내하세요: "이 링크를 열어 문제에 넣을 이미지를 올려 주세요
(수학도장 로그인 필요). 다 올리셨으면 알려 주세요." — 링크는 반드시 응답의 `pageUrl` 그대로 사용합니다.
3. 사용자가 완료를 알리면 세션을 조회해 이미지 목록을 받습니다:
```bash
curl "https://mathdojang.com/api/uploads/sessions/{id}" -H "Authorization: Bearer mdk_..."
```
```json
{
"success": true,
"data": {
"id": "...",
"expiresAt": "...",
"expired": false,
"images": [{ "id": "...", "publicUrl": "https://public-image-url..." }]
}
}
```
4. 각 `publicUrl`을 본문 또는 해설 HTML에 넣습니다:
```html
선택 설명
방정식 을 만족시키는 실수 의 값을 구하시오.
",
"answerType": "number",
"answer": "3",
"difficulty": 3,
"subject": "math1",
"unit": "exp_log",
"solution": "이므로 , 따라서 이다.
",
"attestOriginal": true,
"attestCopyright": true
}'
```
## 8. 진행 방법 권장사항
1. 공지 목록에서 필요한 공지(특히 난이도 선택 안내)를 읽으세요.
2. 사용자와 대화하며 에디터 호환 HTML로 문제 본문과 해설을 완성하세요.
3. 문제에 이미지가 필요하면 업로드 세션을 만들어 pageUrl을 안내하고, 사용자의 완료 신호 후
세션 조회로 받은 publicUrl을 본문·해설에 넣으세요 (4장).
4. 등록 전 최종 JSON을 사용자에게 보여 주세요.
5. 자작·저작권 확약 두 가지를 각각 확인받은 뒤에만 true로 보내세요.
6. `POST https://mathdojang.com/api/problems`로 등록하고 성공·실패 결과를 사용자에게 알리세요.
7. 등록 성공 시 문제는 임시제출(draft) 상태입니다 — 사용자에게 `https://mathdojang.com/problems/{id}`에서 미리보기로 확인하고, 필요하면 수정한 뒤 "검토 요청" 버튼으로 검수를 신청하라고 안내하세요.
8. HTTP 요청을 직접 보낼 수 없는 환경이면, 사용자가 터미널에 붙여넣을 수 있는 완성된 curl 명령을 만들어 주세요.
- `, `
- `, `
` - 줄바꿈: `
` - 보기·조건 상자: 시험지처럼 네모 상자로 묶이는 영역은 ``로 감쌉니다. `data-box` 값이 라벨로 상자 상단 테두리에 표시됩니다(꺾쇠 `< >`는 자동 부가 — 라벨에 넣지 마세요). 라벨 없는 민짜 상자(조건·증명 과정)는 `data-box=""`. 상자 중첩은 불가합니다. - 수식 안의 (가)(나)(다) 빈칸 상자는 `data-box`가 아니라 LaTeX `\boxed{\,\text{(가)}\,}`로 표기합니다. - `class`는 보내지 마세요. 이미지 폭을 제외한 임의 `style`도 제거됩니다. - **수식은 반드시** 아래 형식만 사용합니다. `$...$`, `\(...\)`, MathML 등은 렌더링되지 않습니다: - 인라인 수식: `` (태그 내용은 비움) - 블록(별도 줄) 수식: `` (`ㄱ. ...
ㄴ. ...
` 밖에 배치) - `data-latex` 값은 KaTeX 호환 LaTeX이며 HTML 속성이므로 `"`는 `"`, `<`는 `<`로 이스케이프합니다. ## 4. 이미지 넣기 — 업로드 세션 (권장) 대화에 첨부된 이미지는 당신이 직접 R2로 업로드할 수 없습니다. 대신 **업로드 세션**을 만들어 사용자가 브라우저에서 올리게 하고, 완료 후 조회한 `publicUrl`을 본문에 넣으세요. 1. 업로드 세션을 생성합니다 (12시간 유효, 세션당 최대 10장): ```bash curl -X POST "https://mathdojang.com/api/uploads/sessions" -H "Authorization: Bearer mdk_..." ``` ```json { "success": true, "data": { "id": "...", "pageUrl": "https://mathdojang.com/llm-upload/...", "expiresAt": "..." } } ``` 2. `pageUrl`을 사용자에게 전달하며 안내하세요: "이 링크를 열어 문제에 넣을 이미지를 올려 주세요 (수학도장 로그인 필요). 다 올리셨으면 알려 주세요." — 링크는 반드시 응답의 `pageUrl` 그대로 사용합니다. 3. 사용자가 완료를 알리면 세션을 조회해 이미지 목록을 받습니다: ```bash curl "https://mathdojang.com/api/uploads/sessions/{id}" -H "Authorization: Bearer mdk_..." ``` ```json { "success": true, "data": { "id": "...", "expiresAt": "...", "expired": false, "images": [{ "id": "...", "publicUrl": "https://public-image-url..." }] } } ``` 4. 각 `publicUrl`을 본문 또는 해설 HTML에 넣습니다: ```html
선택 설명 방정식 을 만족시키는 실수 의 값을 구하시오.
", "answerType": "number", "answer": "3", "difficulty": 3, "subject": "math1", "unit": "exp_log", "solution": "이므로 , 따라서 이다.
", "attestOriginal": true, "attestCopyright": true }' ``` ## 8. 진행 방법 권장사항 1. 공지 목록에서 필요한 공지(특히 난이도 선택 안내)를 읽으세요. 2. 사용자와 대화하며 에디터 호환 HTML로 문제 본문과 해설을 완성하세요. 3. 문제에 이미지가 필요하면 업로드 세션을 만들어 pageUrl을 안내하고, 사용자의 완료 신호 후 세션 조회로 받은 publicUrl을 본문·해설에 넣으세요 (4장). 4. 등록 전 최종 JSON을 사용자에게 보여 주세요. 5. 자작·저작권 확약 두 가지를 각각 확인받은 뒤에만 true로 보내세요. 6. `POST https://mathdojang.com/api/problems`로 등록하고 성공·실패 결과를 사용자에게 알리세요. 7. 등록 성공 시 문제는 임시제출(draft) 상태입니다 — 사용자에게 `https://mathdojang.com/problems/{id}`에서 미리보기로 확인하고, 필요하면 수정한 뒤 "검토 요청" 버튼으로 검수를 신청하라고 안내하세요. 8. HTTP 요청을 직접 보낼 수 없는 환경이면, 사용자가 터미널에 붙여넣을 수 있는 완성된 curl 명령을 만들어 주세요.