스킬과 에이전트 빌더

에이전트의 능력을 확장하고 커스텀하는 방법

Teeem AI의 에이전트는 스킬(Skill) 단위로 능력이 구성됩니다. 표준 스킬 라이브러리가 기본 탑재되어 있고, 조직 고유의 작업은 에이전트 빌더로 추가하거나 시스템이 자동 제안합니다.

​

스킬이란

스킬은 에이전트가 수행할 수 있는 하나의 작업 단위입니다. 예:

• 주간 매출 보고서 생성
• 견적서 PDF 만들기
• 거래처 문의 메일 초안 작성
• 데이터 차트 그리기
• 외부 API 조회

각 스킬은 트리거(어떤 요청에 반응할지), 입력(필요한 정보), 동작(도구 조합), 출력(결과 형식)을 정의합니다.

​

자동 스킬 제안 (Proactive Skill Generation)

직원들이 같은 작업을 반복적으로 수행하면 시스템이 이를 감지해 새 스킬을 제안합니다.

매주 월요일 오전 9시 (KST)
  ↓
1. 지난 7일간 Slack 대화 + 도구 실행 로그 수집
  ↓
2. Gemini로 반복 패턴 분석 → 후보 스킬 5개 추출
  ↓
3. 중복 검증 (기존 도구·스킬과 키워드 + LLM 의미 비교)
  ↓
4. 관리자 Slack DM에 [승인] [거절] 버튼 표시
  ↓
5. 승인 시 자동 활성화 (재배포 불필요)

중복 방지: 90일 쿨다운 (한번 거절한 패턴은 90일간 다시 제안되지 않음). 기존 스킬과 시맨틱하게 유사하면 자동 폐기.

​

에이전트 빌더

/admin/agents/* 경로에서 접근하는 에이전트 빌더 UI로 다음을 할 수 있습니다.

에이전트 정의

역할, 톤, 행동 규칙, 시스템 프롬프트 편집.

스킬 추가

템플릿에서 새 스킬 생성 또는 기존 스킬 복제·수정.

도구 활성화

표준 도구 라이브러리에서 이 에이전트가 사용할 도구 선택.

실시간 테스트

빌더 안에서 에이전트와 채팅하며 동작 확인. 배포 없이 반복.

​

표준 도구 라이브러리

에이전트가 즉시 쓸 수 있는 내장 도구 카테고리:

카테고리	예시 도구
파일	엑셀·CSV·PDF·HWP·PPTX·DOCX 파싱·생성, 차트·다이어그램·바코드 그리기
검색	웹 검색, 네이버 검색, URL 페치, YouTube 자막, 사내 비즈니스 컨텍스트
이메일	일반 메일 발송, 개인 Gmail 읽기·발송 (OAuth)
Google Workspace	Drive, Calendar, Gmail (개인 OAuth + 서비스 계정)
Microsoft 365	OneDrive, Outlook, Teams, Calendar
ERP·그룹웨어	더존, 위하고 (작업·결재·메시징)
이커머스	Cafe24, 네이버 스마트스토어
세무·신원확인	홈택스, NICE, 관세청
노션	페이지·DB 조회·수정
브라우저 자동화	Browserbase 기반 스텔스 브라우징 (봇 탐지 우회, 접근성 트리 ref 상호작용)
워크플로우	수요·매출 예측, 임계치 모니터링·알림, 주간 보고서 템플릿, 컴플라이언스 검토
메모리·검색	채널 히스토리, 비즈니스 컨텍스트 BM25 검색
OpenAPI	외부 API의 OpenAPI 스펙에서 도구 자동 생성

전체 도구 카탈로그는 관리자 콘솔의 도구 페이지에서 확인할 수 있습니다.

​

플래닝 모드

복잡한 작업(웹사이트 만들기, 보고서 생성, 커넥터 설정 등)은 에이전트가 먼저 질문해서 요구사항을 확인합니다. 플래닝 스킬은 다음과 같이 동작합니다.

사용자: "주간 매출 보고서 만들어줘"
  ↓
에이전트: "어떤 기간을 기준으로 할까요? (지난 주 / 이번 달 / 사용자 지정)"
사용자: "지난 주"
에이전트: "출력 형식은 PPTX, PDF, 엑셀 중 어느 것이 좋으신가요?"
사용자: "PPTX"
  ↓
[에이전트가 데이터를 모으고 차트와 함께 보고서 생성]

이 모드는 잘못된 입력으로 긴 작업이 실패하는 것을 방지합니다.

​

컨텍스트 효율화

대화가 길어져도 비용과 응답 품질을 유지하기 위한 자동 최적화:

• Observation Masking — 3턴 이상 오래된 도구 출력은 압축 요약으로 교체 (~30–40% 토큰 절감)
• Compaction — 컨텍스트 윈도우의 70% 도달 시 자동 요약
• Prompt Cache — 시스템 프롬프트와 도구 정의는 LLM 측에 캐시되어 비용 75% 절감
• Context Compression Phase — 채널 명령 처리 단계에서 추가 압축 적용

​

신뢰도 게이트 (Confidence Gate)

에이전트가 답변의 신뢰도가 낮다고 판단하면 명확화 질문을 먼저 합니다.

사용자: "그거 어떻게 됐어?"
  ↓
[신뢰도 0.20 미만 → 명확화 모드]
  ↓
에이전트: "어떤 작업을 말씀하시는 건가요? 어제 요청하신 보고서? 지난주 견적서? 다른 건가요?"

이 게이트는 환각(hallucination)을 줄이는 핵심 장치이며 모든 활성 조직에 기본 적용됩니다.