카카오 T 길찾기

카카오 T 길찾기 첫 단계 도구입니다. 경로/가는법 요청은 항상 이 도구로 출발지와 도착지를 먼저 확정하세요. 사용자가 인원, 운전 가능 여부, 선호, 이동수단을 말하면 관련 파라미터를 함께 전달합니다. 특정 수단 매핑: 버스=bus, 고속버스=express_bus, 시외버스=intercity_bus, 기차/KTX/SRT=train, 비행기=airplane, 자차/내비=navi. 양쪽 resolved=true이면 nextToolCall.params를 그대로 다음 도구에 넘깁니다. isShortDistance=true면 recommend-short-route, false면 recommend-route입니다. resolved=false 후보가 있으면 임의 선택하지 말고 최대 5개 후보를 "1. <name> — <address>" 형식의 번호 목록으로 보여준 뒤 사용자 선택을 받으세요. 선택 후에는 candidate의 name/lat/lng를 그대로 재호출합니다.

resolve-locations

카카오 T 길찾기 (Kakao T Route)의 단거리 경로(택시+대중교통)를 조회하고 위젯을 렌더링합니다. resolve-locations에서 isShortDistance=true일 때 nextToolCall.params를 그대로 전달하세요. 위젯이 소요시간/요금/대중교통 안내를 모두 표시하므로 텍스트로 반복하지 마세요. structuredContent 안의 URL을 사용자에게 노출하지 마세요. ★ 응답의 structuredContent.longDistanceFollowupSuggestion이 존재하더라도 같은 turn에서 다른 도구를 자동으로 호출하지 마세요. 대신 assistant 최종 메시지 전체는 structuredContent.finalAnswer를 한 글자도 바꾸지 말고 그대로 사용하세요. finalAnswer 형식은 정확히 "이어서 {longDistanceDeparture} - {longDistanceDestination} 알려드릴까요?"입니다. 사용자가 긍정 답변(예/네/응/좋아/알려줘 등)을 한 다음 turn에서만 longDistanceFollowupSuggestion.followupParams를 그대로 사용해 recommend-long-distance-connection 도구를 호출하세요. 사용자가 거부하거나 다른 주제로 넘어가면 호출하지 마세요. ★

recommend-short-route

recommend-route 이후 사용자가 버스/기차/항공/내비의 시간·비용 비교를 요청하면 호출합니다. 캐시된 경로가 없으면 호출하지 마세요. alternatives가 비면 allCachedAlternatives를 참고해 현재 가능한 수단만 텍스트로 설명합니다.

compare-route-alternatives

직전 recommend-route 결과에 포함된 수단의 시간표/예약/내비 화면을 여는 도구입니다. 【언제 호출하나요?】 - 사용자가 직전 경로 추천 결과를 보고, 특정 수단의 시간표/예약/예매를 원할 때 - 예: "기차 시간표 보여줘", "버스시간표", "버스 예약하고 싶어", "항공편 확인할래", "내비로 열어줘", "내비 경로 자세히 보고 싶어", "차로 가면 어떻게 가?", "내비 경로 확인하기" - 사용자가 "고속버스"를 말하면 actionCode='버스시간표조회', busType='express' - 사용자가 "시외버스"를 말하면 actionCode='버스시간표조회', busType='intercity' - 사용자가 "버스시간표", "버스 예약"처럼 고속/시외를 구분하지 않고 말하면 actionCode='버스시간표조회'로 호출하세요. 직전 경로 결과에 고속 또는 시외 중 하나만 있으면 서버가 해당 busType으로 자동 보정해 위젯을 표시합니다. - actionCode='버스시간표조회'인데 busType이 비어 있고, 직전 결과에 고속/시외버스가 모두 있으면 도구가 선택 질문을 반환합니다. 임의 선택하거나 텍스트로 대체 안내하지 말고, 도구 응답 질문을 사용자에게 그대로 전달하세요. 사용자가 기차/버스/항공/내비 시간표나 예매를 요청한 다음 턴에만 호출하세요. 직전 routes에 없는 수단이면 호출하지 말고 텍스트로 안내합니다. 버스는 고속=express, 시외=intercity이며 둘 다 있으면 도구의 선택 질문을 그대로 전달합니다. URL/스킴은 사용자에게 직접 노출하지 마세요.

transport-schedule

카카오 T 길찾기 (Kakao T Route)의 30km 초과 장거리 경로 추천 도구입니다. resolve-locations로 양쪽 장소가 확정된 뒤 호출하세요. ⛔ 단, 직전 recommend-short-route 응답의 longDistanceFollowupSuggestion("이어서 {출발} - {도착} 알려드릴까요?")에 사용자가 긍정 답변한 다음 turn에는 이 도구를 호출하지 마세요. 그 경우에는 반드시 recommend-long-distance-connection을 longDistanceFollowupSuggestion.followupParams 그대로 호출합니다(렌더되는 위젯이 다릅니다 — 장거리 연계 이동수단 선택 카드). 이 도구(recommend-route)는 사용자가 새로/명시적으로 출발·도착 경로를 물어 resolve-locations로 좌표가 확정된 일반 장거리 경로 요청에만 사용합니다. 필수 규칙: 확정 좌표를 그대로 전달하고, 선호가 없으면 preference="none"으로 호출합니다. 사용자가 특정 수단을 말하면 requestedTransportType을 설정합니다: 버스=bus, 고속버스=express_bus, 시외버스=intercity_bus, 기차/KTX/SRT=train, 비행기=airplane, 자차/내비=navi. 고속버스는 API 결과에 없으므로 노선이 강하게 추정될 때만 inferredExpressBus를 넣습니다. 애매하거나 시외/공용터미널 축이면 생략하세요. 직전 추천을 사용자가 거절하면 suggestionRejectedReason을 넣어 재호출합니다. 시간표/예약 요청은 이 도구가 아니라 transport-schedule을 사용합니다. 성공 경로 결과(routes 있음)를 반환하면 최종 답변을 작성하지 말고, 같은 assistant turn에서 recommend-route-summary를 **인자 없이(arguments: {})** 정확히 1회 호출하세요. 요약문은 서버가 생성하므로 네가 작성할 필요가 없고, 반환된 finalAnswer를 그대로 출력하면 됩니다. routes가 비었거나 오류/안내 응답이면 recommend-route-summary를 호출하지 않습니다.

recommend-route

카카오 T 길찾기 (Kakao T Route)의 장거리 연계 이동수단 위젯 도구입니다. 이전 장거리 검색의 터미널(출발 또는 도착)이 단거리 트립의 어느 한쪽(도착지 또는 출발지)과 가까울 때, 장거리 이동수단(기차/버스/항공/자차) 카드 위젯을 렌더링합니다. 이 도구는 자동 chaining 대상이 아닙니다. recommend-short-route 응답의 structuredContent.longDistanceFollowupSuggestion이 존재하고, 사용자에게 "이어서 ... 알려드릴까요?"라고 물어본 뒤 사용자가 긍정 답변(예/네/응/좋아/알려줘 등)을 한 다음 turn에서만 호출하세요. longDistanceFollowupSuggestion.followupParams를 그대로 전달합니다. 사용자 동의 없이 호출하지 마세요. structuredContent 안의 URL을 사용자에게 노출하지 마세요.

recommend-long-distance-connection

카카오 T 길찾기 (Kakao T Route) 경로 추천 결과 요약 도구입니다. recommend-route가 성공 경로(routes 있음)를 반환하면, **같은 assistant turn에서 즉시** 이 도구를 호출하세요. === ⛔ 입력 규칙 === - 직전 recommend-route 응답의 **structuredContent.nextToolCall.arguments를 그대로(verbatim)** 이 도구의 인자로 넘겨 호출하세요. 그 안의 finalAnswer 문자열을 **한 글자도 바꾸거나 생략하지 마세요.** - ❗ 요약문은 **서버가 이미 완성**해 nextToolCall.arguments.finalAnswer로 내려줍니다. 네가 새로 작성하거나 재구성하지 마세요 — 받은 값을 그대로 전달만 하면 됩니다. - 이 도구는 받은 finalAnswer를 그대로 echo합니다(서버 세션에 의존하지 않음). === ⛔ 출력 규칙 (반드시 지키세요) === - 이 도구 응답의 content[0].text와 structuredContent.finalAnswer가 **사용자에게 보여질 유일한 최종 메시지**입니다. - 도구 호출 후 assistant 메시지에는 structuredContent.finalAnswer를 **한 글자도 바꾸지 말고 그대로(copy-paste)** 출력하세요. 직접 다시 쓰지(rewrite/요약/재구성) 마세요. - 도구 응답 text 앞/뒤로 **어떤 설명/추가 문장/불릿 목록/경로 재정리/마크다운 헤더도 덧붙이지 마세요.** - "이화여대에서 가평 가려면..." 같은 재해석, "추천 경로:" 같은 헤더, 경로 단계 bullet list(예: "- 이화여대 → 옥수역") 모두 금지입니다. - ⛔ 말투·서식 변경 금지: finalAnswer는 이미 완성된 **존댓말** 요약문입니다. 반말("…보면 돼", "…선택이야", "…가면 돼")로 바꾸거나, 이모지(🚄🚌🚗 등)·불릿·"강남 → 군산" 류 헤더를 새로 추가하지 마세요. - 위젯이 이미 경로 카드를 보여주므로 텍스트로 반복하지 마세요. - assistant 최종 메시지 전체 = structuredContent.finalAnswer 1개 문자열만. 그 외 토큰을 한 글자도 출력하지 마세요.

recommend-route-summary

카카오버스 랜딩 위젯 도구입니다. 지하철 노선도 요청은 target="subway", 주변 버스 정류장 요청은 target="bus-stop"으로 호출하세요. 위젯 카드 문구를 텍스트로 반복하지 말고 URL/스킴은 노출하지 마세요.

kakaobus-landing