3fidZddlmZmZmZmZddlmZddlm Z ddl m Z ddl m Z mZmZGdde ZGd d e ZGd d e Zy )zUtil that calls Google Search.)AnyDictListOptional)CallbackManagerForToolRun)BaseTool)get_from_dict_or_env) BaseModel ConfigDictmodel_validatorc eZdZUdZdZeed<dZee ed< dZ ee ed< dZ e ed< dZ eed < ed Zd e d edeefdZedededefdZde de fdZ dde de deee e fdeefdZy)GoogleSearchAPIWrapperaTWrapper for Google Custom Search API. Performs web searches using Google Custom Search API and returns results with snippets, titles, and links. !!! note "Setup Required" 1. Enable [Custom Search API](https://console.cloud.google.com/apis/library/customsearch.googleapis.com) 2. Create API key in [Google Cloud Console](https://console.cloud.google.com/apis/credentials) 3. Create custom search engine at [Programmable Search Engine](https://programmablesearchengine.google.com) 4. Set `GOOGLE_API_KEY` and `GOOGLE_CSE_ID` environment variables N search_enginegoogle_api_key google_cse_id kF siterestrictforbid)extra search_termkwargsreturnc |jj}|jr|j}|jd||jd|j }|j dgS)N)qcxitems)rcserlistrexecuteget)selfrrrress _/var/www/auto_recruiter/arenv/lib/python3.12/site-packages/langchain_google_community/search.py_google_search_resultsz-GoogleSearchAPIWrapper._google_search_results+sg  $$&   ""$CchhF););FvFNNPwww##before)modevaluesct|dd}||d<t|dd}||d< ddlm}|dd | }||d <|S#t$r tdwxYw) z?Validate that api key and python package exists in environment.rGOOGLE_API_KEYr GOOGLE_CSE_IDr)buildzjgoogle-api-python-client is not installed. Please install it with `pip install langchain-google-community` customsearchv1) developerKeyr)r googleapiclient.discoveryr. ImportError)clsr*rrr.services r%validate_environmentz+GoogleSearchAPIWrapper.validate_environment2s. $&6 $2 ,V_oV "/  7>J")  R  s >Aquerycg}|j||j}t|dk(ry|D]}d|vs|j|ddj |S)z1Run query through Google Search and parse result.)numr&No good Google Search Result was foundsnippet )r&rlenappendjoin)r#r7snippetsresultsresults r%runzGoogleSearchAPIWrapper.runLsh--e-@ w<1 ; 3FF"y 12 3xx!!r' num_results search_paramscg}|j|fd|i|xsi}t|dk(rddigS|D]*}|d|dd}d|vr|d|d<|j|,|S) aCRun query through Google Search and return metadata. Args: query: The query to search for. num_results: Number of results to return. search_params: Additional search parameters. Returns: Search results with snippet, title, and link for each result. r9rResultr:titlelink)rHrIr;)r&r=r>)r#r7rDrEmetadata_resultsrArBmetadata_results r%rAzGoogleSearchAPIWrapper.resultsXs -$--  " '4':  w<1 GHI I 5FvOF"-3I-> *  # #O 4 5 r'N)__name__ __module__ __qualname____doc__rr__annotations__rrstrrrintrboolr model_configrdictr&r classmethodrr6rCrArr'r%rr s M3$(NHSM(,#'M8C='" AsK&L$7L$#$$d$(#$3$0 " " " 37     S#X/  d  r'rcVeZdZUdZdZeed<dZeed<eed< d ded e e d efd Z y) GoogleSearchRunzTool that queries the Google Custom Search API. Inherits from [`BaseTool`][langchain_core.tools.BaseTool]. Returns concatenated snippets from search results. google_searchnamezA wrapper around Google Search. Useful for when you need to answer questions about current events. Input should be a search query. description api_wrapperNr7 run_managerrc8|jj|S)zExecute the Google search. Args: query: Search query string. run_manager: Optional callback manager. Returns: Concatenated snippets from search results. )r]rCr#r7r^s r%_runzGoogleSearchRun._runs##E**r'rL) rMrNrOrPr[rRrQr\rrrrarr'r%rYrYzsY D# * (' <@++78+ +r'rYcdeZdZUdZdZeed<dZeed<dZe ed<e ed< dd ed e e d efd Z y )GoogleSearchResultszTool that queries the Google Custom Search API and returns JSON. Inherits from [`BaseTool`][langchain_core.tools.BaseTool]. Returns structured search results with metadata. google_search_results_jsonr[zA wrapper around Google Search. Useful for when you need to answer questions about current events. Input should be a search query. Output is a JSON array of the query resultsr\rDr]Nr7r^rc`t|jj||jS)aExecute the Google search and return structured results. Args: query: Search query string. run_manager: Optional callback manager. Returns: JSON string of search results with title, link, and snippet. )rRr]rArDr`s r%razGoogleSearchResults._runs(4##++E43C3CDEEr'rL)rMrNrOrPr[rRrQr\rDrSrrrrarr'r%rcrcsh-D#, V K'' <@FF78F Fr'rcN)rPtypingrrrrlangchain_core.callbacksrlangchain_core.toolsrlangchain_core.utilsr pydanticr r r rrYrcrr'r%rlsG$,,>)5;;l Yl ^+h+BF(Fr'