> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 빠른 시작

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

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

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

<div id="prerequisites">
  ## 사전 요구 사항
</div>

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

<div id="build-the-agent">
  ## 에이전트 만들기
</div>

<Steps>
  <Step>
    ### ClickHouse Agents 시작하기

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/launch-ch-agents.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=eb003c363ea35ae4b3a128e7c05aa0f7" alt="ClickHouse agents(베타)가 선택된 Cloud service 탐색 화면으로, Launch ClickHouse agents 버튼이 있는 런치패드를 보여줍니다" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/launch-ch-agents.png" />
  </Step>

  <Step>
    ### 에이전트 만들기

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

    * **Name** - 에이전트를 식별하는 짧은 이름입니다.
    * **Description** - 에이전트의 용도를 설명하는 내용으로, 팀원에게 표시됩니다.
    * **Category** - 에이전트의 범주입니다. 조직에 사용자 지정 범주가 없다면 `General`로 두어도 됩니다.
    * **Instructions** - system prompt로, 에이전트의 역할, 답변해야 할 질문, 따라야 하는 비즈니스 규칙을 설명합니다.
    * **Model** - 드롭다운에서 모델을 선택하십시오. 샘플링 온도와 기타 생성 설정은 [model parameters](/ko/products/cloud/features/ai-ml/agents/builder/model-parameters)에서 조정하십시오.

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/agent-builder.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=d0b3a2968764d7409ca639eb0f338d59" alt="Create New Agent 드롭다운, 양식 필드(Name, Description, Category, Instructions, Model), 그리고 Capabilities 섹션이 표시된 Agent Builder 패널" size="lg" width="3834" height="1932" data-path="images/cloud/agent-builder/agent-builder.png" />
  </Step>

  <Step>
    ### 기능 및 도구 연결하기

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/capabilities.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=377d128f77dee49749200261eee7a2c3" alt="Run Code, 웹 검색, File Context, Artifacts, MCP 서버, 스킬 토글이 표시된 Agent Builder 패널의 Capabilities 섹션" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/capabilities.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/tools-button.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=4b18f52a2aa9663c09cc719e6bdffffb" alt="Add Tools 버튼이 강조 표시된 Agent Builder 패널 하단" size="sm" width="596" height="836" data-path="images/cloud/agent-builder/tools-button.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/tools-modal.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=80cb90aa3290765aeb07f2f9b7420c80" alt="Google, OpenAI Image Tools, Wolfram, DALL-E-3, Tavily Search, Calculator, Stable Diffusion 등 서드파티 통합 그리드가 표시된 Agent Tools 모달" size="lg" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.png" />

    [서브에이전트](/ko/products/cloud/features/ai-ml/agents/builder/subagents)는 **Advanced settings**에서 구성합니다 — 자세한 내용은 서브에이전트 페이지를 참조하십시오.

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

  <Step>
    ### 쿼리 실행하기

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/chat-query.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=d55ce37870027c47d6f71d90585cd09e" alt="'What are my top 10 tables by row count this week?'라는 질문과 에이전트의 응답이 표시된 채팅 화면으로, 행 수 기준 서비스 전반의 상위 10개 테이블 순위를 보여주는 Markdown 표와 그 아래 Key Observations가 포함되어 있습니다" size="lg" width="2722" height="1882" data-path="images/cloud/agent-builder/chat-query.png" />
  </Step>
</Steps>

<div id="next-steps">
  ## 다음 단계
</div>

* 팀원과 [에이전트를 공유하세요](/ko/products/cloud/features/ai-ml/agents/sharing-and-access).
* 에이전트가 안정화되면 [마켓플레이스](/ko/products/cloud/features/ai-ml/agents/marketplace)에 게시하세요.