기본 AI 모델에게 매번 같은 맥락을 설명하고, 사내 문서를 수동으로 복붙하고, 답변 형식을 지시하는 것이 번거롭지 않으셨나요?에이전트는 지식기반 + 도구 + 가드레일 + 시스템 프롬프트를 하나로 묶어, 부서별로 최적화된 AI 어시스턴트를 만드는 기능입니다.
한 줄로 — 시스템 프롬프트 + 지식기반 + 도구 + 가드레일을 묶어 부서별로 최적화된 AI를 만드는 기능입니다.
언제 쓰나요? 같은 맥락이 매번 반복되거나, 답변 형식과 사내 자료 인용을 일관되게 유지해야 할 때
얼마나 걸리나요? 시스템 프롬프트만 있는 최소형은 5분 · KB·도구·가드레일까지 풀세팅은 30분쯤
비용은요? 매 응답마다 KB 검색·도구 라우팅이 더해져 기본 모델보다 토큰을 더 씁니다 — 가벼운 질문엔 기본 모델이 낫습니다
이게 맞는 도구일까요? 분기·반복이 핵심이면 플로우, 도구 한두 개만 필요하면 도구를 먼저 살펴보세요
예시
“이번 달 매출 현황 알려줘”
상태
동작
결과
기본 모델
AI의 일반 지식으로 추측
”매출 데이터에 접근할 수 없습니다”
에이전트 (DB + KB 연결)
매출 DB 조회 + 보고서 양식 적용
정확한 매출 데이터 + 표 형식 응답
워크스페이스 > 에이전트에서 생성된 에이전트 목록을 확인합니다
에이전트 처리 파이프라인
에이전트는 사용자 질문을 받아 다음 파이프라인을 거쳐 응답을 생성합니다.가드레일이 입력을 검증하고, 지식기반에서 관련 문서를 검색한 뒤, 필요 시 도구(API, DB)를 호출하여 LLM이 최종 응답을 생성합니다.
어떤 걸 써야 할까?
에이전트·기본 모델·플로우는 비슷해 보이지만 쓰는 상황이 다릅니다.
기본 모델
언제 — 1회성 질문, 자유로운 답변 형식, 일반 지식 기반.“이 코드 무슨 의미야?”, “환율 알려줘” 같은 가벼운 대화에 가장 빠르고 저렴합니다. KB 검색이나 도구 라우팅이 없어 토큰 소비가 적습니다.
에이전트
언제 — 같은 KB를 반복 인용하거나, 답변 톤·형식을 고정하거나, 가드레일을 적용해야 할 때.HR 정책 Q&A, 코드 리뷰어, 데이터 분석가처럼 “어떤 KB를 인용할지·어떤 도구를 부를지”를 LLM에게 맡기는 패턴에 적합합니다.
플로우
언제 — 분기·반복·외부 API 체인이 핵심일 때.폼 입력 → 자동 처리 → 알림 전송, 다단계 승인 같은 자동화에 적합합니다. 의사결정 흐름을 사람이 노드로 명시하므로 동작이 예측 가능합니다.
헷갈릴 때는 에이전트부터 시작하세요. 단순 질문에 과하다 싶으면 기본 모델로 내리고, “이건 if/else 분기 같다” 싶으면 플로우로 옮기면 됩니다. 한 번에 정답을 고를 필요 없습니다.
에이전트 생성
1
기본 정보 입력
워크스페이스 > 에이전트 > ”+ 새 에이전트” 클릭 후 기본 정보를 입력합니다.
에이전트 이름, 설명, 프로필 이미지를 설정합니다
필드
설명
예시
에이전트 이름
에이전트 표시 이름
”마케팅 어시스턴트”
설명
에이전트 용도 설명
”마케팅 콘텐츠 작성 및 분석 지원”
에이전트 이미지
에이전트 아이콘
마케팅 관련 이미지
2
기본 모델 선택
에이전트가 사용할 AI 모델을 선택합니다. 관리자가 등록한 모델 목록에서 선택할 수 있습니다.
3
프롬프트 작성
에이전트의 역할, 성격, 응답 규칙을 정의합니다.
필드
설명
작업 프롬프트 (Task Prompt)
에이전트의 역할, 성격, 제한사항 및 구체적인 작업 지시를 정의합니다. 일반적인 시스템 프롬프트 역할을 합니다.
답변 포맷 프롬프트 (Response Format Prompt)
응답 형식과 구조를 지정합니다 (마크다운, 테이블 등). 기본 답변 형식이며, 아래 답변 양식을 등록한 경우 맞는 양식이 없는 질문에 이 형식이 적용됩니다.
답변 양식 (Response Formats)
선택 사항. ”+ 답변 양식 추가”로 질문 유형별 답변 스타일을 여러 개 등록하면, 에이전트가 질문에 맞는 것을 자동으로 고릅니다. 비워두면 항상 답변 포맷 프롬프트가 적용됩니다.
각 프롬프트 입력란 옆의 AI로 생성 버튼(보라색 AI 아이콘)을 클릭하면, 에이전트의 이름, 설명, 연결된 리소스 정보를 분석하여 프롬프트를 자동으로 작성합니다.
AI 자동 생성 시, 도구 사용법이나 SQL 작성 규칙 같은 기술적 지침은 자동으로 제외됩니다. 플랫폼이 이를 자동 처리하므로, 프롬프트에는 역할·성격·제한사항만 포함됩니다.
작업 프롬프트(역할 정의)와 답변 포맷 프롬프트(출력 형식)를 분리하여 작성합니다
좋은 작업 프롬프트 예시
당신은 Cloocus의 마케팅 어시스턴트입니다.## 역할- 마케팅 콘텐츠 작성 지원- SNS 게시물 초안 작성- 마케팅 데이터 분석## 응답 규칙- 항상 한국어로 응답- 전문적이지만 친근한 톤 유지- 데이터 기반 인사이트 제공- 브랜드 가이드라인 준수## 제한사항- 경쟁사 비방 금지- 검증되지 않은 통계 사용 금지
작업 프롬프트와 답변 포맷 프롬프트는 왜 분리되어 있나요?
두 프롬프트는 에이전트 실행의 서로 다른 단계에서 사용됩니다.
작업 프롬프트
답변 포맷 프롬프트
적용 시점
에이전트가 도구를 사용하는 동안
최종 답변을 작성할 때
역할
”무엇을 해야 하는가” (역할, 제한사항)
“어떻게 답해야 하는가” (마크다운, 표, 길이)
포함할 내용
역할 정의, 행동 규칙, 제한사항
출력 형식, 어조, 구조
포함하면 안 되는 것
출력 형식 지정
역할 정의, 행동 규칙
분리하면 역할은 유지하면서 출력 형식만 바꾸거나, 반대로 출력 형식은 유지하면서 역할만 변경할 수 있습니다.
4
프롬프트 제안 설정 (선택)
채팅 화면에서 에이전트를 선택했을 때 표시되는 대화 시작 제안 문구를 설정합니다.
옵션
설명
기본값
시스템 기본 제안 문구 사용
사용자 정의
에이전트 용도에 맞는 제안 문구 직접 설정
에이전트 용도에 맞는 질문 예시를 제공하면 사용자가 빠르게 대화를 시작할 수 있습니다.
예: “이번 달 매출 현황 요약해줘”, “SNS 게시물 초안 작성해줘”
외부 시스템과 연동할 도구를 연결합니다. “도구 연결” 섹션에서 MCP 서버 또는 OpenAPI 서버를 선택합니다.
도구 유형
설명
OpenAPI 서버
REST API를 통해 외부 서비스와 상호작용
MCP 서버
Model Context Protocol 기반 도구 연동
연결한 도구의 설명(description)이 비어있으면 편집기 상단에 경고 배너가 표시됩니다. 도구 설명은 LLM이 “언제 이 도구를 호출할지” 판단하는 핵심 근거이므로, 미작성 도구가 있으면 잘못된 호출 또는 미사용으로 이어질 수 있습니다. 배너가 보이면 해당 도구의 도구 정의에서 설명을 보강하세요.
9
기능 설정 (선택)
에이전트가 사용할 수 있는 고급 기능을 설정합니다. 각 기능은 3가지 상태로 제어합니다.
상태
설명
제한됨
채팅에서 기능을 완전히 숨김 (기본값)
기본 활성화
채팅 시작 시 기능이 자동 활성화, 사용자가 끌 수 있음
기본 비활성화
채팅에서 기능이 표시되지만 사용자가 직접 켜야 동작
기능
설명
웹 검색
실시간 웹 검색으로 최신 정보 조회. 결과 수와 도메인 필터 설정 가능
이미지 생성
AI 이미지 생성 엔진 연동. 사용할 연결을 선택 가능
Gmail
사용자를 대신해 메일 조회·발송
구글 캘린더
사용자를 대신해 일정 조회·등록
Google Drive
사용자를 대신해 파일 검색·Google 문서 생성
위 5개와 별개로, 답변 방식을 조정하는 설정 4가지가 같은 화면에 함께 있습니다. 이쪽은 3가지 상태가 아니라 개별 값을 가집니다.
설정
설명
기본값
추론 과정 표시
답변 앞에 도구 호출(인자·결과)과 사고 과정을 접이식 블록으로 표시. 간략(도구 이름만) · 상세(실시간 추론 단계) · 없음 중 선택
간략
그라운딩
답변을 연결된 데이터 소스(지식 기반·데이터베이스·도구) 범위로 제한. 끄면 소스가 질문을 덮지 못할 때 일반 지식으로 답합니다
켜짐
사용자에게 되묻기
핵심 정보가 빠졌거나 요청이 모호할 때 버튼 또는 자유 입력으로 되묻습니다
꺼짐
문서 생성
내장 도구로 PPT·Word·Excel 파일을 생성할 수 있게 합니다
꺼짐
그라운딩의 기본값은 화면에 따라 다릅니다. 에이전트 편집에서는 켜짐이지만, 기본 모델 편집에서는 꺼짐입니다.
Gmail·캘린더·Drive는 여기서 켜도 사용자 본인이 설정 > 연결에서 Google 계정을 연결해야 채팅에 나타납니다. 코드 실행은 에이전트 기능 설정 항목이 아닙니다 — 코드 실행 참고.
채팅 기능 5개는 3가지 상태로, 답변 방식 4개는 개별 값으로 설정합니다
10
응답 형식 설정 (선택)
에이전트의 응답을 구조화된 JSON 형식으로 제한할 수 있습니다.
모드
설명
채팅
기본 자유형 텍스트 응답
구조화된 응답
JSON Schema에 따른 구조화 응답 (Structured Output)
구조화된 응답 모드에서는 비주얼 필드 빌더 또는 Raw JSON 에디터로 응답 스키마를 정의할 수 있습니다.
구조화된 응답 모드에서 JSON Schema로 응답 구조를 정의합니다
11
가드레일 설정 (선택)
에이전트에 보안 가드레일을 연결하여 입출력을 검증합니다.
개인정보(PII) 자동 탐지 및 마스킹
커스텀 패턴 필터링
금지 단어 차단
LLM 기반 콘텐츠 검증
12
자동 평가 설정 (선택)
에이전트 응답 품질을 자동으로 모니터링합니다.
설정
설명
심사 모델
평가에 사용할 LLM 선택
샘플링 비율
평가할 응답 비율 (1%~100%)
평가 유형
검색 품질, 충실도, 응답 품질 중 선택
평가 유형 상세
유형
설명
검색 품질 (Retrieval Quality)
지식기반에서 검색된 문서의 관련성 평가
충실도 (Faithfulness)
응답이 검색된 내용에 충실한지, 환각이 없는지 평가
응답 품질 (Response Quality)
응답의 전반적인 품질, 유용성, 정확성 평가
샘플링 비율 권장:
상황
권장 비율
이유
신규 에이전트 (검증 단계)
50~100%
초기 품질 파악 필요
안정화된 에이전트
5~10%
비용 절감하면서 모니터링
핵심 업무 에이전트
20~30%
지속적 품질 보증 필요
검색 품질과 충실도 평가는 지식기반(KB) 검색 결과가 있을 때만 실행됩니다. KB가 연결되지 않은 에이전트에서는 응답 품질만 선택하세요.
자동 평가를 활성화하면 응답 품질을 지속적으로 모니터링할 수 있습니다
13
접근 권한 설정
에이전트 사용 권한을 설정합니다.
옵션
설명
공개
모든 사용자가 사용 가능
비공개
본인만 사용 가능
그룹 지정
지정한 그룹의 구성원만 사용 가능
접근 제어 모달 — 그룹을 검색해 추가하고 행마다 편집 가능 여부를 지정합니다
14
저장
“저장 및 생성” 버튼을 클릭하여 에이전트를 생성합니다.
에이전트 사용
채팅에서 선택
채팅 화면 상단의 모델 선택 드롭다운에서 에이전트를 선택합니다. 에이전트는 일반 모델과 함께 목록에 표시됩니다.
@ 명령어로 호출
채팅 중 @에이전트이름으로 특정 에이전트를 호출할 수 있습니다.
@마케팅어시스턴트 이번 달 프로모션 SNS 게시물 5개 작성해줘
에이전트 관리
작업
설명
활성/비활성
에이전트 카드의 토글 스위치로 활성화/비활성화. 비활성 에이전트는 채팅에서 선택할 수 없습니다
편집
에이전트 카드를 클릭하여 설정 수정
복제
기존 에이전트를 복사하여 새 에이전트 빠르게 생성
내보내기/가져오기
JSON 파일로 에이전트 설정 백업 및 환경 간 이동
삭제
에이전트 영구 삭제 (복구 불가)
내보내기/가져오기를 활용하면 개발 환경에서 생성한 에이전트를 운영 환경으로 이동할 수 있습니다.
활용 시나리오
추상적인 기능 설명이 아니라 실제 운영에서 나오는 상황 → 어떻게 구성하는지의 패턴을 모았습니다. 비슷한 상황이 있다면 그대로 시작점으로 쓰세요.
HR 어시스턴트 — 인사규정 Q&A
상황: 연차·복리후생·취업규칙 같은 반복 문의가 HR팀에 몰린다. 답변 출처(규정 몇 조)도 같이 줘야 신뢰가 생긴다.구성:
항목
값
기반 모델
GPT-4o-mini (저비용, 사실 위주 응답에 충분)
지식기반
인사규정, 복리후생 안내 PDF
시스템 프롬프트
”HR 전문가. 답변 끝에 항상 출처 조항 표기. 추측 금지”
가드레일
출력 PII 마스킹 (직원 식별 정보 차단)
권한
비공개 / 전사 그룹에 Read
만드는 순서: 지식기반 생성 → PDF 업로드 → 에이전트 생성 → KB 연결 → 시스템 프롬프트 작성 → 가드레일 연결 → 전사 공개흔한 함정:
만드는 순서: 가이드라인을 KB로 정리 → 에이전트 생성 → “@code-reviewer” 핸들 부여 → 채팅에서 @code-reviewer 이 함수 리뷰해줘 호출흔한 함정:
가이드라인이 outdated면 잘못된 리뷰 → KB sync 주기 설정 필수
코드 전체를 채팅에 붙여넣으면 토큰 폭증 → 함수 단위 리뷰로 유도
데이터 분석가 — DB 연결 + 데이터 딕셔너리
상황: “이번 달 매출 TOP 5” 같은 질문에 BI 팀이 매번 SQL을 짜준다. 비기술자도 자연어로 물을 수 있게.구성:
항목
값
기반 모델
GPT-4o (SQL 생성·표 렌더링 안정)
데이터베이스
DbSphere에서 매출 DB 연결
지식기반
데이터 딕셔너리 (테이블/컬럼 의미 사전)
시스템 프롬프트
”쿼리 결과는 표로. 데이터 소스 테이블명 표기”
가드레일
입력 SQL injection 패턴 차단
만드는 순서: DbSphere에서 DB 등록 + 스키마 추출 → 데이터 딕셔너리 KB 작성 → 에이전트 생성 → DB + KB 연결흔한 함정:
스키마 추출 안 하면 LLM이 컬럼명 추측 → 잘못된 SQL → DbSphere에서 추출 우선
큰 테이블 전체 SELECT는 비용 폭증 → 시스템 프롬프트에 LIMIT 강제
민감 컬럼(salary 등)은 DB 연결 시 컬럼 단위 차단 설정 활용
고객 지원 임베드 — 외부 사이트에 노출
상황: 제품 사이트에 챗봇을 임베드해 비로그인 방문자도 FAQ를 묻게 하고 싶다. 단, 회사 내부 정보는 절대 노출되면 안 된다.구성:
항목
값
기반 모델
GPT-4o-mini (저비용, 외부 트래픽 대응)
지식기반
공개 FAQ, 제품 매뉴얼만 (내부 문서 제외)
시스템 프롬프트
”회사 내부 정보·가격 정책 추측 금지. 모르면 ‘담당자 문의’ 안내”
가드레일
출력 PII / 내부 코드명 / 미공개 가격 차단
임베드 위젯
게스트 모드 ON, side-bottom 배치
만드는 순서: 공개 KB 분리 → 가드레일 정책 작성 → 에이전트 생성 (공개 권한) → 임베드 위젯에서 이 에이전트 선택 → 게스트 모드 활성화흔한 함정:
내부 KB와 공개 KB를 분리 안 하면 답변에 내부 정보 노출 → KB 자체를 분리해야 안전
가드레일은 출력 검증, KB 분리는 정보 격리 — 둘 다 필요
회의록 요약기 — 최소 구성
상황: 매주 회의록을 요약해 슬랙으로 공유. KB나 도구 없이 단순 가공만.구성:
항목
값
기반 모델
Claude Sonnet 4.x
지식기반
없음
시스템 프롬프트
”회의록을 받으면 1) 결정사항 2) 액션 아이템(담당자/마감) 3) 다음 안건으로 정리”
도구
없음
만드는 순서: 에이전트 생성 → 시스템 프롬프트만 작성 → 채팅에 회의록 붙여넣기언제 이걸로 충분한가: KB·도구·가드레일 없는 “프롬프트 + 모델”만 묶고 싶을 때. 5분 안에 만든다. 더 단순하면 프롬프트 기능으로 충분할 수도 있음.
베스트 프랙티스
프롬프트 작성
역할을 명확히 정의하세요 — “당신은 Cloocus 마케팅팀의 콘텐츠 전문가입니다”
구체적인 지침을 제공하세요 — 응답 언어, 길이, 인용 규칙 등
제한사항을 설정하세요 — 경쟁사 비방 금지, 개인정보 노출 금지 등
지식기반 연결
관련 문서만 연결: 너무 많은 문서는 오히려 검색 정확도를 저하시킵니다
최신 문서 유지: 오래된 정보는 정기적으로 업데이트하세요
도구 설명 작성: 지식기반의 도구 설명을 구체적으로 작성하면 에이전트가 적절한 KB를 선택하는 정확도가 높아집니다
접근 권한
최소 권한 원칙: 필요한 사람에게만 접근 권한을 부여하세요
그룹 관리: 개별 사용자보다 그룹 단위로 관리하면 효율적입니다
정기 검토: 권한 설정을 주기적으로 점검하세요
FAQ
에이전트와 기본 모델의 차이점은?
에이전트는 기본 모델에 지식기반, 도구, 시스템 프롬프트, 가드레일을 추가하여 특정 업무에 최적화한 것입니다. 기본 모델은 범용 대화에, 에이전트는 업무 특화 대화에 적합합니다.
한 에이전트에 여러 지식기반을 연결할 수 있나요?
네, 여러 지식기반과 데이터베이스를 동시에 연결할 수 있습니다. 에이전트는 질문에 따라 적절한 리소스를 자동으로 선택합니다. 지식기반마다 도구 설명(Tool Description)을 구체적으로 작성하면 선택 정확도가 높아집니다.
웹 검색/이미지 생성/Google Workspace가 동작하지 않습니다.
에이전트 기능 설정의 상태를 확인하세요:
제한됨: 채팅에서 기능이 완전히 숨겨집니다
기본 비활성화: 채팅 입력창에서 사용자가 직접 켜야 합니다
기본 활성화: 자동 활성화되며, 이 상태에서도 동작하지 않으면 관리자 설정(웹 검색/이미지 생성 연결)을 확인하세요
Gmail·캘린더·Drive는 여기에 더해 사용자 본인의 Google 계정 연결과 소속 그룹의 권한이 모두 있어야 채팅에 나타납니다.
에이전트 사용량도 추적되나요?
네, 모니터링 대시보드에서 에이전트별 사용량, 토큰 소비량, 자동 평가 결과를 확인할 수 있습니다.
에이전트를 다른 환경으로 옮길 수 있나요?
네, 내보내기(Export) 기능으로 JSON 파일을 다운로드한 뒤 다른 환경에서 가져오기(Import)하면 됩니다. 단, 연결된 지식기반·도구·가드레일은 대상 환경에 별도로 설정해야 합니다.
에이전트를 숨길 수 있나요?
네, 에이전트 카드의 우측 상단 토글 조작을 통하여 상태를 제한됨으로 변경하면 채팅 모델 선택 목록에서 숨겨집니다. 에이전트가 삭제되는 것이 아니며, 다시 표시할 수 있습니다.
관련 페이지
지식기반
에이전트에 연결할 문서 기반 지식 저장소
가드레일
에이전트 입출력 보안 검증
도구
OpenAPI / MCP 외부 서비스 연동
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"ko/workspace/agents","slug":"/ko/workspace/agents","pageMetadata":{"title":"에이전트","description":"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리","href":"/ko/workspace/agents"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Mermaid,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`기본 AI 모델에게 매번 같은 맥락을 설명하고, 사내 문서를 수동으로 복붙하고, 답변 형식을 지시하는 것이 번거롭지 않으셨나요?`}),`\n`,_jsxs(_components.p,{children:[`에이전트는 `,_jsx(_components.strong,{children:`지식기반 + 도구 + 가드레일 + 시스템 프롬프트`}),`를 하나로 묶어, 부서별로 최적화된 AI 어시스턴트를 만드는 기능입니다.`]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`한 줄로 — `,_jsx(_components.strong,{children:`시스템 프롬프트 + 지식기반 + 도구 + 가드레일`}),`을 묶어 부서별로 최적화된 AI를 만드는 기능입니다.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`언제 쓰나요?`}),` 같은 맥락이 매번 반복되거나, 답변 형식과 사내 자료 인용을 일관되게 유지해야 할 때`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`얼마나 걸리나요?`}),` 시스템 프롬프트만 있는 최소형은 5분 · KB·도구·가드레일까지 풀세팅은 30분쯤`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`비용은요?`}),` 매 응답마다 KB 검색·도구 라우팅이 더해져 기본 모델보다 토큰을 더 씁니다 — 가벼운 질문엔 기본 모델이 낫습니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`이게 맞는 도구일까요?`}),` 분기·반복이 핵심이면 `,_jsx(_components.a,{href:`/ko/workspace/flows`,children:`플로우`}),`, 도구 한두 개만 필요하면 `,_jsx(_components.a,{href:`/ko/workspace/tools`,children:`도구`}),`를 먼저 살펴보세요`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`예시`,children:`예시`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`“이번 달 매출 현황 알려줘”`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`상태`}),_jsx(_components.th,{children:`동작`}),_jsx(_components.th,{children:`결과`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`기본 모델`}),_jsx(_components.td,{children:`AI의 일반 지식으로 추측`}),_jsx(_components.td,{children:`”매출 데이터에 접근할 수 없습니다”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`에이전트 (DB + KB 연결)`}),_jsx(_components.td,{children:`매출 DB 조회 + 보고서 양식 적용`}),_jsx(_components.td,{children:`정확한 매출 데이터 + 표 형식 응답`})]})]})]}),`\n`,_jsx(Frame,{caption:`워크스페이스 > 에이전트에서 생성된 에이전트 목록을 확인합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/workspace/agents-list.png?fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=106f3ec908e5673810e7f7b7a4c885c2`,alt:`에이전트 목록`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`949`,height:`949`,\"data-path\":`images/workspace/agents-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/workspace/agents-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=faafef28ca255deda6973a82bde45aee 280w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/workspace/agents-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=e29b4d94a830f65fb9433adb544cb895 560w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/workspace/agents-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=d02ad7d3c5a7ff3b12cc398a86fc3e3d 840w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/workspace/agents-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=06d2cc710ddad56f3383e807056c3af0 1100w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/workspace/agents-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=5f0181fb58f3d9a73d2a7805450f848a 1650w, https://mintcdn.com/cloocus/fbBOcvIu_gXv0Pc3/images/workspace/agents-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fbBOcvIu_gXv0Pc3\u0026q=85\u0026s=80135d8f59b95205c3958e8bf3ddb437 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`에이전트-처리-파이프라인`,children:`에이전트 처리 파이프라인`}),`\n`,_jsx(_components.p,{children:`에이전트는 사용자 질문을 받아 다음 파이프라인을 거쳐 응답을 생성합니다.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[사용자 질문] --> B[가드레일 검증]\n B --> C{통과?}\n C -->|No| D[차단/마스킹]\n C -->|Yes| E[지식기반 검색]\n E --> F[도구 호출]\n F --> G[LLM 응답]\n G --> H[자동 평가]\n H --> I[응답 반환]`}),`\n`,_jsx(_components.p,{children:`가드레일이 입력을 검증하고, 지식기반에서 관련 문서를 검색한 뒤, 필요 시 도구(API, DB)를 호출하여 LLM이 최종 응답을 생성합니다.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`어떤-걸-써야-할까`,children:`어떤 걸 써야 할까?`}),`\n`,_jsx(_components.p,{children:`에이전트·기본 모델·플로우는 비슷해 보이지만 쓰는 상황이 다릅니다.`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsxs(Card,{title:`기본 모델`,icon:`comments`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`언제`}),` — 1회성 질문, 자유로운 답변 형식, 일반 지식 기반.`]}),_jsx(_components.p,{children:`“이 코드 무슨 의미야?”, “환율 알려줘” 같은 가벼운 대화에 가장 빠르고 저렴합니다. KB 검색이나 도구 라우팅이 없어 토큰 소비가 적습니다.`})]}),_jsxs(Card,{title:`에이전트`,icon:`robot`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`언제`}),` — 같은 KB를 반복 인용하거나, 답변 톤·형식을 고정하거나, 가드레일을 적용해야 할 때.`]}),_jsxs(_components.p,{children:[`HR 정책 Q\u0026A, 코드 리뷰어, 데이터 분석가처럼 `,_jsx(_components.strong,{children:`“어떤 KB를 인용할지·어떤 도구를 부를지”를 LLM에게 맡기는`}),` 패턴에 적합합니다.`]})]}),_jsxs(Card,{title:`플로우`,icon:`diagram-project`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`언제`}),` — 분기·반복·외부 API 체인이 핵심일 때.`]}),_jsxs(_components.p,{children:[`폼 입력 → 자동 처리 → 알림 전송, 다단계 승인 같은 자동화에 적합합니다. `,_jsx(_components.strong,{children:`의사결정 흐름을 사람이 노드로 명시`}),`하므로 동작이 예측 가능합니다.`]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`헷갈릴 때는 `,_jsx(_components.strong,{children:`에이전트부터`}),` 시작하세요. 단순 질문에 과하다 싶으면 기본 모델로 내리고, “이건 if/else 분기 같다” 싶으면 `,_jsx(_components.a,{href:`/ko/workspace/flows`,children:`플로우`}),`로 옮기면 됩니다. 한 번에 정답을 고를 필요 없습니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`에이전트-생성`,children:`에이전트 생성`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`기본 정보 입력`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 > 에이전트 > ”+ 새 에이전트”`}),` 클릭 후 기본 정보를 입력합니다.`]}),_jsx(Frame,{caption:`에이전트 이름, 설명, 프로필 이미지를 설정합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/IagciwMMe05AD3uR/images/workspace/agents-create-basic.png?fit=max\u0026auto=format\u0026n=IagciwMMe05AD3uR\u0026q=85\u0026s=0086dea22491112e912e66cffcbbd54c`,alt:`에이전트 생성 기본 정보`,\"data-og-width\":`1912`,width:`1912`,\"data-og-height\":`907`,height:`907`,\"data-path\":`images/workspace/agents-create-basic.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/IagciwMMe05AD3uR/images/workspace/agents-create-basic.png?w=280\u0026fit=max\u0026auto=format\u0026n=IagciwMMe05AD3uR\u0026q=85\u0026s=81d83deff5067a790f503d9cf9dcf65e 280w, https://mintcdn.com/cloocus/IagciwMMe05AD3uR/images/workspace/agents-create-basic.png?w=560\u0026fit=max\u0026auto=format\u0026n=IagciwMMe05AD3uR\u0026q=85\u0026s=23cdd03a3d2f687328fc3d4bf6f137f3 560w, https://mintcdn.com/cloocus/IagciwMMe05AD3uR/images/workspace/agents-create-basic.png?w=840\u0026fit=max\u0026auto=format\u0026n=IagciwMMe05AD3uR\u0026q=85\u0026s=63cbf85a10c9c39ab2dc7e58d76a3f86 840w, https://mintcdn.com/cloocus/IagciwMMe05AD3uR/images/workspace/agents-create-basic.png?w=1100\u0026fit=max\u0026auto=format\u0026n=IagciwMMe05AD3uR\u0026q=85\u0026s=fe4d4e4feaa6bf090bdcbaf0f0be5f50 1100w, https://mintcdn.com/cloocus/IagciwMMe05AD3uR/images/workspace/agents-create-basic.png?w=1650\u0026fit=max\u0026auto=format\u0026n=IagciwMMe05AD3uR\u0026q=85\u0026s=715bf3135224cdc69a560e3ce2ea3875 1650w, https://mintcdn.com/cloocus/IagciwMMe05AD3uR/images/workspace/agents-create-basic.png?w=2500\u0026fit=max\u0026auto=format\u0026n=IagciwMMe05AD3uR\u0026q=85\u0026s=d7bfe5458ba6cf38ce94dc2cac2be22f 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`에이전트 이름`})}),_jsx(_components.td,{children:`에이전트 표시 이름`}),_jsx(_components.td,{children:`”마케팅 어시스턴트”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`설명`})}),_jsx(_components.td,{children:`에이전트 용도 설명`}),_jsx(_components.td,{children:`”마케팅 콘텐츠 작성 및 분석 지원”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`에이전트 이미지`})}),_jsx(_components.td,{children:`에이전트 아이콘`}),_jsx(_components.td,{children:`마케팅 관련 이미지`})]})]})]})]}),_jsx(Step,{title:`기본 모델 선택`,children:_jsx(_components.p,{children:`에이전트가 사용할 AI 모델을 선택합니다. 관리자가 등록한 모델 목록에서 선택할 수 있습니다.`})}),_jsxs(Step,{title:`프롬프트 작성`,children:[_jsx(_components.p,{children:`에이전트의 역할, 성격, 응답 규칙을 정의합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`작업 프롬프트 (Task Prompt)`})}),_jsx(_components.td,{children:`에이전트의 역할, 성격, 제한사항 및 구체적인 작업 지시를 정의합니다. 일반적인 시스템 프롬프트 역할을 합니다.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`답변 포맷 프롬프트 (Response Format Prompt)`})}),_jsxs(_components.td,{children:[`응답 형식과 구조를 지정합니다 (마크다운, 테이블 등). `,_jsx(_components.strong,{children:`기본 답변 형식`}),`이며, 아래 답변 양식을 등록한 경우 맞는 양식이 없는 질문에 이 형식이 적용됩니다.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`답변 양식 (Response Formats)`})}),_jsxs(_components.td,{children:[`선택 사항. ”`,_jsx(_components.strong,{children:`+ 답변 양식 추가`}),`”로 질문 유형별 답변 스타일을 여러 개 등록하면, 에이전트가 질문에 맞는 것을 자동으로 고릅니다. 비워두면 항상 답변 포맷 프롬프트가 적용됩니다.`]})]})]})]}),_jsxs(_components.p,{children:[`각 프롬프트 입력란 옆의 `,_jsx(_components.strong,{children:`AI로 생성`}),` 버튼(보라색 AI 아이콘)을 클릭하면, 에이전트의 이름, 설명, 연결된 리소스 정보를 분석하여 프롬프트를 자동으로 작성합니다.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`AI 자동 생성 시, 도구 사용법이나 SQL 작성 규칙 같은 기술적 지침은 `,_jsx(_components.strong,{children:`자동으로 제외`}),`됩니다. 플랫폼이 이를 자동 처리하므로, 프롬프트에는 역할·성격·제한사항만 포함됩니다.`]})}),_jsx(Frame,{caption:`작업 프롬프트(역할 정의)와 답변 포맷 프롬프트(출력 형식)를 분리하여 작성합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/agents-task-prompt.png?fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=18078f0b6023d7716a551d0273181d5b`,alt:`작업 프롬프트 입력`,\"data-og-width\":`876`,width:`876`,\"data-og-height\":`506`,height:`506`,\"data-path\":`images/workspace/agents-task-prompt.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/agents-task-prompt.png?w=280\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=eb546ee4e5c9f3984e382ba174c41444 280w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/agents-task-prompt.png?w=560\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=d58db16468fcd34b467371f702905b48 560w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/agents-task-prompt.png?w=840\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=1457ec04fdb49b3db2ffd7d2177e349f 840w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/agents-task-prompt.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=39df13eae1afa0dd6545f93938c9ba57 1100w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/agents-task-prompt.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=87b3455d8cb97ca7eeeb921d85fd30cb 1650w, https://mintcdn.com/cloocus/V18t8of2Z8AG0a6s/images/workspace/agents-task-prompt.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V18t8of2Z8AG0a6s\u0026q=85\u0026s=d165c88c7598069a71d9d136da73793c 2500w`})}),_jsx(Accordion,{title:`좋은 작업 프롬프트 예시`,id:`%EB%8B%B9%EC%8B%A0%EC%9D%80-cloocus%EC%9D%98-%EB%A7%88%EC%BC%80%ED%8C%85-%EC%96%B4%EC%8B%9C%EC%8A%A4%ED%84%B4%ED%8A%B8%EC%9E%85%EB%8B%88%EB%8B%A4.-%23%23-%EC%97%AD%ED%95%A0---%EB%A7%88%EC%BC%80%ED%8C%85-%EC%BD%98%ED%85%90%EC%B8%A0-%EC%9E%91%EC%84%B1-%EC%A7%80%EC%9B%90---sns-%EA%B2%8C%EC%8B%9C%EB%AC%BC-%EC%B4%88%EC%95%88-%EC%9E%91%EC%84%B1---%EB%A7%88%EC%BC%80%ED%8C%85-%EB%8D%B0%EC%9D%B4%ED%84%B0-%EB%B6%84%EC%84%9D-%23%23-%EC%9D%91%EB%8B%B5-%EA%B7%9C%EC%B9%99---%ED%95%AD%EC%83%81-%ED%95%9C%EA%B5%AD%EC%96%B4%EB%A1%9C-%EC%9D%91%EB%8B%B5---%EC%A0%84%EB%AC%B8%EC%A0%81%EC%9D%B4%EC%A7%80%EB%A7%8C-%EC%B9%9C%EA%B7%BC%ED%95%9C-%ED%86%A4-%EC%9C%A0%EC%A7%80---%EB%8D%B0%EC%9D%B4%ED%84%B0-%EA%B8%B0%EB%B0%98-%EC%9D%B8%EC%82%AC%EC%9D%B4%ED%8A%B8-%EC%A0%9C%EA%B3%B5---%EB%B8%8C%EB%9E%9C%EB%93%9C-%EA%B0%80%EC%9D%B4%EB%93%9C%EB%9D%BC%EC%9D%B8-%EC%A4%80%EC%88%98-%23%23-%EC%A0%9C%ED%95%9C%EC%82%AC%ED%95%AD---%EA%B2%BD%EC%9F%81%EC%82%AC-%EB%B9%84%EB%B0%A9-%EA%B8%88%EC%A7%80---%EA%B2%80%EC%A6%9D%EB%90%98%EC%A7%80-%EC%95%8A%EC%9D%80-%ED%86%B5%EA%B3%84-%EC%82%AC%EC%9A%A9-%EA%B8%88%EC%A7%80`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`markdown`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`markdown`,children:_jsxs(_components.code,{language:`markdown`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`당신은 Cloocus의 마케팅 어시스턴트입니다.`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## 역할`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 마케팅 콘텐츠 작성 지원`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` SNS 게시물 초안 작성`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 마케팅 데이터 분석`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## 응답 규칙`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 항상 한국어로 응답`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 전문적이지만 친근한 톤 유지`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 데이터 기반 인사이트 제공`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 브랜드 가이드라인 준수`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## 제한사항`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 경쟁사 비방 금지`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` 검증되지 않은 통계 사용 금지`})]}),`\n`]})})})}),_jsxs(Accordion,{title:`작업 프롬프트와 답변 포맷 프롬프트는 왜 분리되어 있나요?`,id:`-1`,children:[_jsxs(_components.p,{children:[`두 프롬프트는 에이전트 실행의 `,_jsx(_components.strong,{children:`서로 다른 단계`}),`에서 사용됩니다.`]}),_jsx(Mermaid,{chart:`flowchart TD\n A[\"① 작업 프롬프트 적용\"] --> B[에이전트가 도구 호출하며 데이터 수집]\n B --> C[KB 검색, DB 조회, 웹 검색 등]\n C --> D[\"② 답변 포맷 프롬프트 적용\"]\n D --> E[수집된 데이터로 최종 답변 작성]`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`작업 프롬프트`}),_jsx(_components.th,{children:`답변 포맷 프롬프트`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`적용 시점`})}),_jsx(_components.td,{children:`에이전트가 도구를 사용하는 동안`}),_jsx(_components.td,{children:`최종 답변을 작성할 때`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`역할`})}),_jsx(_components.td,{children:`”무엇을 해야 하는가” (역할, 제한사항)`}),_jsx(_components.td,{children:`“어떻게 답해야 하는가” (마크다운, 표, 길이)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`포함할 내용`})}),_jsx(_components.td,{children:`역할 정의, 행동 규칙, 제한사항`}),_jsx(_components.td,{children:`출력 형식, 어조, 구조`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`포함하면 안 되는 것`})}),_jsx(_components.td,{children:`출력 형식 지정`}),_jsx(_components.td,{children:`역할 정의, 행동 규칙`})]})]})]}),_jsxs(_components.p,{children:[`분리하면 `,_jsx(_components.strong,{children:`역할은 유지하면서 출력 형식만 바꾸거나`}),`, 반대로 출력 형식은 유지하면서 역할만 변경할 수 있습니다.`]})]})]}),_jsxs(Step,{title:`프롬프트 제안 설정 (선택)`,children:[_jsx(_components.p,{children:`채팅 화면에서 에이전트를 선택했을 때 표시되는 대화 시작 제안 문구를 설정합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`옵션`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`기본값`})}),_jsx(_components.td,{children:`시스템 기본 제안 문구 사용`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`사용자 정의`})}),_jsx(_components.td,{children:`에이전트 용도에 맞는 제안 문구 직접 설정`})]})]})]}),_jsx(Tip,{children:_jsx(_components.p,{children:`에이전트 용도에 맞는 질문 예시를 제공하면 사용자가 빠르게 대화를 시작할 수 있습니다.\n예: “이번 달 매출 현황 요약해줘”, “SNS 게시물 초안 작성해줘”`})})]}),_jsxs(Step,{title:`지식기반 연결`,children:[_jsx(_components.p,{children:`에이전트가 참조할 문서를 연결합니다.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`“지식기반” 섹션에서 `,_jsx(_components.strong,{children:`“지식 기반 선택”`}),` 클릭`]}),`\n`,_jsx(_components.li,{children:`연결할 지식기반 선택 (여러 개 선택 가능)`}),`\n`]}),_jsx(_components.p,{children:`연결된 지식기반의 문서를 RAG로 검색하여 답변에 활용하며, 출처를 인용할 수 있습니다.`}),_jsx(Frame,{caption:`여러 지식기반을 연결하면 에이전트가 질문에 따라 적절한 KB를 자동 선택합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-knowledge.png?fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=736845b3af1f35aa496f1e99a3842680`,alt:`에이전트 지식기반 연결`,\"data-og-width\":`872`,width:`872`,\"data-og-height\":`678`,height:`678`,\"data-path\":`images/workspace/agents-knowledge.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-knowledge.png?w=280\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=68e31e7741fd429034b0804715efed3c 280w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-knowledge.png?w=560\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=e7fc1245402c910a925d60635f3c2a96 560w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-knowledge.png?w=840\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=2829dfe51a17ca475659b6a77761d5ee 840w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-knowledge.png?w=1100\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=12ec6d242802000a0aef93810313dcb9 1100w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-knowledge.png?w=1650\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=f7d9a47f58e35c0eef7e9494c4555d42 1650w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-knowledge.png?w=2500\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=29b8686339bca0d7cb422275eba01e54 2500w`})})]}),_jsxs(Step,{title:`데이터베이스 연결 (선택)`,children:[_jsxs(_components.p,{children:[`NL-to-SQL 기반 자연어 데이터 조회를 위해 `,_jsx(_components.a,{href:`/ko/workspace/database`,children:`데이터베이스(DbSphere)`}),`를 연결합니다.`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`“데이터베이스” 섹션에서 `,_jsx(_components.strong,{children:`“데이터베이스 선택”`}),` 클릭`]}),`\n`,_jsx(_components.li,{children:`연결할 데이터베이스 선택 (여러 개 선택 가능)`}),`\n`]}),_jsx(_components.p,{children:`연결된 데이터베이스에 대해 자연어로 질문하면 AI가 SQL을 생성하고 실행하여 결과를 반환합니다.`})]}),_jsxs(Step,{title:`용어집 연결 (선택)`,children:[_jsxs(_components.p,{children:[`에이전트가 조직의 비즈니스 용어를 이해할 수 있도록 `,_jsx(_components.a,{href:`/ko/workspace/glossary`,children:`용어집`}),`을 연결합니다.`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`“용어집” 섹션에서 `,_jsx(_components.strong,{children:`“용어집 선택”`}),` 클릭`]}),`\n`,_jsx(_components.li,{children:`연결할 용어집 선택 (여러 개 선택 가능)`}),`\n`]}),_jsx(_components.p,{children:`용어집에 등록된 용어의 정의, 동의어, 컨텍스트가 에이전트 응답에 반영됩니다.`})]}),_jsxs(Step,{title:`도구 연결 (선택)`,children:[_jsx(_components.p,{children:`외부 시스템과 연동할 도구를 연결합니다. “도구 연결” 섹션에서 MCP 서버 또는 OpenAPI 서버를 선택합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`도구 유형`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`OpenAPI 서버`})}),_jsx(_components.td,{children:`REST API를 통해 외부 서비스와 상호작용`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`MCP 서버`})}),_jsx(_components.td,{children:`Model Context Protocol 기반 도구 연동`})]})]})]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`연결한 도구의 `,_jsx(_components.strong,{children:`설명(description)이 비어있으면 편집기 상단에 경고 배너`}),`가 표시됩니다. 도구 설명은 LLM이 “언제 이 도구를 호출할지” 판단하는 핵심 근거이므로, 미작성 도구가 있으면 잘못된 호출 또는 미사용으로 이어질 수 있습니다. 배너가 보이면 해당 도구의 `,_jsx(_components.a,{href:`/ko/workspace/tools`,children:`도구 정의`}),`에서 설명을 보강하세요.`]})})]}),_jsxs(Step,{title:`기능 설정 (선택)`,children:[_jsxs(_components.p,{children:[`에이전트가 사용할 수 있는 고급 기능을 설정합니다. 각 기능은 `,_jsx(_components.strong,{children:`3가지 상태`}),`로 제어합니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`상태`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`제한됨`})}),_jsx(_components.td,{children:`채팅에서 기능을 완전히 숨김 (기본값)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`기본 활성화`})}),_jsx(_components.td,{children:`채팅 시작 시 기능이 자동 활성화, 사용자가 끌 수 있음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`기본 비활성화`})}),_jsx(_components.td,{children:`채팅에서 기능이 표시되지만 사용자가 직접 켜야 동작`})]})]})]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`기능`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`웹 검색`})}),_jsx(_components.td,{children:`실시간 웹 검색으로 최신 정보 조회. 결과 수와 도메인 필터 설정 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`이미지 생성`})}),_jsx(_components.td,{children:`AI 이미지 생성 엔진 연동. 사용할 연결을 선택 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Gmail`})}),_jsx(_components.td,{children:`사용자를 대신해 메일 조회·발송`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`구글 캘린더`})}),_jsx(_components.td,{children:`사용자를 대신해 일정 조회·등록`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Drive`})}),_jsx(_components.td,{children:`사용자를 대신해 파일 검색·Google 문서 생성`})]})]})]}),_jsxs(_components.p,{children:[`위 5개와 별개로, `,_jsx(_components.strong,{children:`답변 방식`}),`을 조정하는 설정 4가지가 같은 화면에 함께 있습니다. 이쪽은 3가지 상태가 아니라 개별 값을 가집니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`설정`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{style:{textAlign:`center`},children:`기본값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`추론 과정 표시`})}),_jsxs(_components.td,{children:[`답변 앞에 도구 호출(인자·결과)과 사고 과정을 접이식 블록으로 표시. `,_jsx(_components.code,{children:`간략`}),`(도구 이름만) · `,_jsx(_components.code,{children:`상세`}),`(실시간 추론 단계) · `,_jsx(_components.code,{children:`없음`}),` 중 선택`]}),_jsx(_components.td,{style:{textAlign:`center`},children:`간략`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`그라운딩`})}),_jsx(_components.td,{children:`답변을 연결된 데이터 소스(지식 기반·데이터베이스·도구) 범위로 제한. 끄면 소스가 질문을 덮지 못할 때 일반 지식으로 답합니다`}),_jsx(_components.td,{style:{textAlign:`center`},children:`켜짐`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`사용자에게 되묻기`})}),_jsx(_components.td,{children:`핵심 정보가 빠졌거나 요청이 모호할 때 버튼 또는 자유 입력으로 되묻습니다`}),_jsx(_components.td,{style:{textAlign:`center`},children:`꺼짐`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`문서 생성`})}),_jsx(_components.td,{children:`내장 도구로 PPT·Word·Excel 파일을 생성할 수 있게 합니다`}),_jsx(_components.td,{style:{textAlign:`center`},children:`꺼짐`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`그라운딩`}),`의 기본값은 화면에 따라 다릅니다. 에이전트 편집에서는 켜짐이지만, 기본 모델 편집에서는 꺼짐입니다.`]})}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Gmail·캘린더·Drive는 여기서 켜도 `,_jsx(_components.strong,{children:`사용자 본인이 설정 > 연결에서 Google 계정을 연결`}),`해야 채팅에 나타납니다. 코드 실행은 에이전트 기능 설정 항목이 아닙니다 — `,_jsx(_components.a,{href:`/ko/chat/capabilities`,children:`코드 실행`}),` 참고.`]})}),_jsx(Frame,{caption:`채팅 기능 5개는 3가지 상태로, 답변 방식 4개는 개별 값으로 설정합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/workspace/agents-capabilities.png?fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=2d9ed8f1367cb620f4756391a5477fe9`,alt:`에이전트 기능 설정`,\"data-og-width\":`1752`,width:`1752`,\"data-og-height\":`1560`,height:`1560`,\"data-path\":`images/workspace/agents-capabilities.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/workspace/agents-capabilities.png?w=280\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=f4b4521ed4b50c033054f852fabe900f 280w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/workspace/agents-capabilities.png?w=560\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=a1531931dab1d3f253d3242e143a20ad 560w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/workspace/agents-capabilities.png?w=840\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=6b56db9e140afb6ca1e1b017da5c21a8 840w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/workspace/agents-capabilities.png?w=1100\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=bb320db17ab6059ce398e717562c4a66 1100w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/workspace/agents-capabilities.png?w=1650\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=f7665b8896bee1cf01b6764021bfb95c 1650w, https://mintcdn.com/cloocus/E0pzkKQUX30iu2PY/images/workspace/agents-capabilities.png?w=2500\u0026fit=max\u0026auto=format\u0026n=E0pzkKQUX30iu2PY\u0026q=85\u0026s=32a429c245cc479a0a6108a269dcdff5 2500w`})})]}),_jsxs(Step,{title:`응답 형식 설정 (선택)`,children:[_jsxs(_components.p,{children:[`에이전트의 응답을 `,_jsx(_components.strong,{children:`구조화된 JSON 형식`}),`으로 제한할 수 있습니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`모드`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`채팅`})}),_jsx(_components.td,{children:`기본 자유형 텍스트 응답`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`구조화된 응답`})}),_jsx(_components.td,{children:`JSON Schema에 따른 구조화 응답 (Structured Output)`})]})]})]}),_jsx(_components.p,{children:`구조화된 응답 모드에서는 비주얼 필드 빌더 또는 Raw JSON 에디터로 응답 스키마를 정의할 수 있습니다.`}),_jsx(Frame,{caption:`구조화된 응답 모드에서 JSON Schema로 응답 구조를 정의합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-response-format.png?fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=2b0e19966d9f5df77bb1cad0789d361c`,alt:`응답 형식 설정`,\"data-og-width\":`882`,width:`882`,\"data-og-height\":`410`,height:`410`,\"data-path\":`images/workspace/agents-response-format.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-response-format.png?w=280\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=742ec666f985bf7826c4ca7f45916827 280w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-response-format.png?w=560\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=f0447f8f2d7a8853eb525e77d646168d 560w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-response-format.png?w=840\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=b52917aba451e23b29628046768649c7 840w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-response-format.png?w=1100\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=dd702e3e49a0cc19496437bde89e4dd5 1100w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-response-format.png?w=1650\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=bb104dba39e49870610635211406c87a 1650w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-response-format.png?w=2500\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=1cf13e52d0ea1311f2605f5e7acd4a01 2500w`})})]}),_jsxs(Step,{title:`가드레일 설정 (선택)`,children:[_jsx(_components.p,{children:`에이전트에 보안 가드레일을 연결하여 입출력을 검증합니다.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`개인정보(PII) 자동 탐지 및 마스킹`}),`\n`,_jsx(_components.li,{children:`커스텀 패턴 필터링`}),`\n`,_jsx(_components.li,{children:`금지 단어 차단`}),`\n`,_jsx(_components.li,{children:`LLM 기반 콘텐츠 검증`}),`\n`]})]}),_jsxs(Step,{title:`자동 평가 설정 (선택)`,children:[_jsx(_components.p,{children:`에이전트 응답 품질을 자동으로 모니터링합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`설정`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`심사 모델`})}),_jsx(_components.td,{children:`평가에 사용할 LLM 선택`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`샘플링 비율`})}),_jsx(_components.td,{children:`평가할 응답 비율 (1%~100%)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`평가 유형`})}),_jsx(_components.td,{children:`검색 품질, 충실도, 응답 품질 중 선택`})]})]})]}),_jsx(Accordion,{title:`평가 유형 상세`,id:`-2`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`검색 품질 (Retrieval Quality)`})}),_jsx(_components.td,{children:`지식기반에서 검색된 문서의 관련성 평가`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`충실도 (Faithfulness)`})}),_jsx(_components.td,{children:`응답이 검색된 내용에 충실한지, 환각이 없는지 평가`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`응답 품질 (Response Quality)`})}),_jsx(_components.td,{children:`응답의 전반적인 품질, 유용성, 정확성 평가`})]})]})]})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`샘플링 비율 권장:`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`상황`}),_jsx(_components.th,{style:{textAlign:`center`},children:`권장 비율`}),_jsx(_components.th,{children:`이유`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`신규 에이전트 (검증 단계)`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`50~100%`}),_jsx(_components.td,{children:`초기 품질 파악 필요`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`안정화된 에이전트`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`5~10%`}),_jsx(_components.td,{children:`비용 절감하면서 모니터링`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`핵심 업무 에이전트`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`20~30%`}),_jsx(_components.td,{children:`지속적 품질 보증 필요`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`검색 품질`}),`과 `,_jsx(_components.strong,{children:`충실도`}),` 평가는 지식기반(KB) 검색 결과가 있을 때만 실행됩니다. KB가 연결되지 않은 에이전트에서는 `,_jsx(_components.strong,{children:`응답 품질`}),`만 선택하세요.`]})}),_jsx(Frame,{caption:`자동 평가를 활성화하면 응답 품질을 지속적으로 모니터링할 수 있습니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-auto-eval.png?fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=aff4b6c9454bf6e8425f5ff3908347f9`,alt:`자동 평가 설정`,\"data-og-width\":`888`,width:`888`,\"data-og-height\":`595`,height:`595`,\"data-path\":`images/workspace/agents-auto-eval.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-auto-eval.png?w=280\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=8f802b7629deb968dde294667bc02576 280w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-auto-eval.png?w=560\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=98b0e65a5173d68cce9ae56854266d04 560w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-auto-eval.png?w=840\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=2b1944a8fbfd2848a72525ca34ca0abd 840w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-auto-eval.png?w=1100\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=84535c2084fca79b179bd183eda49479 1100w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-auto-eval.png?w=1650\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=0429faf55eef3b1965e295748a58ddce 1650w, https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/workspace/agents-auto-eval.png?w=2500\u0026fit=max\u0026auto=format\u0026n=T-uIm14J0Tjpsr6L\u0026q=85\u0026s=cc88d26a5df756e19d2b10af673357fb 2500w`})})]}),_jsxs(Step,{title:`접근 권한 설정`,children:[_jsx(_components.p,{children:`에이전트 사용 권한을 설정합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`옵션`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`공개`})}),_jsx(_components.td,{children:`모든 사용자가 사용 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`비공개`})}),_jsx(_components.td,{children:`본인만 사용 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`그룹 지정`})}),_jsx(_components.td,{children:`지정한 그룹의 구성원만 사용 가능`})]})]})]}),_jsx(Frame,{caption:`접근 제어 모달 — 그룹을 검색해 추가하고 행마다 편집 가능 여부를 지정합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/agents-access-control.png?fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=363f7471141da057dab7a85089c98a3e`,alt:`접근 권한 설정`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/agents-access-control.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/agents-access-control.png?w=280\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=f27da04cd825b54c7fd328183ef13f23 280w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/agents-access-control.png?w=560\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=7c2293c1cfc4d1859fcd1f32ed32afef 560w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/agents-access-control.png?w=840\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=d472d02b2893e1223c15d4c0ab33d57a 840w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/agents-access-control.png?w=1100\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=66fef394786425be46a99a6b8495fab3 1100w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/agents-access-control.png?w=1650\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=dc8877e8b40a211838578d83072a9666 1650w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/agents-access-control.png?w=2500\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=43a8eb54af2603598c8153ae28a52da0 2500w`})})]}),_jsx(Step,{title:`저장`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`“저장 및 생성”`}),` 버튼을 클릭하여 에이전트를 생성합니다.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`에이전트-사용`,children:`에이전트 사용`}),`\n`,_jsx(Heading,{level:`3`,id:`채팅에서-선택`,children:`채팅에서 선택`}),`\n`,_jsx(_components.p,{children:`채팅 화면 상단의 모델 선택 드롭다운에서 에이전트를 선택합니다. 에이전트는 일반 모델과 함께 목록에 표시됩니다.`}),`\n`,_jsx(Heading,{level:`3`,id:`@-명령어로-호출`,children:`@ 명령어로 호출`}),`\n`,_jsxs(_components.p,{children:[`채팅 중 `,_jsx(_components.code,{children:`@에이전트이름`}),`으로 특정 에이전트를 호출할 수 있습니다.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`@마케팅어시스턴트 이번 달 프로모션 SNS 게시물 5개 작성해줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`에이전트-관리`,children:`에이전트 관리`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`작업`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`활성/비활성`})}),_jsx(_components.td,{children:`에이전트 카드의 토글 스위치로 활성화/비활성화. 비활성 에이전트는 채팅에서 선택할 수 없습니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`편집`})}),_jsx(_components.td,{children:`에이전트 카드를 클릭하여 설정 수정`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`복제`})}),_jsx(_components.td,{children:`기존 에이전트를 복사하여 새 에이전트 빠르게 생성`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`내보내기/가져오기`})}),_jsx(_components.td,{children:`JSON 파일로 에이전트 설정 백업 및 환경 간 이동`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`삭제`})}),_jsx(_components.td,{children:`에이전트 영구 삭제 (복구 불가)`})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`내보내기/가져오기를 활용하면 개발 환경에서 생성한 에이전트를 운영 환경으로 이동할 수 있습니다.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`활용-시나리오`,children:`활용 시나리오`}),`\n`,_jsxs(_components.p,{children:[`추상적인 기능 설명이 아니라 `,_jsx(_components.strong,{children:`실제 운영에서 나오는 상황 → 어떻게 구성하는지`}),`의 패턴을 모았습니다. 비슷한 상황이 있다면 그대로 시작점으로 쓰세요.`]}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`HR 어시스턴트 — 인사규정 Q\u0026A`,icon:`user-tie`,id:`hr-q-and-a`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`상황`}),`: 연차·복리후생·취업규칙 같은 반복 문의가 HR팀에 몰린다. 답변 출처(규정 몇 조)도 같이 줘야 신뢰가 생긴다.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`구성`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{children:`값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`기반 모델`}),_jsx(_components.td,{children:`GPT-4o-mini (저비용, 사실 위주 응답에 충분)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`지식기반`}),_jsx(_components.td,{children:`인사규정, 복리후생 안내 PDF`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`시스템 프롬프트`}),_jsx(_components.td,{children:`”HR 전문가. 답변 끝에 항상 출처 조항 표기. 추측 금지”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`가드레일`}),_jsx(_components.td,{children:`출력 PII 마스킹 (직원 식별 정보 차단)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`권한`}),_jsx(_components.td,{children:`비공개 / 전사 그룹에 Read`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`만드는 순서`}),`: 지식기반 생성 → PDF 업로드 → 에이전트 생성 → KB 연결 → 시스템 프롬프트 작성 → 가드레일 연결 → 전사 공개`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`흔한 함정`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`KB에 너무 많은 문서를 넣으면 검색 정확도 ↓ → HR 도메인만 분리`}),`\n`,_jsx(_components.li,{children:`“출처 표기” 지시가 없으면 LLM이 임의 답변 → 시스템 프롬프트에 명시 필요`}),`\n`]})]}),_jsxs(Accordion,{title:`코드 리뷰어 — 사내 컨벤션 기반`,icon:`code`,id:`-3`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`상황`}),`: 팀마다 코딩 규칙(네이밍, 에러 처리, 린트)이 다른데 신입이 매번 슬랙으로 묻는다.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`구성`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{children:`값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`기반 모델`}),_jsx(_components.td,{children:`Claude Sonnet 4.x (코드 컨텍스트 이해 강함)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`지식기반`}),_jsx(_components.td,{children:`코딩 가이드라인 wiki, API 레퍼런스`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`시스템 프롬프트`}),_jsx(_components.td,{children:`”리뷰는 [개선]/[양호]/[질문] 3태그로. 가이드라인 절 번호 인용”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`도구`}),_jsx(_components.td,{children:`없음 (사내망 코드 직접 접근은 별도 MCP 서버로 분리 권장)`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`만드는 순서`}),`: 가이드라인을 KB로 정리 → 에이전트 생성 → “@code-reviewer” 핸들 부여 → 채팅에서 `,_jsx(_components.code,{children:`@code-reviewer 이 함수 리뷰해줘`}),` 호출`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`흔한 함정`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`가이드라인이 outdated면 잘못된 리뷰 → KB sync 주기 설정 필수`}),`\n`,_jsx(_components.li,{children:`코드 전체를 채팅에 붙여넣으면 토큰 폭증 → 함수 단위 리뷰로 유도`}),`\n`]})]}),_jsxs(Accordion,{title:`데이터 분석가 — DB 연결 + 데이터 딕셔너리`,icon:`chart-line`,id:`db`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`상황`}),`: “이번 달 매출 TOP 5” 같은 질문에 BI 팀이 매번 SQL을 짜준다. 비기술자도 자연어로 물을 수 있게.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`구성`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{children:`값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`기반 모델`}),_jsx(_components.td,{children:`GPT-4o (SQL 생성·표 렌더링 안정)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`데이터베이스`}),_jsx(_components.td,{children:`DbSphere에서 매출 DB 연결`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`지식기반`}),_jsx(_components.td,{children:`데이터 딕셔너리 (테이블/컬럼 의미 사전)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`시스템 프롬프트`}),_jsx(_components.td,{children:`”쿼리 결과는 표로. 데이터 소스 테이블명 표기”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`가드레일`}),_jsx(_components.td,{children:`입력 SQL injection 패턴 차단`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`만드는 순서`}),`: DbSphere에서 DB 등록 + 스키마 추출 → 데이터 딕셔너리 KB 작성 → 에이전트 생성 → DB + KB 연결`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`흔한 함정`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`스키마 추출 안 하면 LLM이 컬럼명 추측 → 잘못된 SQL → DbSphere에서 추출 우선`}),`\n`,_jsx(_components.li,{children:`큰 테이블 전체 SELECT는 비용 폭증 → 시스템 프롬프트에 LIMIT 강제`}),`\n`,_jsx(_components.li,{children:`민감 컬럼(salary 등)은 DB 연결 시 컬럼 단위 차단 설정 활용`}),`\n`]})]}),_jsxs(Accordion,{title:`고객 지원 임베드 — 외부 사이트에 노출`,icon:`headset`,id:`-4`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`상황`}),`: 제품 사이트에 챗봇을 임베드해 비로그인 방문자도 FAQ를 묻게 하고 싶다. 단, 회사 내부 정보는 절대 노출되면 안 된다.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`구성`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{children:`값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`기반 모델`}),_jsx(_components.td,{children:`GPT-4o-mini (저비용, 외부 트래픽 대응)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`지식기반`}),_jsx(_components.td,{children:`공개 FAQ, 제품 매뉴얼만 (내부 문서 제외)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`시스템 프롬프트`}),_jsx(_components.td,{children:`”회사 내부 정보·가격 정책 추측 금지. 모르면 ‘담당자 문의’ 안내”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`가드레일`}),_jsx(_components.td,{children:`출력 PII / 내부 코드명 / 미공개 가격 차단`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`임베드 위젯`}),_jsx(_components.td,{children:`게스트 모드 ON, side-bottom 배치`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`만드는 순서`}),`: 공개 KB 분리 → 가드레일 정책 작성 → 에이전트 생성 (공개 권한) → `,_jsx(_components.a,{href:`/ko/admin/settings/embed-widgets`,children:`임베드 위젯`}),`에서 이 에이전트 선택 → 게스트 모드 활성화`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`흔한 함정`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`내부 KB와 공개 KB를 분리 안 하면 답변에 내부 정보 노출 → KB 자체를 분리해야 안전`}),`\n`,_jsx(_components.li,{children:`가드레일은 출력 검증, KB 분리는 정보 격리 — 둘 다 필요`}),`\n`]})]}),_jsxs(Accordion,{title:`회의록 요약기 — 최소 구성`,icon:`file-lines`,id:`-5`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`상황`}),`: 매주 회의록을 요약해 슬랙으로 공유. KB나 도구 없이 단순 가공만.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`구성`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{children:`값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`기반 모델`}),_jsx(_components.td,{children:`Claude Sonnet 4.x`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`지식기반`}),_jsx(_components.td,{children:`없음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`시스템 프롬프트`}),_jsx(_components.td,{children:`”회의록을 받으면 1) 결정사항 2) 액션 아이템(담당자/마감) 3) 다음 안건으로 정리”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`도구`}),_jsx(_components.td,{children:`없음`})]})]})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`만드는 순서`}),`: 에이전트 생성 → 시스템 프롬프트만 작성 → 채팅에 회의록 붙여넣기`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`언제 이걸로 충분한가`}),`: KB·도구·가드레일 없는 “프롬프트 + 모델”만 묶고 싶을 때. 5분 안에 만든다. 더 단순하면 `,_jsx(_components.a,{href:`/ko/workspace/prompts`,children:`프롬프트`}),` 기능으로 충분할 수도 있음.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`베스트-프랙티스`,children:`베스트 프랙티스`}),`\n`,_jsx(Heading,{level:`3`,id:`프롬프트-작성`,children:`프롬프트 작성`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`역할을 명확히 정의하세요`}),` — “당신은 Cloocus 마케팅팀의 콘텐츠 전문가입니다”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`구체적인 지침을 제공하세요`}),` — 응답 언어, 길이, 인용 규칙 등`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`제한사항을 설정하세요`}),` — 경쟁사 비방 금지, 개인정보 노출 금지 등`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`지식기반-연결`,children:`지식기반 연결`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`관련 문서만 연결`}),`: 너무 많은 문서는 오히려 검색 정확도를 저하시킵니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`최신 문서 유지`}),`: 오래된 정보는 정기적으로 업데이트하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`도구 설명 작성`}),`: 지식기반의 도구 설명을 구체적으로 작성하면 에이전트가 적절한 KB를 선택하는 정확도가 높아집니다`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`접근-권한`,children:`접근 권한`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`최소 권한 원칙`}),`: 필요한 사람에게만 접근 권한을 부여하세요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`그룹 관리`}),`: 개별 사용자보다 그룹 단위로 관리하면 효율적입니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`정기 검토`}),`: 권한 설정을 주기적으로 점검하세요`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`에이전트와 기본 모델의 차이점은?`,icon:`circle-question`,id:`-6`,children:_jsx(_components.p,{children:`에이전트는 기본 모델에 지식기반, 도구, 시스템 프롬프트, 가드레일을 추가하여 특정 업무에 최적화한 것입니다. 기본 모델은 범용 대화에, 에이전트는 업무 특화 대화에 적합합니다.`})}),_jsx(Accordion,{title:`한 에이전트에 여러 지식기반을 연결할 수 있나요?`,icon:`circle-question`,id:`-7`,children:_jsxs(_components.p,{children:[`네, 여러 지식기반과 데이터베이스를 동시에 연결할 수 있습니다. 에이전트는 질문에 따라 적절한 리소스를 자동으로 선택합니다. 지식기반마다 `,_jsx(_components.strong,{children:`도구 설명`}),`(Tool Description)을 구체적으로 작성하면 선택 정확도가 높아집니다.`]})}),_jsxs(Accordion,{title:`웹 검색/이미지 생성/Google Workspace가 동작하지 않습니다.`,icon:`triangle-exclamation`,id:`google-workspace`,children:[_jsx(_components.p,{children:`에이전트 기능 설정의 상태를 확인하세요:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`제한됨`}),`: 채팅에서 기능이 완전히 숨겨집니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`기본 비활성화`}),`: 채팅 입력창에서 사용자가 직접 켜야 합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`기본 활성화`}),`: 자동 활성화되며, 이 상태에서도 동작하지 않으면 관리자 설정(웹 검색/이미지 생성 연결)을 확인하세요`]}),`\n`]}),_jsxs(_components.p,{children:[`Gmail·캘린더·Drive는 여기에 더해 `,_jsx(_components.strong,{children:`사용자 본인의 Google 계정 연결`}),`과 소속 그룹의 권한이 모두 있어야 채팅에 나타납니다.`]})]}),_jsx(Accordion,{title:`에이전트 사용량도 추적되나요?`,icon:`circle-question`,id:`-8`,children:_jsx(_components.p,{children:`네, 모니터링 대시보드에서 에이전트별 사용량, 토큰 소비량, 자동 평가 결과를 확인할 수 있습니다.`})}),_jsx(Accordion,{title:`에이전트를 다른 환경으로 옮길 수 있나요?`,icon:`circle-question`,id:`-9`,children:_jsxs(_components.p,{children:[`네, `,_jsx(_components.strong,{children:`내보내기`}),`(Export) 기능으로 JSON 파일을 다운로드한 뒤 다른 환경에서 `,_jsx(_components.strong,{children:`가져오기`}),`(Import)하면 됩니다. 단, 연결된 지식기반·도구·가드레일은 대상 환경에 별도로 설정해야 합니다.`]})}),_jsx(Accordion,{title:`에이전트를 숨길 수 있나요?`,icon:`circle-question`,id:`-10`,children:_jsxs(_components.p,{children:[`네, 에이전트 카드의 우측 상단 토글 조작을 통하여 상태를 `,_jsx(_components.strong,{children:`제한됨`}),`으로 변경하면 채팅 모델 선택 목록에서 숨겨집니다. 에이전트가 삭제되는 것이 아니며, 다시 표시할 수 있습니다.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`관련-페이지`,children:`관련 페이지`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`지식기반`,icon:`database`,href:`/ko/workspace/knowledge`,children:_jsx(_components.p,{children:`에이전트에 연결할 문서 기반 지식 저장소`})}),_jsx(Card,{title:`가드레일`,icon:`shield-check`,href:`/ko/workspace/guardrails`,children:_jsx(_components.p,{children:`에이전트 입출력 보안 검증`})}),_jsx(Card,{title:`도구`,icon:`wrench`,href:`/ko/workspace/tools`,children:_jsx(_components.p,{children:`OpenAPI / MCP 외부 서비스 연동`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"에이전트","description":"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리","href":"/ko/workspace/agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"예시","slug":"예시","depth":3,"children":[]},{"title":"에이전트 처리 파이프라인","slug":"에이전트-처리-파이프라인","depth":2,"children":[]},{"title":"어떤 걸 써야 할까?","slug":"어떤-걸-써야-할까","depth":2,"children":[]},{"title":"에이전트 생성","slug":"에이전트-생성","depth":2,"children":[]},{"title":"에이전트 사용","slug":"에이전트-사용","depth":2,"children":[{"title":"채팅에서 선택","slug":"채팅에서-선택","depth":3,"children":[]},{"title":"@ 명령어로 호출","slug":"@-명령어로-호출","depth":3,"children":[]}]},{"title":"에이전트 관리","slug":"에이전트-관리","depth":2,"children":[]},{"title":"활용 시나리오","slug":"활용-시나리오","depth":2,"children":[]},{"title":"베스트 프랙티스","slug":"베스트-프랙티스","depth":2,"children":[{"title":"프롬프트 작성","slug":"프롬프트-작성","depth":3,"children":[]},{"title":"지식기반 연결","slug":"지식기반-연결","depth":3,"children":[]},{"title":"접근 권한","slug":"접근-권한","depth":3,"children":[]}]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"관련 페이지","slug":"관련-페이지","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"에이전트 - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/agents","matchLevel":0},"en":{"href":"/en/workspace/agents","matchLevel":1}}},"lastModified":"2026-08-24T04:54:39.174Z","originalFileLocation":"ko/workspace/agents.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"에이전트 - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/ko/workspace/agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8\u0026amp;title=%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8\u0026amp;description=%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98%2C+%EB%8F%84%EA%B5%AC%2C+%EA%B0%80%EB%93%9C%EB%A0%88%EC%9D%BC%EC%9D%84+%EA%B2%B0%ED%95%A9%ED%95%9C+%EB%A7%9E%EC%B6%A4%ED%98%95+AI+%EC%96%B4%EC%8B%9C%EC%8A%A4%ED%84%B4%ED%8A%B8+%EC%83%9D%EC%84%B1+%EB%B0%8F+%EA%B4%80%EB%A6%AC\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=409e0ebbde9d722126a5c992f5bc360b776582d3cc8b2ba5b50a5bed6f0e7f64\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"에이전트 - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8\u0026amp;title=%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8\u0026amp;description=%EC%A7%80%EC%8B%9D%EA%B8%B0%EB%B0%98%2C+%EB%8F%84%EA%B5%AC%2C+%EA%B0%80%EB%93%9C%EB%A0%88%EC%9D%BC%EC%9D%84+%EA%B2%B0%ED%95%A9%ED%95%9C+%EB%A7%9E%EC%B6%A4%ED%98%95+AI+%EC%96%B4%EC%8B%9C%EC%8A%A4%ED%84%B4%ED%8A%B8+%EC%83%9D%EC%84%B1+%EB%B0%8F+%EA%B4%80%EB%A6%AC\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=409e0ebbde9d722126a5c992f5bc360b776582d3cc8b2ba5b50a5bed6f0e7f64\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/ko/workspace/agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/workspace/agents.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/agents\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/agents\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/agents\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/agents#webpage\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/agents\",\"name\":\"에이전트\",\"description\":\"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리\",\"dateModified\":\"2026-08-24T04:54:39.174Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloosphere Guide\",\"item\":\"https://docs.cloosphere.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"에이전트\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/ko/workspace/agents#article\",\"headline\":\"에이전트\",\"name\":\"에이전트\",\"description\":\"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/agents#webpage\"},\"dateModified\":\"2026-08-24T04:54:39.174Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/workspace/agents.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"시작하기","icon":"rocket","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"채팅","icon":"comments","pages":[{"title":"채팅","href":"/ko/chat/overview"}]},{"tab":"워크스페이스","icon":"briefcase","groups":[{"group":"워크스페이스","pages":[{"title":"워크스페이스 개요","description":"에이전트, 지식기반, 데이터베이스 등 AI 업무 환경을 구성하는 워크스페이스 기능 안내","href":"/ko/workspace/overview"}]},{"group":"AI 에이전트","pages":[{"title":"에이전트","href":"/ko/workspace/agents"},{"title":"에이전트 플로우","description":"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더","href":"/ko/workspace/flows"},{"title":"플로우 노드 레퍼런스","href":"/ko/workspace/flows-nodes"}]},{"group":"지식 \u0026 데이터","pages":[{"title":"지식기반","href":"/ko/workspace/knowledge"},{"title":"동적 필터 상세 가이드","href":"/ko/workspace/knowledge-filters"},{"title":"지식 그래프","href":"/ko/workspace/knowledge-graph"},{"title":"데이터베이스","href":"/ko/workspace/database"},{"title":"용어집","href":"/ko/workspace/glossary"}]},{"group":"안전","pages":[{"title":"가드레일","href":"/ko/workspace/guardrails"}]},{"group":"커스터마이징","pages":[{"title":"프롬프트","href":"/ko/workspace/prompts"},{"title":"스킬","href":"/ko/workspace/skills"},{"title":"도구","href":"/ko/workspace/tools"},{"title":"마켓플레이스","href":"/ko/workspace/marketplace"},{"title":"태그","href":"/ko/workspace/tags"}]}]},{"tab":"협업","icon":"users","pages":[{"title":"협업","href":"/ko/collaboration/overview"}]},{"tab":"자동화","icon":"clock","pages":[{"title":"자동화","href":"/ko/automation/overview"}]},{"tab":"관리자","icon":"gear","pages":[{"title":"관리자","href":"/ko/admin/overview"}]},{"tab":"모니터링","icon":"chart-line","pages":[{"title":"모니터링","href":"/ko/monitoring/overview"}]},{"tab":"운영 · 지원","icon":"screwdriver-wrench","pages":[{"title":"운영 · 지원","href":"/ko/admin/deployment-checklist"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/workspace/agents"}]}]},"basePath":"","title":"에이전트 - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}