> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 주소 검색

> 통화 중 들은 주소로 후보를 찾고, 고객에게 배송지나 방문지가 맞는지 확인받을 수 있어요.

주소 검색 도구는 통화 중 들은 단서로 한국 주소 후보를 찾아요. 도구가 주소를 확정하거나 저장하지는 않으니, 에이전트가 후보를 고객에게 확인받도록 설정하세요.

<img src="https://mintcdn.com/fleek/5F4B4dzl6Udp7sHE/images/screens/agent-build/tools/builtin/search-address/settings.webp?fit=max&auto=format&n=5F4B4dzl6Udp7sHE&q=85&s=a3d0740c02623ab8dd3023294ce99467" alt="주소 검색 설정 창의 함수 이름과 설명, 실행 전 말하기와 끼어들기 설정" style={{ borderRadius: "0.5rem", maxWidth: "480px", margin: "0 auto" }} width="448" height="633" data-path="images/screens/agent-build/tools/builtin/search-address/settings.webp" />

## 언제 사용하나요

* **배송지를 접수할 때**: 도로명과 건물번호로 주소 후보를 찾아요.
* **방문지를 확인할 때**: 건물명이나 장소명으로 방문할 주소를 찾아요.
* **주소가 불완전할 때**: 지역명이나 지번으로 검색하고 단서를 더 물어요.

## 주소 검색 도구 추가하기

<Steps>
  <Step title="도구 추가하고 함수 이름 확인하기">
    에이전트 설정의 **도구**에서 **추가**를 누르고 **주소 검색**을 고르세요. **함수 이름**의 기본값은 `search_address`예요.
  </Step>

  <Step title="검색할 상황 적기">
    **함수 설명**에 언제 검색할지 적으세요. 예: `배송지나 방문지의 주소 후보를 검색합니다.`
  </Step>

  <Step title="안내 설정하고 저장하기">
    **실행 전 말하기**에는 "주소를 확인해 볼게요."를 넣으세요. 검색 중에 고객의 정정을 받으려면 **도구 실행 중 끼어들기 허용**을 켜세요. 필요하면 [실행 대기음](/docs/build/tools/tool-call-sound)을 고른 뒤 **저장**을 누르세요.
  </Step>

  <Step title="프롬프트에 호출 조건 적기">
    프롬프트에 호출할 상황과 고객 확인 조건을 적으세요. 함수 이름을 바꿨다면 예문의 이름도 맞추세요.

    ```text theme={null}
    고객이 배송지나 방문지 주소를 말하면
    search_address 도구로 검색하세요.
    고객이 말한 주소 단서를 모두 사용하세요.
    후보가 여러 개면 지역명이나 건물번호를 더 물으세요.
    추가 단서를 받으면 다시 검색하세요.
    고객이 정정한 경우 최신 주소 단서만 사용하세요.
    후보가 하나여도 주소를 읽고 고객에게 확인받으세요.
    필요한 동·호수는 별도로 확인하세요.
    고객이 맞다고 답한 뒤 주소를 확정하세요.
    ```
  </Step>
</Steps>

## 통화에서 일어나는 일

도구는 주소 후보와 권장 다음 행동을 돌려줘요. 후보에는 도로명·지번 주소, 건물명, 동 정보가 담겨요. 어떤 질문으로 확인할지는 프롬프트로 정해요.

<img src="https://mintcdn.com/fleek/4ZB8wqGDoFUDD7jz/images/illustrations/tools/search-address-steps.webp?fit=max&auto=format&n=4ZB8wqGDoFUDD7jz&q=85&s=32b026a7c862f2b64969c9f49af57c86" alt="고객이 주소 단서를 말하면 에이전트가 안내와 함께 검색을 시작하고, 찾은 후보를 읽어 고객에게 확인받는 3단계" style={{ borderRadius: "0.5rem", maxWidth: "896px", margin: "0 auto" }} width="1400" height="473" data-path="images/illustrations/tools/search-address-steps.webp" />

* **안내와 검색을 함께 시작해요.** 실행 전 말하기가 끝날 때까지 검색을 미루지 않고, 둘 다 끝나야 후보를 읽어요.
* **끼어들기를 허용하면 검색을 멈출 수 있어요.** 고객이 검색 중에 주소를 고치면 최신 단서로 다시 검색하도록 프롬프트에 적으세요.
* **주소 확정과 저장은 따로예요.** 고객이 확인한 뒤 이어갈 절차를 프롬프트에 적으세요. 외부 시스템에 저장하려면 [API 도구](/docs/build/tools/api)를 따로 연결하세요.

## 문제가 생겼을 때

<AccordionGroup>
  <Accordion title="주소를 말해도 검색하지 않아요">
    함수 설명과 프롬프트에 검색할 상황을 적고, 프롬프트의 함수 이름을 설정한 이름과 맞추세요. 테스트 통화에서 배송지나 방문지 주소를 말해 보세요.
  </Accordion>

  <Accordion title="주소 후보가 여러 개 나와요">
    지역명이나 건물번호를 더 묻도록 프롬프트에 적으세요. 고객이 준 추가 단서로 다시 검색하고, 후보가 하나로 좁혀져도 주소를 읽어 확인받게 하세요.
  </Accordion>

  <Accordion title="결과가 없거나 검색에 실패해요">
    결과가 없으면 도로명, 지번, 건물명을 바꿔 물어 다시 검색하게 하세요. 검색 서비스에 문제가 생긴 것일 수도 있으니, 고객의 주소가 틀렸다고 단정하지 말고 잠시 뒤 다시 시도하거나 다른 확인 절차로 이어가도록 프롬프트에 적으세요.
  </Accordion>
</AccordionGroup>

## 관련 문서

* [도구 개요](/docs/build/tools/overview): 빌트인 도구 목록과 공통 실행 설정
* [실행 대기음](/docs/build/tools/tool-call-sound): 검색 중 재생할 소리 고르기
* [API 도구](/docs/build/tools/api): 확인한 주소를 외부 시스템에 저장하기


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.