AI 에이전트에서 사소한 일마다 웹 검색을 사용하는 것을 멈추세요

Source: Dev.to

AI 에이전트에서 웹 검색의 문제점

AI 에이전트를 구축할 때 “비트코인 가격이 얼마인가요?” 혹은 “런던에 비가 오나요?” 같은 간단한 질문조차도 웹 검색 도구를 호출하게 됩니다. 에이전트는 몇 초 동안 브라우징을 하고, 잡음이 많은 웹 페이지를 스크랩하며, 단 하나의 데이터 조각을 추출하기 위해 수천 개의 토큰을 소비합니다. 이는 동전 하나를 줍기 위해 불도저를 사용하는 것과 같으며, 느리고 비용이 많이 들며 비효율적입니다.

@neuledge/graph 소개

웹 검색에 따른 오버헤드를 없애기 위해 @neuledge/graph 라는 가벼운 조회 도구를 만들었습니다. 이 도구를 사용하면 에이전트가 웹을 서핑하는 대신 특정 “경로”를 요청해 사실을 얻을 수 있습니다.

예시 경로

Weather: cities.tokyo.weather
Stocks:  stocks.aapl.quote
Money:   currencies.usd.rate.eur

데이터가 미리 가져와져 구조화되어 있기 때문에 응답이 100 ms 이하로 반환되며 “검색 중…” 스피너가 나타나지 않습니다. AI가 즉시 지식이 있는 것처럼 보입니다.

누락된 경로 처리

LLM이 때때로 잘못된 경로를 추측할 수 있습니다(예: get_the_weather_of_london). 오류를 반환하는 대신 도구가 올바른 경로를 제안합니다:

“그 정보는 없지만 cities.london.weather 가 있습니다. 대신 이것을 사용하세요.”

에이전트는 제안된 경로로 다시 시도할 수 있어 전체 경험이 더욱 견고해집니다.

왜 중요한가

• API 키가 여러 개 필요 없음 – 하나의 패키지로 날씨, 금융, 통화 서비스용 별도 계정을 대체합니다.
• 프레임워크에 구애받지 않음 – Vercel AI SDK, LangChain 등 다양한 생태계와 함께 사용할 수 있습니다.

현재 기능

• 실시간 날씨 – 전 세계 모든 도시 지원.
• 주식 가격 – 실시간 시세.
• 통화 – 150개 이상의 실시간 환율.
• 시간 및 날짜 – 시간대와 공휴일 캘린더.

모든 기능은 오픈 소스이며 무료로 시작할 수 있습니다. 하루에 100회 요청을 API 키 없이 이용할 수 있습니다.

시작하기

npm install @neuledge/graph

• GitHub: https://github.com/neuledge/graph
• NPM: https://www.npmjs.com/package/@neuledge/graph

향후 계획

다음으로 뉴스와 스포츠 점수를 추가할 예정입니다. 추가 데이터 소스에 대한 제안도 환영합니다!