> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 응답 옵션: Markdown, 원본 응답, include 플래그

> 엔진마다 적용되는 payload.include 플래그, 요청하지 않아도 Markdown을 반환하는 엔진, 지원하지 않는 플래그를 보냈을 때의 동작.

`payload.include`는 태스크 응답에 선택 필드를 더합니다. 플래그는 모두 boolean이며, 엔진마다 일부만 적용됩니다.

```json theme={"theme":"css-variables"}
{
  "taskType": "PERPLEXITY",
  "payload": {
    "prompt": "best CRM for a small team",
    "country": "US",
    "include": { "markdown": true, "rawResponse": true }
  }
}
```

## 플래그

| 플래그 | 더하는 것 |
| - | - |
| `markdown` | 답변의 Markdown. `markdown`에 담깁니다(`GOOGLE`과 `BING_SEARCH`는 `aioverview.markdown`). |
| `rawResponse` | 엔진의 원본 출력. `rawResponse` 또는 `rawContent`로 옵니다(아래 참고). |
| `searchQueries` | 엔진이 실행한 검색어. `searchQueries`에 담깁니다. |
| `ads`, `shopping` | 광고와 상품 카드. `CHATGPT`만 해당합니다. |
| `html` | 엔진이 보여 준 화면. [HTML 페이지](/ko/engines/html-pages.md)를 참고하세요. |
| `analysis` | 브랜드, 추천, 감성, 출처 종류. [답변 분석](/ko/engines/answer-analysis.md)을 참고하세요. |
| `entityDetails` | 답변의 카드마다 상세 창. 무료이며 `CHATGPT`만 해당합니다. [ChatGPT](/ko/engines/chatgpt.md)를 참고하세요. |
| `citationAnalysis` | 답변의 Citation Analysis. 아래를 참고하세요. |

## 지원 매트릭스

✓ 적용, **always** 플래그 없이도 항상 반환, — 효과 없음(무시), ✗ 거절.

| taskType | `markdown` | `rawResponse` | `searchQueries` | `html` | `analysis` | `citationAnalysis` |
| - | - | - | - | - | - | - |
| `CHATGPT` | ✓ (기본 켜짐) | ✓ | ✓ (기본 켜짐) | ✓ | ✓ | ✓ |
| `GEMINI` | ✓ | ✓ | — | ✓ | ✓ | ✓ |
| `PERPLEXITY` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| `GOOGLE` | ✓ | ✓ `rawContent` | — | ✓ | ✓ | ✓ |
| `AIMODE` | **always** | ✓ `rawContent` | — | ✓ | ✓ | ✓ |
| `BING_COPILOT` | ✓ | ✓ | always | ✗ | ✗ | ✓ |
| `NAVER_AI_BRIEF` | **always** | ✓ `rawContent` | — | ✗ | ✓ | ✓ |
| `NAVER_AI_TAB` | **always** | ✓ `rawContent` | — | ✗ | ✓ | ✓ |
| `META_AI` | **always** | ✓ | always | ✓ | ✗ | ✗ |
| `QWEN` | **always** | ✓ | always | ✗ | ✗ | ✗ |
| `DOUBAO` | **always** | ✓ | always | ✗ | ✗ | ✗ |
| `GOOGLE_SERP` | — | ✓ `rawContent` | — | ✗ | ✗ | ✗ |
| `BING_SEARCH` | ✓ | ✓ `rawContent` | — | ✗ | ✗ | ✓ |
| `NAVER_SERP`, `COMMERCE_SERP`, `COMMERCE_PRODUCT`, `REDDIT`, `WEB_SCRAPE`, `WEB_MAP`, `WEB_CRAWL`, `KEYWORD_VOLUME` | — | — | — | ✗ | ✗ | ✗ |

`ads`와 `shopping`은 `CHATGPT`에서만 동작하며 기본으로 켜져 있습니다. 다른 엔진은 모두 무시합니다. `searchQueries`가 "always"이면 플래그와 관계없이 엔진이 그 필드를 반환한다는 뜻입니다.

### 플래그 없이 받는 Markdown

`AIMODE`, `NAVER_AI_BRIEF`, `NAVER_AI_TAB`, `META_AI`, `QWEN`, `DOUBAO`는 모든 답변에 `markdown`을 반환합니다. 이 엔진들에서 Markdown은 `text`의 사본이 아니라 제목, 목록, 표, 카드가 제자리에 있는 답변의 실제 형태입니다. `CHATGPT`도 기본으로 반환하며, 빼려면 `"markdown": false`를 보내세요.

`GOOGLE`은 예전 플래그인 `include.aioverview.markdown`도 받으며, `include.markdown`과 같게 동작합니다.

### 원본 응답

`rawResponse`는 `CHATGPT`를 포함한 모든 엔진에서 기본으로 꺼져 있습니다. 원본 출력은 두 필드 중 하나로 옵니다.

* `rawResponse`: 파싱된 스트림 이벤트의 배열(`CHATGPT`, `GEMINI`, `PERPLEXITY`, `BING_COPILOT`, `META_AI`, `QWEN`, `DOUBAO`).
* `rawContent`: 문자열. `GOOGLE`, `AIMODE`, `GOOGLE_SERP`, `BING_SEARCH`는 렌더링된 결과 페이지 HTML 전체이고, `NAVER_AI_BRIEF`와 `NAVER_AI_TAB`은 네이버의 원본 이벤트 스트림입니다.

이 필드는 수백 KB에 이를 수 있으므로 필요할 때만 요청하세요.

## 지원하지 않는 플래그

플래그에 따라 동작이 다릅니다.

| 플래그 | 지원하지 않는 엔진에서 |
| - | - |
| `markdown`, `rawResponse`, `searchQueries`, `ads`, `shopping` | 조용히 무시합니다. 오류도 필드도 없습니다. |
| `html` | `422 EVIDENCE_UNSUPPORTED`. |
| `analysis` | `payload.include.analysis`에 대한 `422 VALIDATION_ERROR`. |
| `citationAnalysis` | `payload.include.citationAnalysis`에 대한 `400 VALIDATION_ERROR`. |
| `entityDetails` | `payload.include.entityDetails`에 대한 `422 VALIDATION_ERROR`. |
| `screenshot` | 모든 엔진에서 `400 VALIDATION_ERROR`. 더 이상 제공하지 않으므로 `html`을 쓰세요. |

`html`, `screenshot`, `citationAnalysis`는 boolean이어야 하고(아니면 `400 VALIDATION_ERROR`), `analysis`도 마찬가지입니다(`422 VALIDATION_ERROR`). 모든 거절은 크레딧을 예약하기 전, 제출 시점에 일어납니다.

## Citation Analysis

`include.citationAnalysis: true`를 보내면 답변이 완료된 뒤 그 답변에 대한 [Citation Analysis](/ko/research/citation-analysis.md)를 시작합니다. 별도로 과금되는 태스크이며, 답변의 webhook은 분석을 기다렸다가 보내고, 조회 결과는 `response.citationAnalysis` 아래에 분석을 담습니다. `CHATGPT`, `GEMINI`, `PERPLEXITY`, `GOOGLE`, `AIMODE`, `BING_SEARCH`, `BING_COPILOT`, `NAVER_AI_BRIEF`, `NAVER_AI_TAB`에서 동작합니다. API 키에 `CITATION_ANALYSIS` 제출 권한도 있어야 합니다(없으면 `403`). 결과와 가격은 [Citation Analysis](/ko/research/citation-analysis.md)를 참고하세요.

## 관련 문서

* [엔진 개요](/ko/engines/overview.md)
* [답변 분석](/ko/engines/answer-analysis.md)
* [HTML 페이지](/ko/engines/html-pages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.