CRMAI Docs에이전트 도구
목적
"Manage which tools this agent can use. Tools with a level above the agent's autonomy level require human approval." 에이전트가 호출할 수 있는 각 도구는 필요한 Level과 함께 목록으로 표시됩니다. 실제로 사용 가능한지는 Governance에서 설정된 에이전트의 Authority Limit Level에 따라 결정됩니다.
사용 가능한 도구
도구 | 레벨 | 기능 |
|---|---|---|
Tag Customer | 4 | 현재 고객에게 태그를 추가합니다. tagName과 existingTagId를 모두 제공하고, 사용하지 않는 필드는 null로 설정합니다. |
Fill Customer Data | 4 | 대화에서 추출된 세부 정보로 현재 고객 프로필을 업데이트합니다. name, email, company를 제공하고, 변경하고 싶지 않은 필드에는 null을 사용합니다. |
Route Ticket | 7 | 현재 티켓을 다른 에이전트 및/또는 대기열로 재배정합니다. targetUserId와 targetQueueId를 제공하고, 사용하지 않는 쪽은 null로 설정합니다. Reason은 선택 사항이며 null일 수도 있습니다. |
Get Customer Info | 2 | 이메일/WhatsApp 연락처, 태그, 회사, 커스텀 필드를 포함한 현재 고객 프로필을 반환합니다. |
Load Chat History | 1 | 제공된 대화 컨텍스트가 충분하지 않을 때, 현재 티켓에서 더 오래된 채팅 기록을 불러옵니다. limit과 cursor를 제공하고, 최신 페이지부터 시작하려면 cursor를 null로 설정합니다. LLM 사용을 위한 간결한 메시지 턴을 반환합니다. |
Describe Image | 1 | 고객이 전송한 이미지의 내용을 설명합니다. 해당 이미지의 assetId(대화 컨텍스트에 나열됨)를 제공합니다. 표시된 텍스트를 포함한 텍스트 설명을 반환합니다. 캡션만으로는 이미지를 이해하기에 부족할 때 사용합니다. 항상 활성화됨 — 비활성화할 수 없습니다. |
권장 주석: 순차적인 번호가 아니라 상태별로 색상을 구분합니다 — 🔴 NOT ACCESSIBLE을 표시하는 모든 카드(예시에서 Tag Customer, Fill Customer Data, Route Ticket) 주위에 빨간색 윤곽선, 🟢 접근은 가능하지만 비활성화된 카드(Get Customer Info, Load Chat History) 주위에 녹색 윤곽선, 🔵 Always active(Describe Image) 주위에 파란색 윤곽선. 이미지 아래에, 세 가지 색상을 아래 "Accessibility and locking"에서 설명하는 세 가지 상태에 매핑하는 공유 범례 하나를 추가합니다 — 이 상태 구분이 클릭 순서보다 여기서 더 중요합니다.
접근성 및 잠금
각 도구 카드는 다음 상태 중 하나를 표시합니다:
Toggle available, currently Disabled — 도구에 접근할 수 있지만(에이전트의 Authority Limit Level이 요구 사항을 충족함) 아직 켜져 있지 않습니다.
🔒 NOT ACCESSIBLE — 에이전트의 현재 Authority Limit Level이 해당 도구의 필요 Level보다 낮습니다. 카드에는 다음과 같이 표시됩니다: "Not accessible: agent authority limit (X) is below required level (Y). Increase the agent's Authority Limit Level to enable this tool." 이 토글이 사용 가능해지려면 먼저 Governance에서 Authority Limit Level을 높여야 합니다.
Always active — 현재는 Describe Image만 이러한 방식으로 작동합니다. 끌 수 없습니다.
운영 가이드
에이전트에게 정의된 역할에 실제로 필요한 도구만 활성화하세요 — Tag Customer, Fill Customer Data, Route Ticket은 모두 고객/티켓 데이터를 수정하므로, 부여하기 전에 신중히 검토하세요.
Route Ticket(Level 7)은 가장 높은 권한을 가진 도구입니다 — 티켓을 자율적으로 재배정해야 한다고 확신하는 에이전트에게만 예약하세요. 잘못 구성된 에이전트가 이 도구를 가지고 있으면 대화가 올바른 팀에서 벗어나 라우팅될 수 있기 때문입니다.
필요한 도구가 NOT ACCESSIBLE로 표시된다면, 깊이 생각하지 않고 Authority Limit Level을 무작정 높여 그 도구를 "잠금 해제"하지 마세요 — Authority Limit Level은 최대 응답 길이(레벨 × 1000 토큰)도 제한한다는 점을 기억하세요. 따라서 이를 높이면 해당 도구 이외의 부수적인 영향도 발생합니다.
Load Chat History와 Get Customer Info는 저위험의 읽기 전용 도구(Level 1~2)입니다 — 대화 컨텍스트가 필요한 대부분의 에이전트에게 활성화하기에 합리적인 기본값입니다.
관련 항목: Governance & Autonomy · Shared Inbox (링크 미제공) · Contact Management (링크 미제공) · SmartForms (링크 미제공)