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

# 핵심 개념

> Platform API의 리소스 구조와 관계 — 브랜드·프롬프트 세트·프롬프트·실행·답변

Platform API의 모든 리소스는 API 키가 속한 조직(organization)으로 범위가 한정됩니다.

<img className="block dark:hidden" src="https://mintcdn.com/dev-chainshift/3wlRsXPc3A9kEySj/images/resources-light.svg?fit=max&auto=format&n=3wlRsXPc3A9kEySj&q=85&s=69025b38e68c8a8e0bacdfa90adb2c88" alt="조직 아래 수집 파이프라인(프롬프트 세트·프롬프트·실행·답변)과 독립 리소스(브랜드·키워드)의 관계" noZoom width="880" height="470" data-path="images/resources-light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/dev-chainshift/3wlRsXPc3A9kEySj/images/resources-dark.svg?fit=max&auto=format&n=3wlRsXPc3A9kEySj&q=85&s=bb6908b47531b215c77220c37b1ea0ca" alt="조직 아래 수집 파이프라인(프롬프트 세트·프롬프트·실행·답변)과 독립 리소스(브랜드·키워드)의 관계" noZoom width="880" height="470" data-path="images/resources-dark.svg" />

## Prompt set과 Prompt

**Prompt**는 AI 모델에 실행할 질문 하나입니다(최대 1,000자). 모든 프롬프트는 **Prompt set** 하나에 속하며, 세트당 최대 1,000개까지 담을 수 있습니다. 세트는 "경쟁사 비교 질문 30개"처럼 목적 단위로 프롬프트를 묶고, 실행 요청 시 세트 단위로 한 번에 실행하는 데 씁니다.

## 프롬프트 실행과 답변

**프롬프트 실행**(API에서는 `runs`)은 실행 요청 단위입니다. 프롬프트(개별 ID 목록 또는 세트)와 모델 목록을 담아 제출하면 `runID`가 반환되고, 수집은 비동기로 진행됩니다. 프롬프트 수 × 모델 수 × 반복 횟수의 각 조합이 **Answer** 하나가 됩니다.

Answer는 답변 본문(`content`)과 함께 AI가 인용한 출처(`sources` — URL·제목·도메인), AI가 내부적으로 던진 검색 쿼리(`fanouts`)를 포함합니다. 자세한 구조는 [답변 수집하기](/guides/collecting-answers)를 참고하세요.

## Brand

Brand는 분석의 기준이 되는 브랜드 정보(이름·동의어·웹사이트)입니다. 수집 파이프라인과 독립된 리소스로, 실행 요청에 브랜드가 필요하지 않습니다. 답변에서 브랜드 언급을 찾을 때 브랜드의 이름·동의어를 답변 본문·출처와 대조하는 기준으로 사용합니다.

## Keywords

구글·네이버의 검색량·연관 키워드·자동완성 데이터를 조회하는 유틸리티 API입니다. 수집 파이프라인과 독립적으로 호출할 수 있습니다. [키워드 데이터](/guides/keywords)를 참고하세요.

## 다음 단계

<CardGroup cols={2}>
  <Card title="프롬프트 실행하기" icon="play" href="/guides/submitting-runs">
    프롬프트 등록부터 폴링까지
  </Card>

  <Card title="답변 수집하기" icon="inbox" href="/guides/collecting-answers">
    필터와 페이지네이션으로 답변 조회
  </Card>
</CardGroup>
