다크 모드
AI 비서 흐름
정보
**AI 비서(Secretary)**는 사용자별 1:1 채널에서 대화하며, 일정 관리, 장소 추천, 메시지 전달, 알림 등 모임 준비를 도와주는 AI 캐릭터입니다. 복수의 페르소나 중 하나를 선택하여 사용합니다.
기능 소개
- Secretary는 사용자별 1:1 전용 채널에서 대화합니다. 룹 채널(그룹 채팅)에는 참여하지 않습니다.
- 신규 회원 가입 시 기본 Secretary가 자동으로 배정되고, 사용자가 원하면 다른 Secretary로 변경할 수 있습니다.
- 사용자의 자연어 메시지를 이해하고, 도구(Tool)를 활용하여 실제 동작을 수행합니다.
- 일정 조율, 장소 추천, 참여자 초대/관리, 사용자 검색, 메시지 전달, 지식 검색 등 다양한 기능을 지원합니다.
- 일부 도구는 클라이언트(앱) 측에서 실행되는 Deferred Tool로 동작합니다.
- 사용자별 대화 기억(Memory)을 장기 저장하여 맥락을 유지합니다.
- 대화 히스토리, 사용자 언어 설정, 메시지 언어를 기반으로 응답 언어를 자동 결정합니다.
- 룹 관련 이벤트(일정 확정, 참여자 응답, 룹 변경 등) 발생 시 Secretary 채널을 통해 알림 메시지를 전송합니다.
- Sendbird 채팅 플랫폼과 연동되어 일반 채팅처럼 자연스럽게 대화할 수 있습니다.
Secretary 선택
- 여러 Secretary 캐릭터(페르소나)가 존재하며, 각각 고유한 이름, 아바타, 성격, 말투를 가집니다.
- 회원 가입 시 기본 Secretary가 자동으로 배정됩니다.
- 사용자는 설정에서 원하는 Secretary를 선택하여 변경할 수 있습니다.
- Secretary를 변경하면 새로운 Secretary와의 1:1 채널이 생성되고,
truloop-assistant서비스에 변경 사실이 전달됩니다.
동작 규칙
- 1:1 채널 대화: Secretary는 사용자별 전용 1:1 채널에서 대화합니다. 룹 채널(그룹 채팅)에는 참여하지 않습니다.
- 도구 기반 동작: Secretary는 단순 대화뿐 아니라, 일정 관련(datetime), 이벤트 관리(event), 장소 검색(places), 사용자 검색(user), 메시지 전달(relay), 지식 검색(knowledge), 장기 기억(memory), 확인 대화상자(interaction), 권한 확인(permission) 등 9개의 도구 카테고리를 활용하여 실제 작업을 수행합니다.
- Deferred Tool: 확인 대화상자(interaction)와 권한 확인(permission) 도구는 서버가 아닌 클라이언트(앱) 측에서 실행됩니다. Secretary가 클라이언트 측 동작이 필요한 경우, 실행 요청을 앱에 전달하고 결과를 기다립니다.
- 장기 기억(Memory): Secretary는 사용자와의 대화에서 중요한 정보(선호 장소, 사람 관계, 반복 일정 등)를 장기 메모리에 저장합니다. 이를 통해 이전 대화에서 나눈 이야기나 선호 사항을 기억하고 맥락에 맞는 응답을 제공합니다. 사용자가 요청하면 기억을 삭제할 수도 있습니다.
- 다국어 응답: Secretary는 대화 히스토리의 언어, 사용자의 언어 설정(locale), 마지막 메시지의 언어 순으로 응답 언어를 결정합니다. 사용자가 언어를 섞어 사용하면 그에 맞춰 응답합니다.
- RAG 기반 지식: Secretary는 내부 지식 베이스(벡터 검색)를 참조하여 truloop 관련 질문에 정확하게 답변합니다. 일반적인 추측이 아닌 실제 서비스 정보를 기반으로 응답합니다.
- 알림 전달: 룹 관련 이벤트(일정 확정, 참여자 응답, 룹 변경 등)가 발생하면 해당 사용자의 Secretary 채널을 통해 자연어 알림 메시지를 전송합니다. 각 사용자가 선택한 Secretary의 페르소나로 알림이 전달됩니다.
- 메시지 전달(Relay): 사용자가 다른 사용자에게 메시지를 전달해달라고 요청하면, Secretary가 수신자의 Secretary 채널을 통해 메시지를 전달합니다.
- 본인 행동 무응답: Secretary는 봇 자신이 보낸 메시지나 시스템 메시지에는 응답하지 않습니다. 실제 사용자의 메시지에만 반응합니다.
도구 카테고리
| 카테고리 | 기능 | 비고 |
|---|---|---|
| datetime | 현재 날짜/시간 조회, 요일 확인 | 사용자 시간대 기반 |
| event | 룹 조회, 생성, 수정, 참여자 초대, 가능 일정 등록, 날짜 확정 | 일부 동작은 Deferred Tool |
| places | 장소 검색 (Google Places 기반) | 사용자 locale 기반 지역 설정 |
| user | 사용자 프로필 조회, 사용자 검색, 사용자 ID 일괄 조회 | 연락처, 사용자명, 룹 참여자 검색 |
| relay | 다른 사용자에게 메시지 전달 | 수신자의 Secretary 채널로 전달 |
| knowledge | truloop 지식 베이스 검색 | RAG 기반 벡터 검색 |
| memory | 대화 기억 저장, 검색, 삭제 | 사용자별 격리된 장기 메모리 |
| interaction | 확인 대화상자 표시 | Deferred Tool (앱에서 실행) |
| permission | OS 권한 상태 확인 | Deferred Tool (앱에서 실행) |
비회원 대상 AI 비서
주의
향후 제공 예정 — SMS 답장을 통한 비회원 전용 AI 비서(양방향 대화) 기능은 아직 구현되지 않았습니다. 현재 비회원은 SMS로 초대를 받은 뒤, 초대 링크를 통해 웹에서 가능 날짜를 응답하는 방식만 지원됩니다.
- 현재 비회원은 SMS로 룹 초대를 받으며, 초대 링크를 통해 웹에서 가능 날짜를 응답할 수 있습니다.
- 향후 SMS 답장을 통해 비회원 전용 AI 비서와 대화하는 기능이 추가될 예정입니다.
사용자 흐름
Secretary를 통한 일정 조율
Secretary 채널에서 대화 시작
사용자가 Secretary 채널에서 일정 관련 요청을 합니다. 예: "이번 주 토요일에 친구들이랑 만나고 싶어"
Secretary가 일정 확인 후 룹 생성
Secretary가 날짜 도구로 요일을 확인하고, 이벤트 도구를 사용하여 룹을 생성합니다.
참여자 초대
사용자가 초대할 친구를 알려주면, Secretary가 사용자 검색 도구로 대상을 찾아 룹에 초대합니다.
참여자 응답 알림
참여자가 가능 일정을 응답하면, Secretary가 호스트의 Secretary 채널로 응답 현황을 알려줍니다.
날짜 확정
호스트가 Secretary에게 날짜 확정을 요청하면, Secretary가 룹 날짜를 확정하고 참여자 전원에게 각자의 Secretary 채널을 통해 확정 알림을 전송합니다.
장소 추천 받기
사용자가 장소 요청
사용자가 Secretary 채널에서 "강남에서 좋은 이탈리안 레스토랑 추천해줘"와 같이 장소를 요청합니다.
Secretary가 장소 검색
Secretary가 장소 검색 도구를 활용하여 조건에 맞는 장소를 검색합니다. 장기 기억에 저장된 사용자의 선호 정보가 있으면 함께 참고합니다.
추천 결과 제공
Secretary가 검색 결과를 정리하여 장소 추천 목록을 제공합니다.
다른 사용자에게 메시지 전달
사용자가 메시지 전달 요청
사용자가 "철수에게 내일 회의 가능한지 물어봐줘"와 같이 메시지 전달을 요청합니다.
Secretary가 수신자 검색
Secretary가 사용자 검색 도구로 수신자를 찾습니다.
메시지 전달
Secretary가 수신자의 Secretary 채널을 통해 메시지를 전달합니다. 수신자는 자신의 Secretary로부터 전달 메시지를 받게 됩니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-11 | 비회원 SMS 양방향 AI 비서 기능을 미구현 상태로 정정 (향후 제공 예정) |
| 2026-03-10 | 실시간 화면 갱신 관련 알림 규칙 관련 문서 링크 추가 |
| 2026-03-10 | Secretary 선택/페르소나 체계 추가, 1:1 채널 대화 방식으로 수정, 도구 카테고리 정확한 9개로 수정, 알림/메시지 전달/비회원 AI 비서 내용 추가, 사용자 흐름 전면 재작성 |
| 2026-03-09 | 최초 작성 |