o2o-site-AEO/docs/AGENT_GUIDE.md

사장님 에이전트 — 말로 할 수 있는 일

기준: 2026-09-30 · fix/agent-multi-action (091d5d9) 카카오톡 채널과 빌더 대화창([말로 고치기])은 같은 에이전트다 — 아래는 둘 다에 해당한다. 카카오톡에서만 해당하는 것은 (카톡) 으로 표시한다.

운영자·CS 가 "사장님이 말로 무엇을 시킬 수 있나" 를 확인하는 목록이다. 왜 그렇게 동작하는지 (등급 · 게이트 · 조용히 틀리는 함정)는 AGENT.md가 단일 출처다 — 여기에 옮겨 적지 않는다. 도구를 바꾸는 커밋에서 이 파일도 같이 고친다.

---

카카오톡 연결 · 가게 선택 (카톡)

동작 : 빌더 [내 사이트]에서 받은 6자리 코드를 카카오톡 채널에 보내기 행동 : 계정을 연결하고 관리 중인 홈페이지 목록과 발행 여부를 보여 줌 (코드는 10분간 유효, 1회만 사용 가능)

동작 : 가게 이름 버튼 누르기 또는 가게 이름 그대로 보내기 행동 : 그 가게를 대화 대상으로 기억함 (가게가 하나면 자동 선택)

동작 : "목록", "가게 바꿔줘", "다른 가게" 행동 : 언제든 홈페이지 목록으로 돌아가 다시 고르게 함

동작 : 지금 가게가 아닌 다른 내 가게 이름을 말하기 ("둘째가게 휴무 바꿔줘") 행동 : 실행하지 않고 "먼저 골라 주세요"라고 안내 (지금 가게가 잘못 바뀌는 것을 막음)

---

업종별 수정 가능 항목

항목 목록의 원본은 solution/backend/common/category_schema/resources/*.json 의 scope: "place" 필드다. 객실·메뉴·시술 단위(scope: "unit") 값은 대화로 고칠 수 없다.

숙박 체크인, 체크아웃, 취소·환불 규정, 취사, 반려동물, 흡연, 인원 추가 요금, 바비큐 이용·이용료, 프런트 운영시간, 주차 가능·주차 대수, 와이파이, 조식, 유아용품, 픽업, 부대시설, 객실 수, 수용 인원, 규모, 숙소 소개

카페 영업시간, 휴무일, 브레이크타임, 라스트오더, 반려동물, 아동, 주차, 무료 주차 시간, 장시간 이용, 결제 수단, 휠체어, 좌석 수, 와이파이, 콘센트, 테라스, 테이크아웃, 배달, 대표 메뉴, 가격대, 카페 소개

음식점 영업시간, 휴무일, 브레이크타임, 라스트오더, 예약 필수, 예약 방법, 반려동물, 아동, 콜키지, 룸·별실, 단체석 최대 인원, 주차, 주차 대수, 포장, 배달, 결제 수단, 대표 메뉴, 가격대, 휠체어, 가게 소개

피부과·성형외과 진료시간, 휴진일, 진료과목, 의료진, 예약 필수, 예약 방법, 상담료, 보험, 취소 규정, 야간·주말 진료, 외국어 상담, 주차, 휠체어, 병원 소개

---

가게 정보 조회 · 수정

동작 : "지금 저장된 정보 보여줘", "주차 정보 뭐로 돼 있어?" 행동 : 저장된 값을 최대 20개까지 보여 줌 (키워드를 말하면 그 항목만)

동작 : "체크인 오후 3시로 바꿔줘", "체크인 15시 30분", "체크인 3시 반" 행동 : 시각으로 저장 (15:00 / 15:30). "3시"처럼 오전인지 오후인지 모르면 되물음

동작 : "반려동물 이제 돼요", "흡연 안 돼요" 행동 : 가능 / 불가로 저장. "소형견만"처럼 가능·불가로 볼 수 없는 말이면 되물음

동작 : "추가 인원 2만원", "바비큐 2만 5천원", "바비큐 무료" 행동 : 숫자로 저장 (20000 / 25000 / 0). "문의"처럼 숫자가 아니면 되물음

동작 : "숙소 소개 ○○로 바꿔줘" 행동 : 말한 문장을 그대로 저장

동작 : "객실 요금 바꿔줘", "메뉴 가격 바꿔줘" 행동 : 객실·메뉴별 값이라 "대화로는 아직 고칠 수 없어요"로 안내

고친 값은 곧바로 저장되지만 사이트에는 다시 발행해야 반영된다. 답에 재발행 안내가 붙는다.

---

섹션 조회

동작 : "홈페이지 구성 보여줘" 행동 : 보이는 순서대로 번호를 붙여 보여 주고, 꺼진 섹션은 따로 모아 보여 줌 (히어로는 "항상 맨 위", SNS는 "항상 맨 아래"로 표시)

동작 : "숨긴 거 뭐 있어?" 행동 : 꺼져 있는 섹션만 보여 줌

---

섹션 켜기 · 끄기(숨기기)

동작 : "날씨 빼줘", "영상 숨겨줘" 행동 : 섹션을 삭제하지 않고 끔 (언제든 다시 켤 수 있음)

동작 : "갤러리랑 날씨 숨겨줘" 행동 : 여러 섹션을 한 번에 끔 (하나라도 못 찾거나 끌 수 없으면 아무것도 바꾸지 않고 어느 것이 문제인지 안내)

동작 : "영상 다시 켜줘" 행동 : 꺼진 섹션을 다시 켬

동작 : "히어로 빼줘", "기본 정보 빼줘", "오시는 길 빼줘" 행동 : 꼭 있어야 하는 섹션이라 "끌 수 없어요"로 안내

동작 : 이미 꺼진 섹션을 또 끄라고 하기 행동 : "이미 꺼져 있어요"로 안내하고 재발행을 권하지 않음

---

섹션 옮기는 방법

동작 : "갤러리 맨 위로", "갤러리 맨 아래로" 행동 : 해당 섹션을 맨 앞 / 맨 뒤로 이동

동작 : "갤러리를 소개 앞으로", "갤러리를 소개 다음으로" 행동 : 지정한 섹션의 바로 앞 / 바로 뒤로 이동

동작 : "갤러리 한 칸 위로", "소개 두 칸 아래로" 행동 : 말한 칸 수만큼 이동 (보이는 순서 기준, 꺼진 섹션은 칸 이동 불가)

동작 : "날씨 세 번째로", "날씨 첫 번째로" 행동 : 구성 목록의 해당 번호 자리로 이동 (없는 번호면 되물음)

동작 : "소개랑 갤러리 자리 바꿔줘" 행동 : 두 섹션의 위치를 맞바꿈

동작 : "히어로 맨 아래로", "SNS 게시글 맨 위로" 행동 : 항상 맨 위 / 맨 아래에 고정된 섹션이라 "옮길 수 없어요"로 안내

동작 : 이미 그 자리에 있는 섹션을 옮기라고 하기 행동 : "이미 맨 위에 있어요"로 안내하고 재발행을 권하지 않음

---

사진 조회 · 수정

동작 : "사진 목록 보여줘" 행동 : 최대 15장까지 보여 줌 (대표 사진과 숨긴 사진을 표시)

동작 : "대표 사진 수영장으로 바꿔줘" 행동 : 해당 사진을 대표로 지정 (객실·메뉴 전용 사진, 숨긴 사진은 불가)

동작 : "객실 사진 내려줘" 행동 : 사진을 삭제하지 않고 숨김 (이미 숨겼으면 "이미 안 나가고 있어요"로 안내)

동작 : 이름이 비슷한 사진이 여러 장일 때 ("객실 A", "객실 B" 중 "객실") 행동 : 추측하지 않고 되물음 (이름이 정확히 맞는 사진이 한 장이면 그 사진을 선택)

사진은 Vision 이 붙인 라벨(예: "외관", "수영장")로 지목한다.

---

발행

동작 : "홈페이지 발행됐어?" 행동 : 발행 여부, 주소, 마지막 발행 시각을 알려 줌

동작 : "발행해줘" 행동 : 바로 실행하지 않고 [네, 해주세요] / [아니요]로 한 번 확인한 뒤 발행

동작 : 정보나 섹션을 고친 직후 (카톡) 행동 : "다시 발행해야 반영돼요" 안내와 [네, 발행해주세요] 버튼을 붙임 (3분 안에 누르면 발행, 3분이 지나거나 다른 말을 하면 취소)

---

한 번에 여러 요청

동작 : "체크인 3시로 바꾸고 날씨 빼줘" 행동 : 시킨 순서대로 처리 (한 번에 최대 5가지, 재발행 안내는 한 번만)

동작 : "체크인 오후 3시로 바꾸고 전화번호도 바꿔줘" 행동 : 되는 것은 처리하고, 안 되는 것은 "'전화번호 변경' 은(는) 대화로는 아직 할 수 없어요"로 안내

동작 : 중간에 하나가 실패함 행동 : 거기서 멈추고 앞의 변경은 유지. 남은 요청은 "아직 하지 않았어요"로 안내

동작 : "갤러리 빼고, 발행하고, 체크인 오후 3시로" 행동 : 발행 앞까지만 처리하고 발행 확인을 받음 (발행 뒤에 남은 요청은 확인 전에 미리 안내)

동작 : "체크인 3시… 아니 4시로" 행동 : 마지막 값 하나만 처리 (옮기기는 합치지 않고 시킨 순서대로 모두 실행)

---

대화로 할 수 없는 것

• 객실·메뉴·시술별 값 (요금, 인원 등)
• 가게 이름·주소·전화번호
• 템플릿·색·서체
• 사진 올리기·교체, 섹션 새로 추가, 가게·섹션·사진 완전 삭제
• 이용 후기·엽서 쓰기 끄기 (섹션 목록에 없고 항상 표시됨)
• 여러 가게 동시 수정, SNS 게시

위 기능을 요청하면 할 수 없다고 안내하고, 다른 요청과 섞여 있으면 되는 것만 처리한다.