가이드
인텐트 라우팅
자연어 쿼리를 최적의 API 엔드포인트로 자동 매칭하는 인텐트 라우팅의 작동 방식을 설명합니다.
자연어 → 최적 API 자동 매칭
"서울 날씨"라고 입력하면 기상청 API가, "비트코인 가격"이라고 입력하면 업비트 API가 자동으로 선택됩니다. ApiFuse의 핵심인 인텐트 라우팅이 409개 API 중 최적의 엔드포인트를 찾아줍니다.
핵심 가치
API 문서를 읽고, 엔드포인트를 찾고, 파라미터를 매핑하는 과정을 AI가 대신 처리합니다. 개발자는 "무엇이 필요한지"만 말하면 됩니다.
작동 방식
코사인 유사도 비교
변환된 벡터를 409개 API 설명 벡터와 비교합니다. 가장 높은 유사도 점수의 API가 후보로 선택됩니다.
API 자동 선택 + 파라미터 매핑
top-1 API가 선택되고, 인텐트에서 추출한 정보가 API 파라미터로 자동 매핑됩니다.
인텐트: "서울 내일 날씨"
→ API: kma-short-forecast
→ 파라미터: { gridX: 60, gridY: 127 }표준 응답 반환
원본 API의 응답을 ApiFuse 표준 형식({ data, pagination, meta })으로 정규화하여 반환합니다.
어떤 API를 호출하든 동일한 형식이므로, 클라이언트 코드를 바꿀 필요가 없습니다.
인텐트 예시
실제로 어떤 인텐트가 어떤 API로 매칭되는지 확인해보세요.
| 인텐트 | 선택되는 API | 카테고리 |
|---|---|---|
| "서울 날씨" | 기상청 단기예보 | 날씨 |
| "비트코인 가격" | 업비트 API | 금융 |
| "강남 맛집 찾기" | 카카오 로컬 | 지도 |
| "DART 삼성전자 공시" | 금융감독원 DART | 금융 |
| "인천공항 항공편" | 항공정보 API | 교통 |
직접 API 지정
자동 매칭 대신 특정 API를 직접 지정할 수도 있습니다.
# 자동 매칭
curl "https://api.apifuse.com/resolve?intent=서울 날씨"
# 직접 지정
curl "https://api.apifuse.com/resolve?intent=서울 날씨&api=kma-short-forecast"선택 근거 확인
explain=true 파라미터를 추가하면 유사도 점수와 후보 목록을 확인할 수 있습니다.
/resolve?intent=서울 날씨&explain=true