​
SerperDevTool

여전히 도구를 개선 중이므로 예기치 않은 동작이나 변경 사항이 발생할 수 있습니다.

​
설명

이 도구는 인터넷 상의 텍스트 콘텐츠에서 특정 쿼리에 대한 의미론적 검색을 수행하도록 설계되었다. serper.dev API를 활용해 사용자가 제공한 쿼리와 가장 관련성이 높은 검색 결과를 가져와 표시한다.

​
설치

이 도구를 프로젝트에 적용하려면 아래 설치 방법을 따라 진행한다:

pip install 'crewai[tools]'

​
예제

다음 예제는 도구를 초기화하고 주어진 쿼리로 검색을 실행하는 방법을 보여준다:

from crewai_tools import SerperDevTool

# 인터넷 검색 기능을 위한 도구 초기화
tool = SerperDevTool()

​
시작하기 단계

SerperDevTool을 효과적으로 사용하려면 다음 단계를 따르세요:

  1. 패키지 설치: Python 환경에 crewai[tools] 패키지가 설치되어 있는지 확인하세요.
  2. API 키 획득: serper.dev에서 무료 계정을 등록하여 API 키를 획득하세요.
  3. 환경 설정: 획득한 API 키를 SERPER_API_KEY라는 환경 변수에 저장하여 도구가 사용할 수 있도록 설정하세요.

​
파라미터

SerperDevTool은 API에 전달할 여러 파라미터를 제공한다:

  • search_url: 검색 API의 URL 엔드포인트. 기본값은 https://google.serper.dev/search이다.

  • country: 선택 사항. 검색 결과의 국가를 지정한다.

  • location: 선택 사항. 검색 결과의 위치를 지정한다.

  • locale: 선택 사항. 검색 결과의 로케일을 지정한다.

  • n_results: 반환할 검색 결과의 개수. 기본값은 10이다.

country, location, locale, search_url의 값은 Serper Playground에서 확인할 수 있다.

​
매개변수 활용 예제

추가 매개변수를 사용하여 도구를 활용하는 방법을 보여주는 예제다.

from crewai_tools import SerperDevTool

tool = SerperDevTool(
    search_url="https://google.serper.dev/scholar",
    n_results=2,
)

print(tool.run(search_query="ChatGPT"))

# 도구 사용: 인터넷 검색

# 검색 결과: 제목: 공중 보건에서 ChatGPT의 역할
# 링크: https://link.springer.com/article/10.1007/s10439-023-03172-7
# 요약: … 공중 보건에서 ChatGPT의 잠재적 활용을 살펴본다.
# ---
# 제목: 지구 온난화에서 ChatGPT의 잠재적 활용
# 링크: https://link.springer.com/article/10.1007/s10439-023-03171-8
# 요약: … ChatGPT와 같은 도구가 기후 변화 이해를 발전시키는 데 중요한 역할을 할 수 있다.
# ---

from crewai_tools import SerperDevTool

tool = SerperDevTool(
    country="fr",
    locale="fr",
    location="Paris, Paris, Ile-de-France, France",
    n_results=2,
)

print(tool.run(search_query="Jeux Olympiques"))

# 도구 사용: 인터넷 검색

# 검색 결과: 제목: 파리 2024 올림픽 - 뉴스, 일정, 결과
# 링크: https://olympics.com/fr/paris-2024
# 요약: 파리 2024 올림픽에 참가하는 스포츠 종목은 무엇인가? 육상, 조정, 배드민턴, 농구, 3x3 농구, 복싱, 브레이킹, 카누...
# ---
# 제목: 파리 2024 올림픽 및 패럴림픽 공식 티켓 예매
# 링크: https://tickets.paris2024.org/
# 요약: 세계 최대 스포츠 이벤트에 참여하기 위해 파리 2024 공식 티켓 예매 사이트에서만 티켓을 구매할 수 있다.
# ---

​
결론

SerperDevTool을 Python 프로젝트에 통합하면, 애플리케이션 내에서 실시간으로 인터넷을 검색하고 관련성 높은 결과를 얻을 수 있다. 업데이트된 파라미터를 통해 더욱 맞춤화되고 지역화된 검색 결과를 얻을 수 있다. 제공된 설정과 사용 가이드를 따르면, 이 도구를 프로젝트에 쉽고 빠르게 통합할 수 있다.

Github SearchJSON RAG 검색