U hm@sTdZddlmZmZddlZddlmZmZmZddl m Z dZ GdddeZ dS) zUtil that calls Bing Search.)DictListN) BaseModelFieldroot_validator)get_from_dict_or_envz*https://api.bing.microsoft.com/v7.0/searchc@seZdZUdZeed<eed<dZeed<ee dZ e ed<Gdd d Z eee e d d d Z ed deedddZeedddZeee edddZdS)BingSearchAPIWrapperz Wrapper for Bing Web Search API.bing_subscription_keybing_search_url k)default_factory search_kwargsc@seZdZdZdS)zBingSearchAPIWrapper.ConfigZforbidN)__name__ __module__ __qualname__extrarrM/tmp/pip-unpacked-wheel-9gdii04g/langchain_community/utilities/bing_search.pyConfig%sr) search_termcountreturncCsXd|ji}||ddd|j}tj|j||d}||}d|krT|ddSgS)NzOcp-Apim-Subscription-KeyTZHTML)qrZtextDecorationsZ textFormat)headersparamsZwebPagesvalue)r rrequestsgetr raise_for_statusjson)selfrrrrresponseZsearch_resultsrrr_bing_search_results(s$  z)BingSearchAPIWrapper._bing_search_resultsT)pre)valuesrcCs0t|dd}||d<t|ddtd}||d<|S)z9Validate that api key and endpoint exists in environment.r ZBING_SUBSCRIPTION_KEYr ZBING_SEARCH_URL)default)rDEFAULT_BING_SEARCH_ENDPOINT)clsr%r r rrrvalidate_environment<sz)BingSearchAPIWrapper.validate_environment)queryrcCsFg}|j||jd}t|dkr$dS|D]}||dq(d|S)z.Run query through BingSearch and parse result.rr$No good Bing Search Result was foundsnippet )r#r lenappendjoin)r!r*ZsnippetsresultsresultrrrrunOs zBingSearchAPIWrapper.run)r* num_resultsrcCsXg}|j||d}t|dkr(ddigS|D]&}|d|d|dd}||q,|S) aRun query through BingSearch and return metadata. Args: query: The query to search for. num_results: The number of results to return. Returns: A list of dictionaries with the following keys: snippet - The description of the result. title - The title of the result. link - The link to the result. r+rZResultr,r-nameurl)r-titlelink)r#r/r0)r!r*r5Zmetadata_resultsr2r3Zmetadata_resultrrrr2Zs    zBingSearchAPIWrapper.resultsN)rrr__doc__str__annotations__r intrdictrrrr#rrr)r4r2rrrrrs   r) r:typingrrrZlangchain_core.pydantic_v1rrrZlangchain_core.utilsrr'rrrrrs