이 문서는 Agent Bricks 섹션의 일부입니다.
Knowledge Assistant 베스트 프랙티스
문서 준비
청크 사이즈와 검색 품질
Vector Search Index가 문서를 청크 단위로 분할합니다. 기본 설정으로 시작하되, 다음을 참고하세요.- 짧은 FAQ 문서: 작은 청크 사이즈가 유리 (개별 질문-답변 쌍이 잘 분리됨)
- 긴 기술 문서: 큰 청크 사이즈가 유리 (문맥이 유지됨)
- 오버랩(overlap): 청크 간 겹침을 두면 문맥 손실을 줄일 수 있음
인스트럭션 작성
참고 인스트럭션 예시: “반드시 한국어로 응답하세요. 답변에는 출처 문서명과 페이지를 인용하세요. 문서에 없는 내용은 ‘해당 정보를 찾을 수 없습니다’라고 답하세요.”
Genie Spaces 베스트 프랙티스
테이블 설계
SQL 표현식 활용
재사용 가능한 SQL 표현식을 Knowledge Store에 등록하면 정확도가 크게 향상됩니다.Supervisor Agent 베스트 프랙티스
서브 에이전트 설계
라우팅 로직 최적화
Supervisor는 서브 에이전트의 Description 을 기반으로 라우팅합니다. 다음을 지켜주세요.- 겹치지 않는 역할 정의: 서브 에이전트 간 책임이 겹치면 라우팅이 혼란스러워집니다
- 명확한 키워드 포함: Description에 해당 에이전트가 처리할 질문 유형의 키워드를 포함
- 폴백 에이전트 설정: 어떤 에이전트에도 해당하지 않는 질문을 처리할 일반 에이전트 배치
주의 서브 에이전트가 7개 이상 이면 라우팅 정확도가 눈에 띄게 떨어집니다. 역할이 비슷한 에이전트는 하나로 통합하세요.
공통 권장사항
평가 루프
- 반복적 개선: 배포 후에도 Examples 탭에서 지속적으로 피드백을 수집하고 가이드라인을 업데이트
- 체계적 평가: AI Judge + Synthetic Task Generation으로 정기적 품질 측정
- SME 리뷰: 도메인 전문가(Subject Matter Expert)에게 공유 링크를 전달하여 정기 리뷰 수행
모니터링
- 트레이싱 활성화: Production Monitoring for MLflow를 활성화하여 실행 과정 추적
- 응답 지연 모니터링: 엔드포인트 응답 시간이 10초를 초과하면 최적화 필요
- 오류율 추적: 실패한 쿼리 비율이 5% 이상이면 즉시 원인 분석
비용 관리
권한 및 보안
- 권한 최소화: 필요한 사용자에게만 최소한의 권한 부여
- Unity Catalog 활용: 데이터 접근 권한을 UC로 일원화
- 리전 확인: 현재
us-east-1또는us-west-2에서만 사용 가능
Anti-patterns: 흔한 실수 5가지
위험 다음은 Agent Bricks를 사용할 때 자주 발생하는 실수입니다. 반드시 피하세요.
프로덕션 운영 노하우
안정적인 프로덕션 운영을 위한 체크리스트
Agent Bricks를 프로덕션에 배포한 후 안정적으로 운영하기 위해 아래 항목을 점검하세요.운영 단계별 안정화 전략
Knowledge Source 업데이트 전략
프로덕션 환경에서 문서나 데이터가 변경될 때의 대응 전략입니다.비용 최적화
Agent Bricks의 비용은 크게 Foundation Model 호출 비용, Serverless Compute 비용, Vector Search 비용 으로 나뉩니다.비용 구조 이해
비용 절감 전략
비용 모니터링 대시보드 설정
다음 메트릭을 추적하는 대시보드를 구축하세요.참고 비용 최적화 팁: Agent Bricks의 자동 최적화 기능은 더 효율적인 모델을 자동으로 선택합니다. 즉, 시간이 지남에 따라 동일한 품질을 더 저렴한 모델로 달성할 수 있게 되어 비용이 자연스럽게 감소할 수 있습니다.
모니터링 설정
필수 모니터링 항목
알림 설정 방법
Databricks SQL Alert 활용:장애 대응 패턴
일반적인 장애 유형과 대응
장애 대응 플레이북
롤백 전략
주의 버전 관리의 중요성: Agent Bricks는 현재 Instructions, Description 등의 텍스트 설정에 대한 내장 버전 관리를 제공하지 않습니다. 중요한 설정 변경 전에 반드시 현재 설정을 별도로 백업(텍스트 파일, Confluence 등)해두세요. SDK를 통해 설정을 조회하고 저장하는 스크립트를 만들어 두면 롤백이 훨씬 수월합니다.
추가 Anti-patterns: 운영 단계의 실수
위험 배포 이후 운영 단계에서 자주 발생하는 추가 실수입니다.