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

# 빠른 시작

> 첫 번째 ClickHouse Agent를 빌드하고 ClickHouse Cloud 서비스를 대상으로 실행합니다

[베타 기능](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

Cloud Console에서 사용자 지정 에이전트를 만들고 서비스에서 자연어 쿼리를 실행하세요.

## 사전 요구 사항

* 쿼리할 수 있는 ClickHouse Cloud 서비스.
* Agent Builder의 **에이전트 만들기** 옵션. 이 옵션이 보이지 않으면 [공유 및 액세스](https://clickhouse.com/docs/ko/agents/sharing-and-access.md)에 설명된 대로 조직 관리자에게 Admin Settings에서 에이전트 생성 권한을 부여해 달라고 요청하십시오.

## 에이전트 만들기

**1. ClickHouse Agents 시작하기**

Cloud service의 왼쪽 사이드바에서 **ClickHouse agents**를 클릭해 에이전트 런치패드를 여십시오. **Launch ClickHouse agents**를 클릭하면 Agent Builder가 열립니다.

![ClickHouse agents(베타)가 선택된 Cloud service 탐색 화면으로, Launch ClickHouse agents 버튼이 있는 런치패드를 보여줍니다](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/launch-ch-agents.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=7b76b7220ae2e5848fefb70d25e6401c)

**2. 에이전트 만들기**

Agent Builder에서 왼쪽 패널 상단의 **Create New Agent**를 클릭하십시오. 다음 핵심 필드를 입력합니다:

* **Name** - 에이전트를 식별하는 짧은 이름입니다.
* **Description** - 에이전트의 용도를 설명하는 내용으로, 팀원에게 표시됩니다.
* **Category** - 에이전트의 범주입니다. 조직에 사용자 지정 범주가 없다면 `General`로 두어도 됩니다.
* **Instructions** - system prompt로, 에이전트의 역할, 답변해야 할 질문, 따라야 하는 비즈니스 규칙을 설명합니다.
* **Model** - 드롭다운에서 모델을 선택하십시오.

![Create New Agent 드롭다운, 양식 필드(Name, Description, Category, Instructions, Model), 그리고 Capabilities 섹션이 표시된 Agent Builder 패널](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/agent-builder.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b18a3db920e9ec695938613037a72578)

**3. 기능 및 도구 연결하기**

에이전트의 기능과 도구는 두 곳에서 관리합니다.

메인 패널의 **Capabilities** — [Run Code](https://clickhouse.com/docs/ko/agents/builder/code-interpreter.md), [웹 검색](https://clickhouse.com/docs/ko/agents/builder/web-search.md), File Context, Artifacts, [MCP 서버](https://clickhouse.com/docs/ko/agents/builder/mcp-servers.md), [스킬](https://clickhouse.com/docs/ko/agents/builder/skills.md) 같은 기본 제공 기능입니다. 에이전트에 필요한 항목을 켜십시오.

![Run Code, 웹 검색, File Context, Artifacts, MCP 서버, 스킬 토글이 표시된 Agent Builder 패널의 Capabilities 섹션](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/capabilities.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b82e23e834b7b1a8321f80ffc526c936)

패널 하단의 **Add Tools** 버튼에서 여는 **Tools** — [image generation](https://clickhouse.com/docs/ko/agents/builder/image-generation.md), [비전](https://clickhouse.com/docs/ko/agents/builder/vision.md), 검색 API, 외부 서비스 같은 서드파티 통합입니다.

![Add Tools 버튼이 강조 표시된 Agent Builder 패널 하단](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-button.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=42c611769822a510b7b372437b0ddd70)

카탈로그를 탐색하려면 **Add Tools**를 클릭하십시오:

![Google, OpenAI Image Tools, Wolfram, DALL-E-3, Tavily Search, Calculator, Stable Diffusion 등 서드파티 통합 그리드가 표시된 Agent Tools 모달](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=31187ed13e978de4ad88020c060ab2d5)

[서브에이전트](https://clickhouse.com/docs/ko/agents/builder/subagents.md)는 **Advanced settings**에서 구성합니다 — 자세한 내용은 서브에이전트 페이지를 참조하십시오.

연결된 기능과 도구는 언제든지 변경할 수 있습니다.

**4. 쿼리 실행하기**

에이전트를 저장한 뒤 새 conversation을 열고, agent picker에서 에이전트를 선택하십시오. 예를 들어 *"What are my top 10 tables by row count this week?"* 같은 질문을 입력하면 에이전트가 계획을 세우고, 필요에 따라 도구를 호출한 후, 답변을 반환합니다.

!['What are my top 10 tables by row count this week?'라는 질문과 에이전트의 응답이 표시된 채팅 화면으로, 행 수 기준 서비스 전반의 상위 10개 테이블 순위를 보여주는 Markdown 표와 그 아래 Key Observations가 포함되어 있습니다](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/chat-query.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=09fc2481502e3af9c35a59641528c8aa)

## 다음 단계

* 팀원과 [에이전트](https://clickhouse.com/docs/ko/agents/sharing-and-access.md)를 공유하세요.
* 에이전트가 안정화되면 [마켓플레이스](https://clickhouse.com/docs/ko/agents/marketplace.md)에 게시하세요.
