빠른 시작
Cloud Console에서 사용자 지정 에이전트를 만들고 서비스에 대해 자연어 쿼리를 실행합니다.
사전 요구 사항
- 쿼리를 실행할 수 있는 ClickHouse Cloud 서비스.
- Agent Builder의 에이전트 만들기 옵션. 이 옵션이 보이지 않으면 sharing and access에 설명된 대로 조직 관리자에게 Admin Settings에서 에이전트 생성 권한을 부여해 달라고 요청하십시오.
에이전트 만들기
ClickHouse Agents 실행
Cloud service에서 왼쪽 사이드바의 ClickHouse agents를 클릭해 에이전트 런치패드를 여십시오. Launch ClickHouse agents를 클릭하면 Agent Builder가 열립니다.

에이전트 생성
Agent Builder에서 왼쪽 패널 상단의 Create New Agent를 클릭하십시오. 다음 핵심 필드를 입력하십시오.
- Name - 에이전트의 짧은 식별자입니다.
- Description - 에이전트의 용도를 설명하는 내용으로, 팀원에게 표시됩니다.
- Category - 에이전트의 카테고리입니다. 조직에 사용자 지정 카테고리가 없다면
General로 두어도 됩니다. - Instructions - 시스템 프롬프트로, 에이전트의 역할, 답변해야 하는 질문, 따라야 하는 비즈니스 규칙을 설명합니다.
- Model - 드롭다운에서 모델을 선택합니다.

기능과 도구 연결
에이전트의 기능과 도구는 두 곳에서 설정할 수 있습니다.
메인 패널의 Capabilities — Run Code, 웹 검색, File Context, Artifacts, MCP 서버, Skills와 같은 퍼스트파티 기능입니다. 에이전트에 필요한 항목을 켜십시오.

패널 하단의 Add Tools 버튼에서 여는 Tools — 이미지 생성, 비전, 검색 API, 외부 서비스와 같은 서드파티 통합입니다.

Add Tools를 클릭해 카탈로그를 살펴보십시오.

서브에이전트는 Advanced settings에서 설정합니다. 자세한 내용은 서브에이전트 페이지를 참조하십시오.
연결된 기능과 도구는 언제든지 변경할 수 있습니다.
쿼리 실행
에이전트를 저장한 다음 새 대화를 열고 에이전트 선택기에서 해당 에이전트를 선택하십시오. 예를 들어 "What are my top 10 tables by row count this week?" 와 같은 질문을 입력하면, 에이전트가 계획을 세우고 필요에 따라 도구를 호출한 뒤 답변을 반환합니다.

다음 단계
- 팀원과 에이전트를 공유하세요.
- 에이전트가 안정화되면 마켓플레이스에 게시하세요.