NgdZddlmZmZmZmZmZmZmZddl m Z m Z ddl m Z ddlmZmZddlmZGddeZGd d e ZGd d e Zd S)zTool for the Tavily search API.)DictListLiteralOptionalTupleTypeUnion)AsyncCallbackManagerForToolRunCallbackManagerForToolRun)BaseTool) BaseModelField)TavilySearchAPIWrapperc6eZdZUdZedZeed<dS) TavilyInputzInput for the Tavily tool.zsearch query to look up) descriptionqueryN)__name__ __module__ __qualname____doc__rrstr__annotations__h/var/www/html/ai-engine/env/lib/python3.11/site-packages/langchain_community/tools/tavily_search/tool.pyrrs6$$#<===E3=====rrc eZdZUdZdZeed<dZeed<eZ e e ed< dZ e ed< d Zeed < gZeeed < gZeeed < d Zeed< d Zeed< d Zeed< eeZeed<dZeded< ddedeedeeeeeefefeffdZ ddedee!deeeeeefefeffdZ"dS)TavilySearchResultsan Tool that queries the Tavily Search API and gets back json. Setup: Install ``langchain-openai`` and ``tavily-python``, and set environment variable ``TAVILY_API_KEY``. .. code-block:: bash pip install -U langchain-community tavily-python export TAVILY_API_KEY="your-api-key" Instantiate: .. code-block:: python from langchain_community.tools import TavilySearchResults tool = TavilySearchResults( max_results=5, include_answer=True, include_raw_content=True, include_images=True, # search_depth="advanced", # include_domains = [] # exclude_domains = [] ) Invoke directly with args: .. code-block:: python tool.invoke({'query': 'who won the last french open'}) .. code-block:: python '{ "url": "https://www.nytimes.com...", "content": "Novak Djokovic won the last French Open by beating Casper Ruud ...' Invoke with tool call: .. code-block:: python tool.invoke({"args": {'query': 'who won the last french open'}, "type": "tool_call", "id": "foo", "name": "tavily"}) .. code-block:: python ToolMessage( content='{ "url": "https://www.nytimes.com...", "content": "Novak Djokovic won the last French Open by beating Casper Ruud ...', artifact={ 'query': 'who won the last french open', 'follow_up_questions': None, 'answer': 'Novak ...', 'images': [ 'https://www.amny.com/wp-content/uploads/2023/06/AP23162622181176-1200x800.jpg', ... ], 'results': [ { 'title': 'Djokovic ...', 'url': 'https://www.nytimes.com...', 'content': "Novak...", 'score': 0.99505633, 'raw_content': 'Tennis Novak ...' }, ... ], 'response_time': 2.92 }, tool_call_id='1', name='tavily_search_results_json', ) tavily_search_results_jsonnamezA search engine optimized for comprehensive, accurate, and trusted results. Useful for when you need to answer questions about current events. Input should be a search query.r args_schema max_resultsadvanced search_depthinclude_domainsexclude_domainsFinclude_answerinclude_raw_contentinclude_imagesdefault_factory api_wrappercontent_and_artifactresponse_formatNr run_managerreturnc " |j||j|j|j|j|j|j|j}n(#t$r}t|ifcYd}~Sd}~wwxYw|j |d|fS) Use the tool.Nresults) r- raw_resultsr#r%r&r'r(r)r* Exceptionrepr clean_resultsselfrr0r5es r_runzTavilySearchResults._runs *66 !$$#(#  KK   77B;       --k).DEE{RRsAA A,A'!A,'A,c 2K |j||j|j|j|j|j|j|jd{V}n(#t$r}t|ifcYd}~Sd}~wwxYw|j |d|fS)Use the tool asynchronously.Nr4) r-raw_results_asyncr#r%r&r'r(r)r*r6r7r8r9s r_arunzTavilySearchResults._aruns  $ 0 B B !$$#(# ! !      KK   77B;       --k).DEE{RRsA A A4A/)A4/A4N)#rrrrr rrrrr!rr r#intr%r&rr'r(boolr)r*rrr-r/rrr rr rr<r r@rrrrrsFFP-D#,,, * $/Ki...#K4"L#""""$OT#Y### "$OT#Y### !ND    !&%%% !ND   +0%@V*W*W*WK'WWW7MOW34MMM <@SSS78S uT$sCx.)3./5 6 SSSS2AESSS<=S uT$sCx.)3./5 6 SSSSSSrrc eZdZUdZdZeed<dZeed<ee Z e ed<e Z e eed< dd ed eed eeeeffd Z dd ed eed eeeeffdZd S) TavilyAnswerz@Tool that queries the Tavily Search API and gets back an answer. tavily_answerr zA search engine optimized for comprehensive, accurate, and trusted results. Useful for when you need to answer questions about current events. Input should be a search query. This returns only the answer - not the original source data.rr+r-r!Nrr0r1c |j|ddddS#t$r}t|cYd}~Sd}~wwxYw)r3r"Tbasicr#r(r%answerN)r-r5r6r7)r:rr0r;s rr<zTavilyAnswer._runss  #//#$ 0       77NNNNNN s#& A AA A cK |j|dddd{V}|dS#t$r}t|cYd}~Sd}~wwxYw)r>r"TrHrINrJ)r-r?r6r7)r:rr0resultr;s rr@zTavilyAnswer._aruns +==#$ >F (# #   77NNNNNN s+0 AAAArA)rrrrr rrrrrr-rr!rr rr r rrr<r r@rrrrErEsJJD# G +0%@V*W*W*WK'WWW#.Ki... <@78 tDz3  &AE<= tDz3  rrEN)rtypingrrrrrrr langchain_core.callbacksr r langchain_core.toolsr pydanticr r+langchain_community.utilities.tavily_searchrrrrErrrrRs@%%DDDDDDDDDDDDDDDDDD*)))))%%%%%%%%NNNNNN>>>>>)>>> iSiSiSiSiS(iSiSiSX,,,,,8,,,,,r