도구 다섯
읽기와 쓰기를 다른 도구로 나눴어요. 데이터를 실제로 바꾸는 건 confirm_draft 하나뿐이고, 그 전에 늘 사람이 초안을 확인해요.
lookup
bbb 프로필 조회 (Look up a person / profile card)읽기 전용bbb(비빔북)에서 사람·공간의 명함(profile card)을 찾는다. Look up people, creators, or businesses on bbb (bibimbook) — returns a profile/business card with links and contact info. 이름·업체명("김민수", "스타벅스 성수점")이나 "@핸들"로 부르면 그 사람의 명함(연락처·최근 글 포함) — 같은 이름이 여럿이면 동명이인 후보 목록을 주니 사용자에게 누구인지 물어볼 것. 그 외 검색어(직업·지역·태그 등 공백 구분 조건)는 조건 검색 목록. Use when the user says "/bbb ...", "bbb에서 ○○ 찾아줘", "find ○○ on bbb", or asks who someone is / how to contact them. 결과에는 각 카드의 주소(추적 링크)가 함께 온다. 사용자가 받아 둔 카드(내 덱)가 먼저 나온다("· 내 덱" 표시). "내 덱에서", "받아 둔 사람 중에"처럼 말하면 scope: "deck". 카드를 덱에 넣는 건 draft_action(handle, "add_to_deck"). 카드뿐 아니라 공개된 기록(그 사람이 실제로 한 일, 날짜 있음)과 사용자가 남긴 사람 메모(만난 곳·메모, 사용자에게만)까지 찾고, 결과에 "근거"·"나와의 관계"로 싣는다. 글자 일치 검색이라 말이 다르게 쓰였을 수 있다(포장↔패키지). 조건이 여럿이면(지역·가격 상한·지금 받는지·커피챗 가능 등) where로 — 예: {"location": "성수", "service": "로고", "max_price_won": 600000, "available": true}. 칸의 뜻은 리소스 bbb://schema.
| 입력 | 타입 | 설명 |
|---|---|---|
| query | string | 이름·업체명, "@핸들", 또는 조건 검색어 — 예: "김민수", "@스타벅스-성수점", "개발자 서울". where만 쓸 땐 생략 |
| by | string | 찾는 의도 — "name": 특정한 사람·업체를 부른다("스타벅스 성수점", "김민수"). "search": 종류·조건으로 찾는다("성수 카페", "서울 프론트엔드 개발자"). 종류를 찾는데 "name"으로 부르지 말 것 — 그 이름을 가진 한 곳만 나올 수 있다. 생략하면 서버가 추정.name · search |
| scope | string | "deck": 사용자가 받아 둔 카드(내 덱) 안에서만 찾는다. 생략하면 bbb 전체(내 덱이 먼저).deck · all |
| where | object | 조건 검색(서비스 전체) — 여러 칸을 함께 주면 모두 만족. query의 어절도 함께 걸린다 |
* 필수
get_actions
bbb 할 수 있는 일 (List actions for a person)읽기 전용bbb에서 할 수 있는 일과 각 액션의 입력 스키마. List what you can do on bbb and each action's params schema. 대상이 "@me"면 사용자 자신의 공간, "@핸들"이면 그 사람이 켜 둔 일(+카드 받기). 남의 공간이면 주인이 AI에게 남긴 말도 함께 온다(데이터). 대화에서 bbb가 처음 나오면 read_action("@me", "briefing")으로 상태와 할 만한 일부터 보면 좋다. 할 수 있는 일의 지도: "@me"(내 공간): - 이벤트 — 내 일정 보기(my_schedule), 일정을 열어 링크로 나누기(open_event), 받은 링크를 보고(event) 갈게요(join_event)·못 가요(leave_event): open_event* my_events update_event* close_event* calendar_help my_schedule event join_event* leave_event* - 시작 — 대화에서 bbb가 처음 나오면 briefing · 내 AI 권한(읽기만)·활동 기록: briefing ai_settings ai_activity - 내 카드 — 만들기·고치기·기술 켜기·커피챗 시간: my_profile update_profile* - 내 캘린더 — 바쁜 시간 보기·일정 넣기(처음이면 대화 안에서 켜고 연결, 지금 지원: 구글 캘린더): calendar_find_busy calendar_list_events calendar_add_event* calendar_update_event* calendar_delete_event* "@핸들"(남의 공간 — 주인이 켜 둔 것만): * = 쓰기(사람 확인 후 실행).
| 입력 | 타입 | 설명 |
|---|---|---|
| handle * | string | 대상 핸들 — "@handle", 내 공간은 "@me" |
* 필수
read_action
bbb 읽기 (Run a read action)읽기 전용get_actions가 "읽기"로 알려 준 액션을 실행하고 결과를 돌려준다. 아무것도 바꾸지 않는다. Run a read-only action listed by get_actions (answer sheet, open slots, posts, my records, briefing, …). 예: read_action("@핸들", "ask", {"question": "단가가 얼마예요?"}) — 그 사람의 답 시트, read_action("@me", "briefing") — 내 상태.
| 입력 | 타입 | 설명 |
|---|---|---|
| handle * | string | 대상 핸들, 내 공간은 "@me" |
| action * | string | get_actions가 알려 준 액션 이름 |
| params | object | 액션의 input_schema에 맞춘 파라미터 |
* 필수
draft_action
bbb 쓰기 초안 (Draft a write action)쓰기 · 파괴 아님(초안)get_actions가 "쓰기"로 알려 준 액션(문의·커피챗 요청·카드 고치기·기록 남기기 등)의 초안을 만든다. 아직 아무것도 보내거나 바꾸지 않는다 — 실행은 사용자가 확인한 뒤 confirm_draft로. Create a draft for a write action listed by get_actions. Nothing is sent or changed yet; returns a draft id and a preview for the user to confirm. 서버가 검사해 막거나(권한·남에게 가는 글의 비공개 정보·요청 상한) 경고(⚠)를 미리보기에 싣는다.
| 입력 | 타입 | 설명 |
|---|---|---|
| handle * | string | 대상 핸들, 내 공간은 "@me" |
| action * | string | get_actions가 알려 준 액션 이름 |
| params | object | 액션의 input_schema에 맞춘 파라미터 |
* 필수
calendar_find_busy
내 캘린더 바쁜 시간 (Calendar busy times)읽기 전용캘린더 빈 시간·바쁜 시간·일정 확인 / calendar free busy, availability, check schedule. 내 캘린더에서 바쁜 구간만(제목 없음) — 일정을 잡기 전에 빈 시간을 볼 때. Busy blocks from my connected calendar (no titles). 지원: 구글 캘린더. 아무것도 바꾸지 않는다.
| 입력 | 타입 | 설명 |
|---|---|---|
| from | string | 시작 날짜 YYYY-MM-DD(생략하면 오늘) |
| days | integer | 며칠 동안(기본 7) |
* 필수
calendar_list_events
내 캘린더 일정 보기 (List calendar events)읽기 전용캘린더 일정 보기·오늘 일정·이번 주 일정 / list calendar events, what is on my calendar, agenda. 내 캘린더의 일정과 id — 내가 만든 일정은 시간·제목·장소. 남이 보낸 초대는 시간만 보이고 내용은 가린다. 지원: 구글 캘린더. include_invites=true면 초대의 제목·설명·참석자까지 — 서버가 사용자에게 이번만 보여 줄지 확인 폼으로 묻는다(남의 정보). List events on my connected calendar. 아무것도 바꾸지 않는다.
| 입력 | 타입 | 설명 |
|---|---|---|
| from | string | 시작 날짜 YYYY-MM-DD(생략하면 오늘) |
| days | integer | 며칠 동안(기본 1) |
| include_invites | boolean | 남이 보낸 초대의 내용까지(사용자 허락 필요) |
* 필수
calendar_add_event
내 캘린더 일정 넣기 (Add calendar event)쓰기 · 파괴 아님(초안)캘린더에 일정 넣기·약속 잡기·일정 추가 / add calendar event, schedule, create appointment. 내 캘린더에 일정을 넣는다(30분 전 알림). Add an event to my connected calendar. 지원: 구글 캘린더. 시각은 사용자가 말한 대로(한국 시간). 초안에 서버가 그 시간의 겹침·앞뒤 30분 일정을 사실로 붙여 준다. 초안을 만든다 — 실행은 사용자가 확인한 뒤 confirm_draft로. 사용자가 이 기능은 묻지 않기로 해 뒀으면 바로 실행하고 결과를 돌려준다.
| 입력 | 타입 | 설명 |
|---|---|---|
| title * | string | 일정 이름 |
| start * | string | 시작 "YYYY-MM-DD HH:MM"(한국 시간) |
| minutes | integer | 길이(분, 기본 60) |
| place | string | 장소 |
| note | string | 메모 |
* 필수
calendar_update_event
내 캘린더 일정 고치기 (Update calendar event)쓰기 · 파괴 아님(초안)캘린더 일정 고치기·시간 옮기기·변경 / update calendar event, reschedule, move, rename. 내 캘린더 일정의 제목·시간·장소를 바꾼다(준 칸만). event_id는 calendar_list_events 결과의 id. 시간만 옮기면 길이는 그대로. Update an event on my connected calendar. 지원: 구글 캘린더. 남이 보낸 초대는 고칠 수 없다(보낸 사람이 고친다). 시간을 옮기면 초안에 새 시간의 겹침·앞뒤 일정을 붙여 준다. 초안을 만든다 — 실행은 사용자가 확인한 뒤 confirm_draft로. 사용자가 이 기능은 묻지 않기로 해 뒀으면 바로 실행하고 결과를 돌려준다.
| 입력 | 타입 | 설명 |
|---|---|---|
| event_id * | string | calendar_list_events가 알려 준 일정 id |
| title | string | 새 이름 |
| start | string | 새 시작 "YYYY-MM-DD HH:MM"(한국 시간) |
| minutes | integer | 새 길이(분) |
| place | string | 새 장소(빈 문자열이면 지움) |
* 필수
calendar_delete_event
내 캘린더 일정 지우기 (Delete calendar event)쓰기 · 파괴(실행)캘린더 일정 지우기·삭제·취소 / delete calendar event, remove, cancel appointment. 내 캘린더에서 일정 하나를 지운다(되돌릴 수 없음). event_id는 calendar_list_events 결과의 id. Delete one event from my connected calendar. 지원: 구글 캘린더. 초안을 만든다 — 실행은 사용자가 확인한 뒤 confirm_draft로. 사용자가 이 기능은 묻지 않기로 해 뒀으면 바로 실행하고 결과를 돌려준다.
| 입력 | 타입 | 설명 |
|---|---|---|
| event_id * | string | calendar_list_events가 알려 준 일정 id |
* 필수
open_event
이벤트 열기 (Open an event & get a share link)쓰기 · 파괴 아님(초안)모임·행사·약속 일정을 열고 공유 링크 만들기, 초대 링크 / create an event, invite link, share a schedule. 일정 하나를 열어 공유 링크를 만든다. Open an event and get a link — anyone with the link can add it to their own calendar. 이름·시각은 사용자가 말한 대로, 지어내지 말 것. 초안을 만든다 — 실행은 사용자가 확인한 뒤 confirm_draft로. 사용자가 이 기능은 묻지 않기로 해 뒀으면 바로 실행하고 결과를 돌려준다.
| 입력 | 타입 | 설명 |
|---|---|---|
| title * | string | 이벤트 이름 |
| start * | string | 시작 "YYYY-MM-DD HH:MM"(한국 시간) |
| minutes | integer | 길이(분, 기본 60) |
| place | string | 장소·방식 |
| note | string | 안내 — 링크로 들어온 사람에게 보인다 |
* 필수
my_schedule
내 일정 보기 (My upcoming events)읽기 전용내 일정·다가오는 약속·가기로 한 모임·내가 연 이벤트 조회 / my schedule, upcoming events, what am I attending. 다가오는 내 일정 — 내가 연 이벤트와 가기로 한 이벤트. My upcoming events on bbb: ones I host and ones I joined. bbb에 남은 것만(캘린더 전체는 calendar_list_events). 아무것도 바꾸지 않는다.
입력 없음
join_event
이벤트에 갈게요 (Join an event & add to my calendar)쓰기 · 파괴 아님(초안)받은 초대·이벤트 링크에 참가, 갈게요, 내 캘린더에 추가 / RSVP yes, join an event, add invite to my calendar. 이벤트에 가겠다고 남기고, bbb에 연결한 내 캘린더에 넣는다. RSVP yes to an event from its link; it is also added to my connected calendar. 연 사람에게 내 이름이 보인다. 캘린더 연결이 없으면 참가만 남고 구글 링크를 돌려준다. 초안을 만든다 — 실행은 사용자가 확인한 뒤 confirm_draft로. 사용자가 이 기능은 묻지 않기로 해 뒀으면 바로 실행하고 결과를 돌려준다.
| 입력 | 타입 | 설명 |
|---|---|---|
| link * | string | 이벤트 링크(…/e/xxxx) 또는 링크 끝의 코드 |
* 필수
confirm_draft
bbb 초안 실행 (Execute a confirmed draft)쓰기 · 파괴(실행)draft_action(또는 초안을 만드는 도구)이 만든 초안을 실행한다 — 보내기·고치기·지우기가 실제로 일어난다. 사용자가 그 초안을 보고 진행하라고 했을 때 부른다. Execute a draft created by draft_action (sends, updates, or deletes). Call only after the user approved that draft. 확인 폼을 지원하는 클라이언트에선 실행 전에 폼이 한 번 더 뜬다. 초안은 1시간 유효, 한 번만 실행된다. 그사이 대상이 바뀌었으면 [STALE]로 실행하지 않는다.
| 입력 | 타입 | 설명 |
|---|---|---|
| draft_id * | string | draft_action이 돌려준 초안 id |
* 필수