비공개 지침을 담은 채팅 위젯 코드: 제대로 작동하는 시스템 프롬프트 작성법

두 채팅 위젯이 같은 삽입 코드 한 줄을 쓰면서도 완전히 다르게 동작할 수 있습니다. 차이는 흔히 시스템 프롬프트라고 부르는 비공개 지침에 있습니다. 지침은 위젯과 함께 서버에 저장되고, 모든 대화에 함께 전송되며, 방문자에게는 절대 표시되지 않습니다.

지침이 저장되는 곳

위젯에서 채팅 위젯을 열고 동작까지 스크롤하세요. 지침 입력란에는 최대 4,000자를 입력할 수 있습니다. 지침은 서버에 남아 있으므로 페이지를 검사하는 방문자는 스크립트 태그의 위젯 ID만 볼 수 있습니다.

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

지침을 바꾸면 다음 메시지부터 적용됩니다. 사이트의 코드를 업데이트할 필요가 전혀 없습니다.

효과적인 구성

좋은 지침은 모델에게 네 가지 질문에 대한 답을 줍니다.

1. 당신은 누구인가? "당신은 아웃도어 용품 온라인 스토어 Northwind의 어시스턴트입니다."
2. 무엇을 알고 있는가? 배송 기간, 반품 규정, 영업시간, 제품군처럼 중요한 사실을 붙여 넣으세요. 모델의 정확도는 제공한 사실의 정확도를 넘을 수 없습니다.
3. 무엇을 피해야 하는가? "할인을 약속하지 마세요. 의료나 법률 조언을 하지 마세요. 확실하지 않으면 그렇다고 말하고 문의 페이지를 안내하세요."
4. 어떤 말투여야 하는가? "두세 문장으로 짧게 답하세요. 방문자의 언어를 사용하세요."

규칙은 하나하나 짧고 구체적으로 쓰세요. 길고 모호한 단락은 짧은 목록보다 모델이 따르기 어렵습니다.

방문자처럼 테스트하기

편집기 미리보기는 저장하지 않은 지침으로 실제 요청을 보내므로 빠르게 다듬을 수 있습니다.

• 고객 지원 문의함에 가장 자주 들어오는 질문 다섯 가지를 물어보세요.
• 지침에 없는 내용을 물어보고, 위젯이 모른다고 인정하는지 확인하세요.
• 할인 코드를 요청하는 식으로 규칙을 깨도록 유도해 보세요.

매번 테스트한 뒤 지침을 조정하세요. 작은 표현 변경만으로도 대부분의 문제가 해결되는 경우가 많습니다.

브랜드 일관성 유지

채팅 위젯은 화이트 라벨입니다. 로고도, "powered by" 문구도 없습니다. 제목, 환영 메시지, 입력창 안내 문구, 버튼 문구, 오류 메시지를 내가 원하는 표현으로 직접 작성하고, 강조 색상, 모서리 둥글기, 테마를 사이트에 맞추세요. 비워 둔 문구에는 계정 언어의 기본값이 사용됩니다.

지침과 한도를 함께 쓰기

지침은 답변의 방향을 잡아 주지만 예산을 대신하지는 못합니다. 최대 응답 길이 (토큰) 값으로 상한을 정해 답변을 짧게 유지하고, 위젯을 실행할 API 키를 선택하세요. 그 키의 일일 지출 한도와 허용 모델이 모든 방문자 요청에 적용되어, 독립적인 두 번째 안전장치가 됩니다.

위젯 페이지에서 초안을 만든 다음 대시보드에서 세부 조정하세요.