7|hdddlmZmZmZddlmZddlmZddlm Z ddl m Z m Z Gdde e Z y) )AnyListOptional)CallbackManagerForRetrieverRun)Document) BaseRetriever) BaseModelFieldceZdZUdZdZeeed< eddZ ee ed<eddZ ee ed <edd Z ee ed <ddZde d eefdZde ded eefdZy)NeedleRetrieveraY NeedleRetriever retrieves relevant documents or context from a Needle collection based on a search query. Setup: Install the `needle-python` library and set your Needle API key. .. code-block:: bash pip install needle-python export NEEDLE_API_KEY="your-api-key" Key init args: - `needle_api_key` (Optional[str]): The API key for authenticating with Needle. - `collection_id` (str): The ID of the Needle collection to search in. - `client` (Optional[NeedleClient]): An optional instance of the NeedleClient. - `top_k` (Optional[int]): Maximum number of results to return. Usage: .. code-block:: python from langchain_community.retrievers.needle import NeedleRetriever retriever = NeedleRetriever( needle_api_key="your-api-key", collection_id="your-collection-id", top_k=10 # optional ) results = retriever.retrieve("example query") for doc in results: print(doc.page_content) NclientzNeedle API Key) descriptionneedle_api_key.z,The ID of the Needle collection to search in collection_idz*Maximum number of search results to return)defaultrtop_kreturnc ddlm}|js||j|_yy#t$r tdwxYw)z Initialize the NeedleClient with the provided API key. If a client instance is already provided, this method does nothing. r) NeedleClientz0Please install with `pip install needle-python`.)api_keyN) needle.v1r ImportErrorr r)selfrs d/var/www/html/test/engine/venv/lib/python3.12/site-packages/langchain_community/retrievers/needle.py_initialize_clientz"NeedleRetriever._initialize_client6sJ  R .{{&t/B/BCDK RPQ Q Rs .Aqueryc|j|j td|jjj |j ||j }|Dcgc]}t|j}}|Scc}w)z Search the Needle collection for relevant documents. Args: query (str): The search query used to find relevant documents. Returns: List[Document]: A list of documents matching the search query. z4NeedleClient is not initialized. Provide an API key.)rtextr) page_content) rr ValueError collectionssearchrrrcontent)rrresultsresultdocss r_search_collectionz"NeedleRetriever._search_collectionDs ! ;; ST T++))00,,5 1 ELL&fnn5LL Ms(B  run_managerc$|j|S)z Retrieve relevant documents based on the query. Args: query (str): The query string used to search the collection. Returns: List[Document]: A list of documents relevant to the query. )r')rrr(s r_get_relevant_documentsz'NeedleRetriever._get_relevant_documentsXs&&u--)rN)__name__ __module__ __qualname____doc__r rr__annotations__r rstrrrintrrrr'rr*r+rr r s D!FHSM ,$)$r9s'&&C-3%\.mY\.r+