에이전트 구축하기
에이전트의 지침, 성격, 언어, 모델을 설정하고 대화 내역을 검토하세요.
에이전트의 동작은 Playground에서 제어합니다 — 왼쪽 설정 패널에는 시스템 프롬프트, 응답 언어, 지식 베이스 설정이 있고, 오른쪽에는 변경 사항을 실제로 적용하기 전에 테스트할 수 있는 실시간 채팅 샌드박스가 있습니다. 이 페이지에서는 지침과 성격, 응답 언어, 모델 선택, 지난 대화 검토 방법을 다룹니다.
Playground 열기
- 왼쪽 사이드바에서 Agents 그룹을 열고 전환기에서 에이전트를 선택합니다.
- Playground 탭을 선택합니다 (경로:
/agents/<agentId>/playground).
에이전트의 지침과 성격 변경하기
System Prompt(시스템 프롬프트)는 에이전트의 성격, 어조, 행동 지침을 정의합니다.
- Playground에서 System Prompt 텍스트 영역을 찾습니다.
- 지침을 작성하거나 수정합니다. 더 넓은 작성 화면이 필요하면 확장 컨트롤을 사용하고, 예시 프롬프트가 필요하면 Template Reference를 열어보세요.
- 오른쪽 샌드박스 채팅에서 변경 사항을 테스트합니다 — 이는 항상 현재 초안을 반영하며, 게시된 버전이 아닙니다.
- 만족스러우면 초안 상태 표시줄의 Publish를 클릭해 변경 사항을 실제로 적용합니다. 마지막으로 게시된 버전으로 되돌리려면 Discard를 클릭하세요.
프롬프트 수정 사항은 초안(draft) 버퍼 방식으로 처리됩니다. 입력하는 대로 자동 저장되지만, Publish를 클릭하기 전까지는 실제 사용자에게 반영되지 않습니다. 대기 중인 변경 사항이 없으면 헤더에 "All changes published" 표시가 나타납니다.
에이전트의 응답 언어 설정하기
기본적으로 에이전트는 맥락에 따라 응답 언어를 자동으로 감지합니다.
- Playground 설정 패널에서 Response Language(응답 언어) 콤보박스를 찾습니다.
- 언어를 강제 지정하려면 선택하고, 기본값을 유지하려면 auto로 둡니다.
- Publish를 클릭해 변경 사항을 적용합니다.
선택 가능한 옵션: auto(자동 감지), 영어(en), 번체 중국어(zh-Hant), 간체 중국어(zh-Hans), 일본어(ja), 한국어(ko).
시스템 프롬프트와 마찬가지로 이 설정도 초안 버퍼 방식이므로, 게시해야만 실시간 대화에 영향을 미칩니다.
에이전트의 AI 모델 선택하기
모델 선택은 에이전트별로 설정하는 항목이 아닙니다 — 기반이 되는 AI 모델은 자동으로 관리되며, 사용 가능한 구체적인 모델은 워크스페이스의 요금제 등급에 따라 달라질 수 있습니다.
현재 요금제에 포함된 내용을 확인하려면 Settings → Billing을 참고하세요. 응답의 무작위성(temperature)과 최대 응답 길이(max tokens) 역시 요금제 등급 수준에서 설정되며, 에이전트별로 수정할 수 없습니다.
에이전트의 대화 내역 검토하기
Logs 탭은 에이전트의 대화 기록입니다 — 실제로 진행된 모든 대화를 검색하고 전체 내용을 읽을 수 있습니다.
- 에이전트를 열고 Logs 탭으로 이동합니다 (경로:
/agents/<agentId>/logs). - 왼쪽의 대화 목록을 탐색하거나 검색합니다 (방문자 이름 또는 이메일 기준). 목록은 페이지당 20개의 대화를 표시합니다.
- 대화를 선택하면 가운데 패널에서 전체 대화 기록을 읽을 수 있습니다. Copy transcript를 사용해 텍스트로 복사할 수 있습니다.
- 오른쪽의 방문자 정보 패널에서 신원(이름, 이메일, 전화번호), 채널(위젯, WhatsApp, Messenger, Instagram, Telegram), 연결된 리드 상태, 동일 방문자의 관련 대화를 확인합니다.
잘못된 답변 수정하기
에이전트가 잘못된 답변을 제공한 경우, 대화 기록에서 직접 수정할 수 있습니다.
- Logs에서 해당 대화를 엽니다.
- 어시스턴트 메시지의 편집 컨트롤을 클릭합니다.
- 열리는 대화 상자에 수정된 답변을 입력하고 제출합니다.
수정 내용은 저장되어 교정 소스(corrections source)로 에이전트의 지식에 반영되므로, 이후 해당 주제에 대한 답변이 개선됩니다.
Playground의 샌드박스 채팅은 여기에 절대 기록되지 않습니다 — 배포된 채널에서 이루어진 실제 대화만 Logs에 표시됩니다.