LinkUp Search 도구

LinkUp Search 도구 (LinkupSearchTool)

CrewAI의 LinkupSearchTool은 Linkup API에 쿼리해서 맥락 정보를 얻고 구조화된 결과를 검색하는 도구예요. Linkup의 최신·신뢰할 수 있는 정보로 워크플로를 풍부하게 만들고 싶을 때 이상적이며, 에이전트가 태스크 중에 관련 데이터에 접근할 수 있게 해줍니다.

출처: 문서

본문

LinkupSearchTool은 맥락 정보를 위해 Linkup API에 쿼리하고 구조화된 결과를 검색하는 기능을 제공합니다. Linkup의 최신·신뢰할 수 있는 정보로 워크플로를 풍부하게 하는 데 이상적이며, 에이전트가 태스크 중에 관련 데이터에 접근할 수 있게 해줘요.

설치 (Installation)

이 도구를 사용하려면 Linkup SDK를 설치해야 합니다.

uv add linkup-sdk

시작하는 방법 (Steps to Get Started)

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

API Key: Linkup API 키를 받으세요.
환경 설정: API 키로 환경을 설정하세요.
SDK 설치: 위 명령으로 Linkup SDK를 설치하세요.

예시 (Example)

다음 예시는 도구를 초기화하고 에이전트에서 사용하는 방법을 보여줍니다.

from crewai_tools import LinkupSearchTool
from crewai import Agent
import os

# API 키로 도구 초기화
linkup_tool = LinkupSearchTool(api_key=os.getenv("LINKUP_API_KEY"))

# 이 도구를 사용하는 에이전트 정의
@agent
def researcher(self) -> Agent:
    '''
    This agent uses the LinkupSearchTool to retrieve contextual information
    from the Linkup API.
    '''
    return Agent(
        config=self.agents_config["researcher"],
        tools=[linkup_tool]
    )

파라미터 (Parameters)

LinkupSearchTool은 다음 파라미터를 받습니다.

생성자 파라미터 (Constructor Parameters)

api_key: 필수. 사용자의 Linkup API 키.

실행 파라미터 (Run Parameters)

query: 필수. 검색어 또는 문구.
depth: 선택. 검색 심도. 기본값은 "standard".
output_type: 선택. 출력 유형. 기본값은 "searchResults".

고급 사용법 (Advanced Usage)

더 구체적인 결과를 위해 검색 파라미터를 커스터마이즈할 수 있어요.

# 커스텀 파라미터로 검색 수행
results = linkup_tool.run(
    query="Women Nobel Prize Physics",
    depth="deep",
    output_type="searchResults"
)

반환 형식 (Return Format)

이 도구는 다음과 같은 형식으로 결과를 반환합니다.

{
  "success": true,
  "results": [
    {
      "name": "Result Title",
      "url": "https://example.com/result",
      "content": "Content of the result..."
    },
    // Additional results...
  ]
}

오류가 발생하면 응답은 다음과 같습니다.

{
  "success": false,
  "error": "Error message"
}

에러 처리 (Error Handling)

이 도구는 API 오류를 우아하게 처리하고 구조화된 피드백을 제공합니다. API 요청이 실패하면 success: false와 오류 메시지가 포함된 딕셔너리를 반환합니다.

결론 (Conclusion)

LinkupSearchTool은 Linkup의 맥락 정보 검색 기능을 CrewAI 에이전트에 원활하게 통합하는 방법을 제공합니다. 이 도구를 활용하면 에이전트가 관련성 있고 최신 정보에 접근하여 의사결정과 태스크 실행을 개선할 수 있어요.

LinkUp Search 도구