Skip to main content
에이전트는 기본 AI 모델에 지식기반, 도구, 가드레일, 시스템 프롬프트를 결합하여 만든 업무 특화 AI 어시스턴트입니다. 마케팅, 개발, 고객 지원 등 부서별로 최적화된 AI를 구성할 수 있습니다.

​
에이전트 처리 파이프라인

에이전트는 사용자 질문을 받아 다음 파이프라인을 거쳐 응답을 생성합니다. 가드레일이 입력을 검증하고, 지식기반에서 관련 문서를 검색한 뒤, 필요 시 도구(API, DB)를 호출하여 LLM이 최종 응답을 생성합니다.

​
에이전트 vs 기본 모델

구분기본 모델에이전트
지식사전 학습 데이터만 참조사내 문서, DB 연동
도구기본 기능만외부 API, MCP 서버 연동
응답 스타일범용적업무 맞춤형 지침 적용
보안없음가드레일로 입출력 검증
일관성프롬프트에 따라 변동시스템 프롬프트로 일관성 유지
품질 모니터링수동 확인자동 평가로 품질 추적
에이전트는 기본 모델을 대체하는 것이 아니라, 기본 모델 위에 업무 컨텍스트를 추가하는 개념입니다. 간단한 범용 질문은 기본 모델을, 업무 특화 질문은 에이전트를 사용하세요.

​
에이전트 생성

1

기본 정보 입력

워크스페이스 > 에이전트 > ”+ 새 에이전트” 클릭 후 기본 정보를 입력합니다.
필드설명예시
이름에이전트 표시 이름”마케팅 어시스턴트”
설명에이전트 용도 설명”마케팅 콘텐츠 작성 및 분석 지원”
프로필 이미지에이전트 아이콘마케팅 관련 이미지
태그분류 태그마케팅, 콘텐츠
2

기반 모델 선택

에이전트가 사용할 AI 모델을 선택합니다. 관리자가 등록한 모델 목록에서 선택할 수 있습니다.
3

프롬프트 작성

에이전트의 역할, 성격, 응답 규칙을 정의합니다.
필드설명
작업 프롬프트 (Task Prompt)에이전트의 역할, 성격, 제한사항 및 구체적인 작업 지시를 정의합니다. 일반적인 시스템 프롬프트 역할을 합니다.
답변 포맷 프롬프트 (Response Format Prompt)응답 형식과 구조를 지정합니다 (마크다운, 테이블 등). 작업 프롬프트와 분리하여 응답 형식만 별도로 관리합니다.
각 프롬프트 입력란 옆의 AI 자동 생성 버튼을 클릭하면, 에이전트의 이름, 설명, 연결된 리소스 정보를 분석하여 프롬프트를 자동으로 작성합니다.
당신은 Cloocus의 마케팅 어시스턴트입니다.

## 역할
- 마케팅 콘텐츠 작성 지원
- SNS 게시물 초안 작성
- 마케팅 데이터 분석

## 응답 규칙
- 항상 한국어로 응답
- 전문적이지만 친근한 톤 유지
- 데이터 기반 인사이트 제공
- 브랜드 가이드라인 준수

## 제한사항
- 경쟁사 비방 금지
- 검증되지 않은 통계 사용 금지
4

프롬프트 제안 설정 (선택)

채팅 화면에서 에이전트를 선택했을 때 표시되는 대화 시작 제안 문구를 설정합니다.
옵션설명
Default시스템 기본 제안 문구 사용
Custom에이전트 용도에 맞는 제안 문구 직접 설정
에이전트 용도에 맞는 질문 예시를 제공하면 사용자가 빠르게 대화를 시작할 수 있습니다. 예: “이번 달 매출 현황 요약해줘”, “SNS 게시물 초안 작성해줘”
5

지식기반 연결

에이전트가 참조할 문서를 연결합니다.
  1. “지식기반” 섹션에서 ”+ 추가” 클릭
  2. 연결할 지식기반 선택 (여러 개 선택 가능)
연결된 지식기반의 문서를 RAG로 검색하여 답변에 활용하며, 출처를 인용할 수 있습니다.
6

데이터베이스 연결 (선택)

NL-to-SQL 기반 자연어 데이터 조회를 위해 데이터베이스(DbSphere)를 연결합니다.
  1. “데이터베이스” 섹션에서 ”+ 추가” 클릭
  2. 연결할 데이터베이스 선택 (여러 개 선택 가능)
연결된 데이터베이스에 대해 자연어로 질문하면 AI가 SQL을 생성하고 실행하여 결과를 반환합니다.
7

용어집 연결 (선택)

에이전트가 조직의 비즈니스 용어를 이해할 수 있도록 용어집을 연결합니다.
  1. “용어집” 섹션에서 ”+ 추가” 클릭
  2. 연결할 용어집 선택 (여러 개 선택 가능)
용어집에 등록된 용어의 정의, 동의어, 컨텍스트가 에이전트 응답에 반영됩니다.
8

도구 연결 (선택)

외부 시스템과 연동할 도구를 연결합니다. “도구 연결” 섹션에서 MCP 서버 또는 OpenAPI 서버를 선택합니다.
도구 유형설명
OpenAPI 서버REST API를 통해 외부 서비스와 상호작용
MCP 서버Model Context Protocol 기반 도구 연동
9

기능 설정 (선택)

에이전트가 사용할 수 있는 고급 기능을 설정합니다. 각 기능은 3가지 상태로 제어합니다.
상태설명
Disabled채팅에서 기능을 완전히 숨김 (기본값)
Default On채팅 시작 시 기능이 자동 활성화, 사용자가 끌 수 있음
Default Off채팅에서 기능이 표시되지만 사용자가 직접 켜야 동작
기능설명
웹 검색실시간 웹 검색으로 최신 정보 조회. 결과 수와 도메인 필터 설정 가능
이미지 생성AI 이미지 생성 엔진 연동. 사용할 연결을 선택 가능
코드 인터프리터Python 코드 실행으로 계산 및 데이터 분석 수행
10

응답 형식 설정 (선택)

에이전트의 응답을 구조화된 JSON 형식으로 제한할 수 있습니다.
모드설명
Chat기본 자유형 텍스트 응답
StructuredJSON Schema에 따른 구조화 응답 (Structured Output)
Structured 모드에서는 비주얼 필드 빌더 또는 Raw JSON 에디터로 응답 스키마를 정의할 수 있습니다.
11

가드레일 설정 (선택)

에이전트에 보안 가드레일을 연결하여 입출력을 검증합니다.
  • 개인정보(PII) 자동 탐지 및 마스킹
  • 커스텀 패턴 필터링
  • 금지 단어 차단
  • LLM 기반 콘텐츠 검증
12

자동 평가 설정 (선택)

에이전트 응답 품질을 자동으로 모니터링합니다.
설정설명
샘플링 비율평가할 응답 비율 (1%~100%)
평가 유형검색 품질, 충실성, 응답 품질 중 선택
심판 모델평가에 사용할 LLM 선택
유형설명
검색 품질 (Retrieval Quality)지식기반에서 검색된 문서의 관련성 평가
충실성 (Faithfulness)응답이 검색된 내용에 충실한지, 환각이 없는지 평가
응답 품질 (Response Quality)응답의 전반적인 품질, 유용성, 정확성 평가
13

접근 권한 설정

에이전트 사용 권한을 설정합니다.
옵션설명
공개모든 사용자가 사용 가능
비공개본인만 사용 가능
그룹/조직 지정특정 그룹 또는 조직만 사용 가능
14

저장

“저장” 버튼을 클릭하여 에이전트를 생성합니다.

​
에이전트 사용

​
채팅에서 선택

채팅 화면 상단의 모델 선택 드롭다운에서 에이전트를 선택합니다. 에이전트는 일반 모델과 함께 목록에 표시됩니다.

​
@ 명령어로 호출

채팅 중 @에이전트이름으로 특정 에이전트를 호출할 수 있습니다. 
@마케팅어시스턴트 이번 달 프로모션 SNS 게시물 5개 작성해줘

​
에이전트 관리

작업설명
활성/비활성에이전트 카드의 토글 스위치로 활성화/비활성화. 비활성 에이전트는 채팅에서 선택할 수 없습니다
편집에이전트 카드의 편집 버튼 또는 더보기 메뉴에서 설정 수정
복제기존 에이전트를 복사하여 새 에이전트 빠르게 생성
내보내기/가져오기JSON 파일로 에이전트 설정 백업 및 환경 간 이동
삭제에이전트 영구 삭제 (복구 불가)
내보내기/가져오기를 활용하면 개발 환경에서 생성한 에이전트를 운영 환경으로 이동할 수 있습니다.

​
활용 사례

구성:
  • 기반 모델: GPT-4o-mini
  • 지식기반: 인사규정, 복리후생 안내
  • 작업 프롬프트: HR 전문가 역할
대화 예시:
Q: 연차 신청은 어떻게 하나요?
A: 연차 신청은 다음 절차로 진행됩니다:
1. HR 포털 접속
2. 휴가 신청 메뉴 선택
3. 연차 유형 및 기간 입력
4. 팀장 승인 요청

[출처: 인사규정 제15조]

​
베스트 프랙티스

​
프롬프트 작성

  1. 역할을 명확히 정의하세요 — “당신은 Cloocus 마케팅팀의 콘텐츠 전문가입니다”
  2. 구체적인 지침을 제공하세요 — 응답 언어, 길이, 인용 규칙 등
  3. 제한사항을 설정하세요 — 경쟁사 비방 금지, 개인정보 노출 금지 등

​
지식기반 연결

  • 관련 문서만 연결: 너무 많은 문서는 오히려 검색 정확도를 저하시킵니다
  • 최신 문서 유지: 오래된 정보는 정기적으로 업데이트하세요
  • 도구 설명 작성: 지식기반의 도구 설명을 구체적으로 작성하면 에이전트가 적절한 KB를 선택하는 정확도가 높아집니다

​
접근 권한

  • 최소 권한 원칙: 필요한 사람에게만 접근 권한을 부여하세요
  • 그룹/조직 단위 관리: 개별 사용자보다 그룹 단위로 관리하면 효율적입니다
  • 정기 검토: 권한 설정을 주기적으로 점검하세요

​
FAQ

에이전트는 기본 모델에 지식기반, 도구, 시스템 프롬프트, 가드레일을 추가하여 특정 업무에 최적화한 것입니다. 기본 모델은 범용 대화에, 에이전트는 업무 특화 대화에 적합합니다.
네, 여러 지식기반과 데이터베이스를 동시에 연결할 수 있습니다. 에이전트는 질문에 따라 적절한 리소스를 자동으로 선택합니다.
에이전트 기능 설정의 상태를 확인하세요:
  • Disabled: 채팅에서 기능이 완전히 숨겨집니다
  • Default Off: 채팅 입력창 ”+” 메뉴에서 사용자가 직접 켜야 합니다
  • Default On: 자동 활성화되며, 이 상태에서도 동작하지 않으면 관리자 설정(웹 검색/이미지 생성 연결)을 확인하세요
네, 모니터링 대시보드에서 에이전트별 사용량, 토큰 소비량, 자동 평가 결과를 확인할 수 있습니다.