Skip to main content

SerperDevTool

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

설명

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

설치

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

예제

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

시작하기 단계

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에서 확인할 수 있다.

매개변수 활용 예제

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

결론

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