사전 요구 사항
- 쿼리할 수 있는 ClickHouse Cloud 서비스.
- Agent Builder의 에이전트 만들기 옵션. 이 옵션이 보이지 않으면 공유 및 액세스에 설명된 대로 조직 관리자에게 Admin Settings에서 에이전트 생성 권한을 부여해 달라고 요청하십시오.
에이전트 만들기
ClickHouse Agents 시작하기
Cloud service의 왼쪽 사이드바에서 ClickHouse agents를 클릭해 에이전트 런치패드를 여십시오. Launch ClickHouse agents를 클릭하면 Agent Builder가 열립니다.에이전트 만들기
Agent Builder에서 왼쪽 패널 상단의 Create New Agent를 클릭하십시오. 다음 핵심 필드를 입력합니다:- Name - 에이전트를 식별하는 짧은 이름입니다.
- Description - 에이전트의 용도를 설명하는 내용으로, 팀원에게 표시됩니다.
- Category - 에이전트의 범주입니다. 조직에 사용자 지정 범주가 없다면
General로 두어도 됩니다. - Instructions - system prompt로, 에이전트의 역할, 답변해야 할 질문, 따라야 하는 비즈니스 규칙을 설명합니다.
- Model - 드롭다운에서 모델을 선택하십시오. 샘플링 온도와 기타 생성 설정은 model parameters에서 조정하십시오.
기능 및 도구 연결하기
에이전트의 기능과 도구는 두 곳에서 관리합니다.메인 패널의 Capabilities — Run Code, 웹 검색, File Context, Artifacts, MCP 서버, 스킬 같은 기본 제공 기능입니다. 에이전트에 필요한 항목을 켜십시오.패널 하단의 Add Tools 버튼에서 여는 Tools — image generation, 비전, 검색 API, 외부 서비스 같은 서드파티 통합입니다.카탈로그를 탐색하려면 Add Tools를 클릭하십시오:서브에이전트는 Advanced settings에서 구성합니다 — 자세한 내용은 서브에이전트 페이지를 참조하십시오.연결된 기능과 도구는 언제든지 변경할 수 있습니다.쿼리 실행하기
에이전트를 저장한 뒤 새 conversation을 열고, agent picker에서 에이전트를 선택하십시오. 예를 들어 “What are my top 10 tables by row count this week?” 같은 질문을 입력하면 에이전트가 계획을 세우고, 필요에 따라 도구를 호출한 후, 답변을 반환합니다.다음 단계
- 팀원과 에이전트를 공유하세요.
- 에이전트가 안정화되면 마켓플레이스에 게시하세요.