페어 메신저 (7.1 업데이트)

페어의 대화 기록을 열람한다는 설정의 위젯입니다.
가볍게 주고받는 일상 등을 엿볼 수 있으나,
상대와 대화를 나눌 수 있는 것은 아닙니다.
 
일정 시간마다 일정 확률로 메시지가 생성되며

(시간당 3~6개 정도의 메시지가 올라오므로 느긋하게 기다려 주세요)

새벽 1~6시 사이에는 대화를 잠시 쉬어갑니다.

 

후술할 GAS_URL을 연동할 경우

동일한 대화 내역을 공유할 수 있습니다.

 
적용 예시는 PC기준 오른쪽 회색 버튼(말풍선 아이콘),
모바일 기준 메인 페이지의 동일한 버튼

또는 예시 페이지에서 확인 가능합니다.

 

 

준비

GOOGLE AI Studio에서 발급받은 Gemini API 키

*무료 버전에 대한 테스트 및 정상 작동 확인하였습니다.

빈 구글 스프레드시트
시트 바로 생성하기(링크)

*(페어명) 메신저 등, 식별하기 좋은 제목을 권장합니다

 

 

1. 데이터베이스 만들기

 

준비한 구글 스프레드시트를 엽니다.
 

하단의 시트 탭 이름을 더블클릭하여 Chat으로 변경합니다.

(대소문자 구별 주의!)
 

첫 줄(A1, B1, C1)에 각각 시간, 발화자, 메시지라고 적어둡니다.

(이 줄은 시스템이 건너뛰고 두 번째 줄부터 대화를 저장합니다.)

 

2. 서버 설정

[GAS.txt]를 열어 [맞춤 설정]의 페르소나/대화 지침 부분을
원하는 캐릭터 관련 내용으로 수정합니다.

*관계 범위를 과도하게 설정할 경우 위젯에 에러 메시지가 출력될 수 있으니,
전연령가(손잡기, 포옹 등) 수준의 관계성까지만 지정하는 것을 권장합니다.

 

2.7.1은 기존의 대화 지침을 압축 및 경량화한 버전입니다.

무료 API가 오류 없이 안정적으로 구동되도록 간소화했습니다.

GAS(2.7.1).txt

0.02MB

 

*아래의 기존 버전은 유료 API 환경을 염두에 두고 있어,

기본 무료 API를 연결하여 사용하실 경우

엉뚱한 대답/지나치게 길어지는 현상이 잦아질 수 있습니다.

무료 API를 사용 중이시라면 상단의 2.7.1 사용을 권장합니다.

GAS(1.7.1).txt

0.03MB

 

페르소나/대화 지침 예시

(가상의 페어로, 성격 및 말투 등에서 대비를 주었습니다)

페르소나 예시.txt

0.00MB

상황 및 대화 지침 예시.txt

0.00MB

 

*수면 패턴에 맞춰 대화 시간 조정이 가능합니다.

(방해 금지 모드 설정. 시간은 24시간제로 입력)

 

ctrl + F: currentHour

 

상황 1. 자정 이후에 잠들 때 (예: 새벽 2시 ~ 아침 8시 취침)

가운데의 && 기호를 그대로 두고 숫자만 바꿉니다.

if (currentHour >= 2 && currentHour < 8) return;

 

상황 2. 자정 이전에 잠들 때 (예: 밤 11시 ~ 아침 7시 취침)

자정을 지나는 시간대라면, 반드시 가운데를 || 기호로 변경해야 합니다.

(엔터 키 위의 원화(₩)기호 + Shift키 > 두 번 입력)

if (currentHour >= 23 || currentHour < 7) return;

 

데이터베이스 만들기 단계에서 생성한 구글 시트 상단 메뉴에서
[확장 프로그램] > [Apps Script]를 클릭합니다.
 
화면에 적힌 코드를 모두 지우고
수정한 [GAS.txt]의 내용 붙여넣기 > ctrl+s로 저장합니다.
 

왼쪽 메뉴에서 시계(트리거)를 클릭하고,
오른쪽 아래에 있는 파란색 [+ 트리거 추가] 버튼을 누릅니다.
 
 
설정 창이 뜨면 아래와 같이 똑같이 맞춰주세요!
 
실행할 함수 선택: autoTikiTaka
실행할 배포 선택: Head(또는 그대로 두기)
이벤트 소스 선택: 시간 기반
트리거 기반 시간 유형 선택: 분 단위 타이머
분 간격 선택: 5분마다(너무 자주 대화를 나누면 시간 늘리기)
 
저장을 누릅니다.
 
*더 자주 대화를 나누게 하고 싶다! 하는 경우
ctrl + F: Math.random

숫자 0.4 (5분마다 40%확률로 답변 달기) 를
0.4~0.8 사이의 값으로 조정해주시면 됩니다.
숫자가 더 커질수록 (최대 1) 답변 확률은 높아지나, 

시도 횟수가 잦아지며 AIP 할당량이 초과될 수 있습니다.

 

왼쪽 메뉴에서 톱니바퀴(프로젝트 설정)를 클릭하고,
스크롤을 내려 [스크립트 속성 추가]를 누릅니다.
 
속성: GEMINI_API_KEY
값: 발급받은 Gemini API 키

저장을 누릅니다.
 

다시 코드 화면(<> 편집기)으로 돌아와서
오른쪽 위 파란색 [배포] -> [새 배포]를 누릅니다.
 

유형 선택(톱니바퀴)에서 '웹 앱'을 선택합니다.
액세스 권한: 모든 사용자로 변경합니다. (매우 중요!)

배포를 누르고 구글 계정 접근 권한을 허용해 줍니다.

완료 창에 뜨는 '웹 앱 URL'을 복사해 둡니다.

 

3. 티스토리 적용

 

[html.txt]를 엽니다.

html.txt

0.01MB

 
ctrl + F: GAS_URL

 
const GAS_URL = "여기에_웹_앱_URL을_붙여넣으세요"; 부분을 찾아
2번에서 복사해 둔 '웹 앱 URL'을 ""안에 붙여넣습니다.

 

대화 연동 기능

웹 앱 URL을 상대 오너와 공유해 HTML에 동일하게 적용하면

각각의 갠홈에서 페어의 동일한 대화 내역을 살펴볼 수 있습니다.

(이 경우 세팅 및 관리는 한 분만 하시면 됩니다.)
 

커스텀 가능 영역
(ctrl + F: 커스텀)
 
가장 위에 있는 [커스텀] 색상을 변경하세요!
: 채팅방 배경/말풍선 등의 색상을 수정합니다.
color-hex에서 컬러 코드를 참고할 수 있습니다.
 
커스텀 설정 채팅방 이름
: 채팅창 위에 뜨는 이름을 변경할 수 있습니다.
이모지 사용도 가능하나, 이 경우 기기마다 디자인이 달라집니다.
 
TIP!
HTML 편집기(RIL님)에서 작동 및 커스텀 여부를 확인할 수 있습니다.
 
완성된 전체 html 코드 복사
티스토리 블로그 관리 > 스킨 편집 > 우측 상단 [html 편집]
 </body> 태그 바로 위에 붙여넣기

 
 

주의사항

 

'가벼운 일상의 티키타카'를 지켜보는 것이 목적인 만큼,

텍스트 처리 한계상, 방대하고 깊은 세계관이나 복잡한 과거 서사 등을

완벽하게 구현하는 데에는 어려움이 생길 수 있습니다.

 

절대로 잊으면 안 되는 핵심 설정이 있다면

(종족 특성, 세계관의 중요한 규칙 등)

GAS 코드의 [페르소나] 내에 구체적으로 짚어주세요.

 

1. 티스토리 외 갠홈 형식에 맞춰서도 수정하여 사용 가능합니다.
이 경우 해당 트윗 또는 본문을 출처로 링크해주시기 바랍니다.
(원형을 알아보기 어려운 수정 및 자작 발언 x)
 
2. 스크립트 텍스트나 파일 자체를 타 사이트나 커뮤니티에

무단으로 재배포하는 행위를 금지합니다.

코드를 타인에게 공유하고 싶으시다면,

본 게시물 또는 아래의 트윗 링크를 전달해 주시기 바랍니다.

X의 𝚁님(@229x812)

 
3.
1) 페르소나/대화 지침
2) 이전 대화 로그
에 따라 대화의 방향 및 캐붕 여부가 정해지므로...
대화를 지켜보다 뭔가 이상하게 흘러간다! 싶은 경우
구글 스프레드시트에 기록된 대화(삭제/수정이 가능합니다)
또는 Apps Script의 페르소나/대화 지침 수정을 권장합니다.
 
Apps Script 수정 후 저장 시에는 반드시
[배포] > [배포 관리] > 수정(연필 모양 아이콘)
버전은 늘 새 버전으로 바꾸고 [배포]를 눌러주셔야 적용됩니다.
 
4. 대화 백업이 길어지면 시트가 다소 무거워질 수 있습니다.
이 경우 [Chat] 시트의 대화 내용을 다른 시트 등에 백업하고
두 번째 줄(첫 줄의 시간/발화자/메시지는 남겨두셔야 합니다)부터
마지막 줄까지 드래그 > [행 삭제] 를 해주시면 다시 가벼워집니다.
 
5. GAS.txt 내의 Gemini 모델은 구글 방침에 따라 변경될 수 있으며,
이로 인해 오류가 발생하는 경우 업데이트 버전이 올라옵니다.
(업데이트 주기는 비정기적입니다)
 
6. 코드 내의 설정 관계 필터 로직을 임의로 수정해
비윤리적인 대화를 유도하는 행위 등을 절대 금지합니다.
가이드라인 미준수 및 임의 개조로 인해 발생하는

오류 현상에 대해서는 어떠한 피드백이나 문의도 받지 않습니다.

발견 즉시 본 코드의 배포는 즉시 예고 없이 중단될 수 있습니다.

 

 

[필독] 개인정보 관련

 

Q.

생성된 대화 내용을 개발자가 볼 수 있나요?

 

A.

결론부터 말씀드리면, 절대 볼 수 없습니다.

 

이 위젯은 특정 중앙 서버에서 구동되는 웹 서비스가 아니며,

배포된 코드를 복사하여 개인의 구글 드라이브 안에서

독립적으로 구동하는 시스템입니다.

 

설정하신 두 캐릭터가 나누는 모든 대화 기록(DB)은

각자 생성한 구글 스프레드시트에만 저장되며,

직접 공유하지 않는 한 개인의 스프레드시트 데이터나

발급받은 API 키를 조회하는 것은 불가능합니다.

 

여러분만의 공간에서

캐릭터들의 대화를 구성하고 즐겨주세요u//u

 

 

 

GAS(1.2), GAS(2.2)

- 오류 발생 시 구체적인 원인이 출력되도록 코드를 수정하였습니다.

 

🔑 API 키를 잘못 넣었거나 권한이 없다면? (401, 403 에러) - [시스템 안내] API 키가 잘못되었거나 권한이 없습니다.

• 열쇠가 맞지 않거나 출입이 막힌 상황입니다. [스크립트 속성]에 입력한 키 앞뒤로 보이지 않는 '띄어쓰기(공백)'가 섞여 들어가지 않았는지 꼼꼼히 확인해 주세요! 혹은 구글 AI Studio에서 API 사용 스위치가 'ON'으로 켜져 있는지도 확인이 필요합니다.

⏳ 대화를 너무 자주 시도해 한도가 초과되었다면? (429 에러) - [시스템 안내] 무료 API 사용 한도를 초과했습니다.

• 구글 트리거 설정에서 대화 요청 주기를 '5분' 이상으로 조금 늦추거나, 코드 내 답장 확률을 '0.4' 이하로 낮추어 템포를 여유롭게 조절해 보세요.

☁️ 구글 AI 서버 자체에 문제가 생겼다면? (500번대 에러) - [시스템 안내] 구글 AI 서버가 일시적으로 불안정합니다.

• 구글 서버에 잠시 무리가 간 상태이니, 잠시 후 다시 시도해 주세요.

⚠️ 대화가 너무 길어지거나 모델이 변경되었다면? (400, 404 에러) - [시스템 안내] 대화 기록이 너무 길거나 코드가 손상되었습니다.

• 한 번에 처리해야 할 대화 기억이 너무 많아 과부하가 왔을 수 있습니다. 시트의 옛날 대화 내용을 조금 비워주시거나, 배포 블로그(sardina.tistory.com/598)에서 최신 코드로 업데이트가 필요한지 확인해 주세요!

 

GAS(1.3), GAS(2.3)

- 일정 확률로 발생하는 대화의 고질적인 루프 현상을 개선했습니다.

 

GAS(1.4), GAS(2.4)

- 번역투 및 감상을 반복해 재현하는 현상을 개선했습니다.

 

GAS(1.5), GAS(2.5)

- 규칙에서 사용하던 예시 단어 등을 수정하여 범용성을 높였습니다.

 

GAS(1.6), GAS(2.6)

- 오류가 발생한 경우 해당 기록을 건너뛰고 답하도록 하여 맥락 오염을 방지했습니다.

 

GAS(1.7), GAS(2.7)

- 과도하게 시적이거나 작위적인 비유를 억제해 구어체에 가까워지도록 다듬었습니다.