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

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# 빠른 시작

> Conare API 키를 받고 curl 또는 TypeScript SDK로 네임스페이스에 첫 문서를 작성한 뒤 검색해서 결과를 모델에 전달합니다.

**1. 키 받기**

[콘솔](https://conare.ai/dashboard/keys)에서 API 키를 만드세요. 초대를 통해서만 이용할 수 있습니다: [액세스 요청](https://conare.ai/request-access).

```bash theme={null}
export CONARE_API_KEY=sk-conare-...
npm install conare  # for the TypeScript examples
```

**2. 문서 작성**

첫 번째 쓰기가 네임스페이스 `docs`를 만듭니다.

```bash curl theme={null}
curl https://api.conare.ai/namespaces/docs/documents \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documents": [
      { "id": "refunds", "text": "Refunds are available for 30 days.", "metadata": { "team": "support" } }
    ]
  }'
```

```ts TypeScript theme={null}
import { Conare } from "conare";

const conare = new Conare();
const docs = conare.namespace("docs");

await docs.add({ id: "refunds", text: "Refunds are available for 30 days.", metadata: { team: "support" } });
```

**3. 검색**

```bash curl theme={null}
curl https://api.conare.ai/namespaces/docs/query \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "how do refunds work?"}'
```

```ts TypeScript theme={null}
const results = await docs.query("how do refunds work?");
```

```json Response theme={null}
{
  "results": [
    {
      "id": "refunds",
      "text": "Refunds are available for 30 days.",
      "score": 0.3471,
      "reranked": true,
      "metadata": { "team": "support" }
    }
  ],
  "took_ms": 59
}
```

각 결과의 `text`를 컨텍스트로 모델에 전달하세요.

## 다음 단계

| 가이드 | 용도 |
| - | - |
| [MCP](https://docs.conare.ai/ko/mcp-server.md) | Claude, Cursor, ChatGPT에서 검색합니다 |
| [필터](https://docs.conare.ai/ko/filters.md) | 메타데이터로 검색 범위를 좁힙니다 |
| [파일](https://docs.conare.ai/ko/files.md) | PDF, 프레젠테이션, 스프레드시트를 업로드합니다 |
| [소스](https://docs.conare.ai/ko/sources.md) | 앱을 동기화 상태로 유지합니다 |


## Related topics

- [소개](https://docs.conare.ai/ko/index.md)
- [MCP](https://docs.conare.ai/ko/mcp-server.md)
- [검색](https://docs.conare.ai/ko/query.md)
- [문서 쓰기](https://docs.conare.ai/ko/write.md)
- [소스](https://docs.conare.ai/ko/sources.md)


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