dhڽSSKrSSKrSSKJrJr SSKJrJrJrJ r J r J r J r J r JrJr SSKrSSKJr SSKJr SSKJr SSKJr SSKJrJr \(aSS KJr \R>"\ 5r!"S S \5r"\"S S SS9"SS\"55r#\"S S SS9"SS\"55r$\"S S SS9"SS\"55r%\"S S SS9"SS\55r&g)N)ABCabstractmethod) TYPE_CHECKINGAnyCallableDictIterableListLiteralOptionalTupleUnion) deprecated)Document) Embeddings) VectorStore)DistanceStrategymaximal_marginal_relevance) Elasticsearchc\rSrSrSr\S\\\S4S\\ S4S\ S\ S\ S \ S \\ S \\ S4S \ 4S j5r\S\\ S4S\ S \\ S4S \ 4Sj5rSSS \ S\ S S4SjrS \4SjrSrg)BaseRetrievalStrategy"z4Base class for `Elasticsearch` retrieval strategies. query_vectorNquerykfetch_kvector_query_field text_fieldfilter similarityreturncg)a Executes when a search is performed on the store. Args: query_vector: The query vector, or None if not using vector-based query. query: The text query, or None if not using text-based query. k: The total number of results to retrieve. fetch_k: The number of results to fetch initially. vector_query_field: The field containing the vector representations in the index. text_field: The field containing the text data in the index. filter: List of filter clauses to apply to the query. similarity: The similarity strategy to use, or None if not using one. Returns: Dict: The Elasticsearch query body. N selfrrrrrrrr s f/var/www/html/shao/venv/lib/python3.13/site-packages/langchain_community/vectorstores/elasticsearch.pyrBaseRetrievalStrategy.query% dims_lengthcg)a Executes when the index is created. Args: dims_length: Numeric length of the embedding vectors, or None if not using vector-based query. vector_query_field: The field containing the vector representations in the index. similarity: The similarity strategy to use, or None if not using one. Returns: Dict: The Elasticsearch settings and mappings for the strategy. Nr#r%r*rr s r&indexBaseRetrievalStrategy.indexEr(r)clientrcg)aM Executes before the index is created. Used for setting up any required Elasticsearch resources like a pipeline. Args: client: The Elasticsearch client. text_field: The field containing the text data in the index. vector_query_field: The field containing the vector representations in the index. Nr#r%r/rrs r&before_index_setup(BaseRetrievalStrategy.before_index_setup[r(r)cg)z Returns whether or not the strategy requires inference to be performed on the text before it is added to the index. Returns: bool: Whether or not the strategy requires inference to be performed on the text before it is added to the index. Tr#r%s r&require_inference'BaseRetrievalStrategy.require_inferenceisr)r#)__name__ __module__ __qualname____firstlineno____doc__rrr floatstrintdictrrrr-r2boolr6__static_attributes__r#r)r&rr"s> DK-. S$Y        T  *D01    > 39%   *D01     *  %  36  LO     4 r)rz0.0.27z,Use class in langchain-elasticsearch packageT) alternativependingc\rSrSrSrSS\\S\\S\\\ \44Sjjr S\\ \ S4S \\S4S \ S \ S \S \S\ \ S\\S4S\4SjrS\\ S4S \S\\S4S\4SjrSrg)ApproxRetrievalStrategyuz:Approximate retrieval strategy using the `HNSW` algorithm.Nquery_model_idhybridrrfc(XlX lX0lgNrHrIrJ)r%rHrIrJs r&__init__ ApproxRetrievalStrategy.__init__{s - r)rrrrrrrr r!c UUUUS.n U(aUR(dXS'O8U(a&UR(aSURUS.0U S'O [S5eUR(azU SSUS U000/US .0S .n [UR[ 5(aS UR0U S 'U $[UR[ 5(aURSLaS 00U S 'U $SU 0$)N)rfieldrnum_candidatesrtext_embeddingmodel_id model_textquery_vector_builderzZYou must provide an embedding function or a query_model_id to perform a similarity search.rAmatchrmustr)knnrrJrankTr[)rH ValueErrorrI isinstancerJr@rA) r%rrrrrrrr r[ query_bodys r&rApproxRetrievalStrategy.querys'%    3 3". t** $ 3 3"'#+C& 'B  ;;!($.(/1&*"!#)  J$$((D))&+TXX%6 6" DHHd++D0@&+R[ 6" 3< r)r*cU[RLaSnOQU[RLaSnO;U[RLaSnO%U[RLaSnO[ SUS35eSSUS US US .000$) /Create the mapping for the Elasticsearch index.cosinel2_norm dot_productmax_inner_product Similarity  not supported.mappings properties dense_vectorT)typedimsr-r )rCOSINEEUCLIDEAN_DISTANCE DOT_PRODUCTMAX_INNER_PRODUCTr])r%r*rr similarityAlgos r&r-ApproxRetrievalStrategy.indexs )00 0%N +>> >&N +77 7*N +== =0N{:,oFG G & . +!%&4 )   r))rIrHrJNFT)r8r9r:r;r<r r>rArr@rNr r=r?rrrr-rBr#r)r&rFrFusE)-!&+/     eD$J' ( D DK-.D S$YD   D  D  D D T D *D01D  D L 39%   *D01    r)rFc\rSrSrSrS\\\S4S\\S4S\ S\ S\S \S \\\ S4S \\ S4S \ 4S jr S\\ S4S\S \\ S4S \ 4SjrSrg)ExactRetrievalStrategyz8Exact retrieval strategy using the `script_score` query.rNrrrrrrr r!c U[RLaSUS3n OCU[RLaSUS3n O)U[RLaSUS3n O[ SUS35eS 00n U(aS S U00n S S U U SU0S.S.00$)Nz'cosineSimilarity(params.query_vector, 'z') + 1.0z&1 / (1 + l2norm(params.query_vector, 'z'))z= double value = dotProduct(params.query_vector, 'z?'); return sigmoid(1, Math.E, -value); rgrh match_allrArr script_scorer)sourceparams)rscript)rrnrorpr]) r%rrrrrrrr rr queryBools r&rExactRetrievalStrategy.querys )00 09:L9MXV +>> >89K8LCP +77 7"==Or?r@rrrr-rBr#r)r&rvrvsC) DK-.) S$Y)   )  )  ) ) d4j$&') *D01)  ) V 39%   *D01    r)rvc\rSrSrSrSS\\4SjjrS\\ \ S4S\\S4S\ S \ S \S \S \ \ S \\ S4S\4SjrS\4SjrSSS \S \SS4SjrS\\ S4S \S \\ S4S\4SjrS\4SjrSrg)SparseRetrievalStrategyi6z?Sparse retrieval strategy using the `text_expansion` processor.NrUc$U=(d SUlg)Nz.elser_model_1rU)r%rUs r&rN SparseRetrievalStrategy.__init__<s 4$4 r)rrrrrrrr r!c >SSSUS3URUS.00/US.00$)NrrAtext_expansionz.tokensrTrYrr$s r&rSparseRetrievalStrategy.query?sR -#5"6g >04 27A"/ %   r)c URS3$)N_sparse_embeddingrr5s r&_get_pipeline_name*SparseRetrievalStrategy._get_pipeline_name\s-- 122r)r/rc UR(aBURRUR5SSURUUS0SSS00S.0/S9 gg) Nz,Embedding pipeline for langchain vectorstore inferencerr results_fieldtokens)rU target_field field_mapinference_config)id description processors)rUingest put_pipelinerr1s r&r2*SparseRetrievalStrategy.before_index_setup_sk == MM & &**,J$(, ,>*4l)C 0?H2M1 &   '  r)r*c@SUSSSS00000SUR50S.$)Nrjrrl rank_featuresdefault_pipeline)risettings)rr,s r&r-SparseRetrievalStrategy.indexusE&$x&/1J&K),T-D-D-FG  r)cg)NFr#r5s r&r6)SparseRetrievalStrategy.require_inferencesr)rrL)r8r9r:r;r<r r>rNrr r=r?r@rrrrr2r-rAr6rBr#r)r&rr6sJ5#5 DK-. S$Y         T  *D01   :3C3%36LO , 39%   *D01    "4r)rc\rSrSrSrSSSSSSSSSS\"5SS. S\S\\S \S S \\S \\S \\S\\S\\S\S\S\\ \ R\ R\ R\ R4S\S\\\\44Sjjr\S\4Sj5r\SSSSSSS.S \\S\\S\\S\\S\\S\\\\4SS 4Sjj5r\S\\4Sj5rSMS\S \S!\S"\\\S#\S\\4 S$jjrSNS\S \S!\S%\S&\\\S#\S\\4S'jjr\S(\S\4S)j5rS\ \/\44S*jr!SOS\S \S"\\\S#\S\\"\\44 S+jjr#SOS\\S \S"\\\S#\S\\"\\44 S,jjr$SPS\\S \S-\%\\S4S!\S&\\\S"\\\S.\\ \\%\S4/\4S/\\ \/\4S#\S\\"\\44S0jjr&SQS1\\\S2\\'S#\S\\'4S3jjr(SRS\S4\\SS4S5jjr)SSS6\*\S7\\\\S8\\\\\4S1\\\S2\'S9\'S:\\S#\S\\4S;jjr+SSS6\*\S8\\\\\4S1\\\S2\'S9\'S:\\S#\S\\4S<jjr,SSS=\*\"\\\4S8\\\S1\\\S2\'S9\'S:\\S#\S\\4S>jjr-\.STS6\\S\\S8\\\\\4S:\\S#\SS4 S?jj5r/\SRS\\S#\SS4S@jj5r0\.SUSA\\S\\S:\\S#\SS4 SBjj5r1\SVSCj5r2\SWSD\\SE\\'SF\\%\\'4SSG4SHjj5r\SRSI\\SSJ4SKjj5r3SLr4g)XElasticsearchStoreia;`Elasticsearch` vector store. Example: .. code-block:: python from langchain_community.vectorstores import ElasticsearchStore from langchain_community.embeddings.openai import OpenAIEmbeddings vectorstore = ElasticsearchStore( embedding=OpenAIEmbeddings(), index_name="langchain-demo", es_url="http://localhost:9200" ) Args: index_name: Name of the Elasticsearch index to create. es_url: URL of the Elasticsearch instance to connect to. cloud_id: Cloud ID of the Elasticsearch instance to connect to. es_user: Username to use when connecting to Elasticsearch. es_password: Password to use when connecting to Elasticsearch. es_api_key: API key to use when connecting to Elasticsearch. es_connection: Optional pre-existing Elasticsearch connection. vector_query_field: Optional. Name of the field to store the embedding vectors in. query_field: Optional. Name of the field to store the texts in. strategy: Optional. Retrieval strategy to use when searching the index. Defaults to ApproxRetrievalStrategy. Can be one of ExactRetrievalStrategy, ApproxRetrievalStrategy, or SparseRetrievalStrategy. distance_strategy: Optional. Distance strategy to use when searching the index. Defaults to COSINE. Can be one of COSINE, EUCLIDEAN_DISTANCE, MAX_INNER_PRODUCT or DOT_PRODUCT. If you want to use a cloud hosted Elasticsearch instance, you can pass in the cloud_id argument instead of the es_url argument. Example: .. code-block:: python from langchain_community.vectorstores import ElasticsearchStore from langchain_community.embeddings.openai import OpenAIEmbeddings vectorstore = ElasticsearchStore( embedding=OpenAIEmbeddings(), index_name="langchain-demo", es_cloud_id="" es_user="elastic", es_password="" ) You can also connect to an existing Elasticsearch instance by passing in a pre-existing Elasticsearch connection via the es_connection argument. Example: .. code-block:: python from langchain_community.vectorstores import ElasticsearchStore from langchain_community.embeddings.openai import OpenAIEmbeddings from elasticsearch import Elasticsearch es_connection = Elasticsearch("http://localhost:9200") vectorstore = ElasticsearchStore( embedding=OpenAIEmbeddings(), index_name="langchain-demo", es_connection=es_connection ) ElasticsearchStore by default uses the ApproxRetrievalStrategy, which uses the HNSW algorithm to perform approximate nearest neighbor search. This is the fastest and most memory efficient algorithm. If you want to use the Brute force / Exact strategy for searching vectors, you can pass in the ExactRetrievalStrategy to the ElasticsearchStore constructor. Example: .. code-block:: python from langchain_community.vectorstores import ElasticsearchStore from langchain_community.embeddings.openai import OpenAIEmbeddings vectorstore = ElasticsearchStore( embedding=OpenAIEmbeddings(), index_name="langchain-demo", es_url="http://localhost:9200", strategy=ElasticsearchStore.ExactRetrievalStrategy() ) Both strategies require that you know the similarity metric you want to use when creating the index. The default is cosine similarity, but you can also use dot product or euclidean distance. Example: .. code-block:: python from langchain_community.vectorstores import ElasticsearchStore from langchain_community.embeddings.openai import OpenAIEmbeddings from langchain_community.vectorstores.utils import DistanceStrategy vectorstore = ElasticsearchStore( "langchain-demo", embedding=OpenAIEmbeddings(), es_url="http://localhost:9200", distance_strategy="DOT_PRODUCT" ) Nvectortext) embedding es_connectiones_url es_cloud_ides_user es_api_key es_passwordr query_fielddistance_strategystrategy es_params index_namerrrrrrrrrrrrrc zX lXlXlXlU c[R O[U UlXlUbK[UR5nURSUR505 URUS9Ul gUcUb[RUUUUUU S9Ul g[!S5e)N user-agent)headers)rusernamepasswordcloud_idapi_keyrz{Either provide a pre-existing Elasticsearch connection, or valid credentials for creating a new connection.)rrrrrrnrrr@_headersupdateget_user_agentoptionsr/rconnect_to_elasticsearchr])r%rrrrrrrrrrrrrrs r&rNElasticsearchStore.__init__s0#$&"4!(  # #!"34  !  $=112G NNL$*=*=*?@ A'///@DK  ;#:,EE $$"# FDKG r)r!cSSKJn SU3$)Nr __version__zlangchain-py-vs/)langchain_communityrrs r&r!ElasticsearchStore.get_user_agent2s3!+//r))rrrrrrrrrrcSSKnU(aU(a [S5e0nU(aU/US'OU(aXS'O [S5eU(aX'S'OU(a U(aX44US'UbURU5 UR"S 0UDS S [ R 500D6nUR5 U$![a [S5ef=f![an [RS U 35 U eSn A ff=f) NrbCould not import elasticsearch python package. Please install it with `pip install elasticsearch`.z>Both es_url and cloud_id are defined. Please provide only one.hostsrz4Please provide either elasticsearch_url or cloud_id.r basic_authrrz#Error connecting to Elasticsearch: r#) elasticsearch ImportErrorr]rrrrinfo Exceptionloggererror) rrrrrrrconnection_params es_clientes r&r+ElasticsearchStore.connect_to_elasticsearch8s   hP -/ *0 g & ,4j )ST T +2i ( (/7.B l +   $ $Y /!//  !#5#D#D#FG   NN  M F  D  LL>qcB CG s#B7%C7C  C9C44C9cUR$rL)rr5s r& embeddingsElasticsearchStore.embeddingsls ~~r)rrrrkwargsc dUR"SXX4S.UD6nUVVs/sHupxUPM snn$s snnf)aReturn Elasticsearch documents most similar to query. Args: query: Text to look up documents similar to. k: Number of Documents to return. Defaults to 4. fetch_k (int): Number of Documents to fetch to pass to knn num_candidates. filter: Array of Elasticsearch filter clauses to apply to the query. Returns: List of Documents most similar to the query, in descending order of similarity. )rrrrr#)_search) r%rrrrrresultsdoc_s r&similarity_search$ElasticsearchStore.similarity_searchps@*,, g @F #**''***s , lambda_multfieldsc >URc [S5eSnUcUR/nO.URU;aURUR5 OSnURR U5nUR "SXUS.UD6n U V V s/sHupU R URPM n n n [[R"U5XUS9n U Vs/sH oUSPM nnU(a UHn U R UR M U$s sn n fs snf)aReturn docs selected using the maximal marginal relevance. Maximal marginal relevance optimizes for similarity to query AND diversity among selected documents. Args: query (str): Text to look up documents similar to. k (int): Number of Documents to return. Defaults to 4. fetch_k (int): Number of Documents to fetch to pass to MMR algorithm. lambda_mult (float): Number between 0 and 1 that determines the degree of diversity among the results with 0 corresponding to maximum diversity and 1 to minimum diversity. Defaults to 0.5. fields: Other fields to get from elasticsearch source. These fields will be added to the document metadata. Returns: List[Document]: A list of Documents selected by maximal marginal relevance. z5You must provide an embedding function to perform MMRTF)rrr)rrrr#) rr]rappend embed_queryrmetadatarnparray)r%rrrrrr'remove_vector_query_field_from_metadataquery_embeddinggot_docsrrgot_embeddingsselected_indicesi selected_docss r&max_marginal_relevance_search0ElasticsearchStore.max_marginal_relevance_searchs*8 >> !TU U26/ >--.F  $ $F 2 MM$11 26; 3..44U;<< (F FL  OWWhFC#,,t'>'>?hW6 HH_ %~RS 2BB1AA!Q1A B 2$LL!8!89%X Cs $DDscorecU$rLr#)rs r& _identity_fnElasticsearchStore._identity_fns r)cUR$)aK The 'correct' relevance function may differ depending on a few things, including: - the distance / similarity metric used by the VectorStore - the scale of your embeddings (OpenAI's are unit normed. Many others are not!) - embedding dimensionality - etc. Vectorstores should define their own selection based method of relevance. )rr5s r&_select_relevance_score_fn-ElasticsearchStore._select_relevance_score_fns   r)c [UR[5(a&URR(a [ S5eUR "SXUS.UD6$)aLReturn Elasticsearch documents most similar to query, along with scores. Args: query: Text to look up documents similar to. k: Number of Documents to return. Defaults to 4. filter: Array of Elasticsearch filter clauses to apply to the query. Returns: List of Documents most similar to the query and score for each 1scores are currently not supported in hybrid mode)rrrr#r^rrFrIr]r)r%rrrrs r&similarity_search_with_score/ElasticsearchStore.similarity_search_with_scoresG dmm%< = =$--BVBVPQ Q||F%VFvFFr)c [UR[5(a&URR(a [ S5eUR "SXUS.UD6$)aYReturn Elasticsearch documents most similar to query, along with scores. Args: embedding: Embedding to look up documents similar to. k: Number of Documents to return. Defaults to 4. filter: Array of Elasticsearch filter clauses to apply to the query. Returns: List of Documents most similar to the embedding and score for each r)rrrr#r)r%rrrrs r&1similarity_search_by_vector_with_relevance_scoresDElasticsearchStore.similarity_search_by_vector_with_relevance_scoressG" dmm%< = =$--BVBVPQ Q||QQ&QQr)r custom_query doc_builderc ^Uc/nSU;aURS5 TRU;aURTR5 TR(a!UbUcTRRU5nTRR UUUUTR TRU=(d /TRS9n [RSU 35 Ub U"X5n [RSU 35 TRR"S STR0U DUUS.D6n S[S[4U4S jjn U=(d U n/n U S S HhnUHCnXS ;dM USTR4;dM!SUS ;a0US S'US UUS SU'ME U RU"U5US 45 Mj U $)aReturn Elasticsearch documents most similar to query, along with scores. Args: query: Text to look up documents similar to. k: Number of Documents to return. Defaults to 4. query_vector: Embedding to look up documents similar to. fetch_k: Number of candidates to fetch from each shard. Defaults to 50. fields: List of fields to return from Elasticsearch. Defaults to only returning the text field. filter: Array of Elasticsearch filter clauses to apply to the query. custom_query: Function to modify the Elasticsearch query body before it is sent to Elasticsearch. Returns: List of Documents most similar to the query and score for each r)rrrrrrrr z Query body: z&Calling custom_query, Query body now: r-)sizer{hitr!c^>[USRTRS5USSS9$)N_sourcer) page_contentr)rgetr)rr%s r&default_doc_builder7ElasticsearchStore._search..default_doc_builderCs6 ^//0@0@"EY 3 r)hitsr_scorer#)rrrrrrrrrdebugr/searchrrr)r%rrrrrrrrrr_responserdocs_and_scoresrrQs` r&rElasticsearchStore._searchs: >F V # MM* %   6 ) MM$** + >>e/L4H>>55eURRRUS9(a[R SUS35 gUc*UR R 5(a [S5eUR RURURURS9 UR RURUURS9n[R SUS US 35 URRR"S S U0UD6 g) zCreate the Elasticsearch index if it doesn't already exist. Args: index_name: Name of the Elasticsearch index to create. dims_length: Length of the embedding vectors. )r-zIndex z# already exists. Skipping creation.NzCannot create index without specifying dims_length when the index doesn't already exist. We infer dims_length from the first embedding. Check that you have provided an embedding function.)r/rr)rr*r zCreating index z with mappings rir-r#)r/indicesexistsrr rr6r]r2rrr-rcreate)r%rr* indexSettingss r&_create_index_if_not_exists.ElasticsearchStore._create_index_if_not_existss  ;;   % %J % 7 LL6*-PQ R"t}}'F'F'H'H ? MM , ,{{++#'#:#: -  !MM//#'#:#:'110M LL!*_]:=VO0nSSSURURUSUS XN0nU(aX.UUR'U RU5 M_ [U 5S:aRU "URU 4S US .UD6unn[R!S US US35 [R!SUS35 U$[R!S5 /$![a [S5ef=fs sn f!U aun[R#SU35 UR$SR'S05R'S05n[R#SUR'S535 UeSnAff=f)Nrrr)rr*rr-rrrT) stats_onlyrzAdded z and failed to add z texts to indexz added texts z to indexzError adding texts: rrrzNo texts to add to index)rrrrr>uuiduuid4rr)r enumeraterrrr/rr rr r)r%r+rr,rrr-r.rrrrrequestsr*rrrrequestsuccessfailedrr"s r&__addElasticsearchStore.__adds  B "'R 77Ac$**,'7 %!*Q-0 "  , ,??  - !'GA'0y|bHG$//  $Hsv G3==//0 OOG $( x=1  "&KK# $+ # " # WI%8P |C5 :;  LL3 4Is F   8V"  3A378XXa[__Wb9==grJ  3JNN84L3MNO  s*E+'FAF +F HA0G??Hc URb%URR[U55nOSnURUUUUUUUUS9$)aRun more texts through the embeddings and add to the vectorstore. Args: texts: Iterable of strings to add to the vectorstore. metadatas: Optional list of metadatas associated with the texts. ids: Optional list of ids to associate with the texts. refresh_indices: Whether to refresh the Elasticsearch indices after adding the texts. create_index_if_not_exists: Whether to create the Elasticsearch index if it doesn't already exist. *bulk_kwargs: Additional arguments to pass to Elasticsearch bulk. - chunk_size: Optional. Number of texts to add to the index at a time. Defaults to 500. Returns: List of ids from adding the texts into the vectorstore. Nr,rrr-r.r)rembed_documentslist_ElasticsearchStore__add) r%r+r,rrr-r.rrs r& add_textsElasticsearchStore.add_textss]6 >> %77U DJJzz  +'A#  r)text_embeddingsc f[U6upUR[U5[U 5UUUUUUS9$)aAdd the given texts and embeddings to the vectorstore. Args: text_embeddings: Iterable pairs of string and embedding to add to the vectorstore. metadatas: Optional list of metadatas associated with the texts. ids: Optional list of unique IDs. refresh_indices: Whether to refresh the Elasticsearch indices after adding the texts. create_index_if_not_exists: Whether to create the Elasticsearch index if it doesn't already exist. *bulk_kwargs: Additional arguments to pass to Elasticsearch bulk. - chunk_size: Optional. Number of texts to add to the index at a time. Defaults to 500. Returns: List of ids from adding the texts into the vectorstore. r;)zipr>r=) r%rAr,rrr-r.rr+rs r&add_embeddings!ElasticsearchStore.add_embeddings(sH8 1zz K  +'A#  r)c V[R"SSU0UD6nURXUS9 U$)aConstruct ElasticsearchStore wrapper from raw documents. Example: .. code-block:: python from langchain_community.vectorstores import ElasticsearchStore from langchain_community.embeddings.openai import OpenAIEmbeddings db = ElasticsearchStore.from_texts( texts, // embeddings optional if using // a strategy that doesn't require inference embeddings, index_name="langchain-demo", es_url="http://localhost:9200" ) Args: texts: List of texts to add to the Elasticsearch index. embedding: Embedding function to use to embed the texts. metadatas: Optional list of metadatas associated with the texts. index_name: Name of the Elasticsearch index to create. es_url: URL of the Elasticsearch instance to connect to. cloud_id: Cloud ID of the Elasticsearch instance to connect to. es_user: Username to use when connecting to Elasticsearch. es_password: Password to use when connecting to Elasticsearch. es_api_key: API key to use when connecting to Elasticsearch. es_connection: Optional pre-existing Elasticsearch connection. vector_query_field: Optional. Name of the field to store the embedding vectors in. query_field: Optional. Name of the field to store the texts in. distance_strategy: Optional. Name of the distance strategy to use. Defaults to "COSINE". can be one of "COSINE", "EUCLIDEAN_DISTANCE", "DOT_PRODUCT", "MAX_INNER_PRODUCT". bulk_kwargs: Optional. Additional arguments to pass to Elasticsearch bulk. r)r,r.r#)r_create_cls_from_kwargsr?)clsr+rr,r.relasticsearchStores r& from_textsElasticsearchStore.from_textsPsHb0GG  #)  $$ K % "!r)c URS5nUc [S5eURS5nURS5nURS5nURS5nURS5nURS5nURS 5n URS 5n URS 5n URS [R55n 0n U bXS 'U bXS '[SUUUUUUUUU U S . U D6$)NrzPlease provide an index_name.rrrrrrrrrr) rrrrrrrrrrr#)rr]rrF)rrrrrrrrrrrrr optional_argss r&rG*ElasticsearchStore._create_cls_from_kwargssZZ -  <= = ?3 jj/ H%**Y'jj/ ZZ - #ZZ(<=jj/ "JJ':;::j*<*T*T*VW  )2D. /  "+6- (!  !'##!/    r) documentsc T[R"SSU0UD6nURXS9 U$)aConstruct ElasticsearchStore wrapper from documents. Example: .. code-block:: python from langchain_community.vectorstores import ElasticsearchStore from langchain_community.embeddings.openai import OpenAIEmbeddings db = ElasticsearchStore.from_documents( texts, embeddings, index_name="langchain-demo", es_url="http://localhost:9200" ) Args: texts: List of texts to add to the Elasticsearch index. embedding: Embedding function to use to embed the texts. Do not provide if using a strategy that doesn't require inference. metadatas: Optional list of metadatas associated with the texts. index_name: Name of the Elasticsearch index to create. es_url: URL of the Elasticsearch instance to connect to. cloud_id: Cloud ID of the Elasticsearch instance to connect to. es_user: Username to use when connecting to Elasticsearch. es_password: Password to use when connecting to Elasticsearch. es_api_key: API key to use when connecting to Elasticsearch. es_connection: Optional pre-existing Elasticsearch connection. vector_query_field: Optional. Name of the field to store the embedding vectors in. query_field: Optional. Name of the field to store the texts in. bulk_kwargs: Optional. Additional arguments to pass to Elasticsearch bulk. r)r.r#)rrG add_documents)rHrOrr.rrIs r&from_documents!ElasticsearchStore.from_documentss?V0GG  #)  (((L!!r)c[5$)zMUsed to perform brute force / exact nearest neighbor search via script_score.)rvr#r)r&rv)ElasticsearchStore.ExactRetrievalStrategys &''r)rHrIrJrFc[XUS9$)apUsed to perform approximate nearest neighbor search using the HNSW algorithm. At build index time, this strategy will create a dense vector field in the index and store the embedding vectors in the index. At query time, the text will either be embedded using the provided embedding function or the query_model_id will be used to embed the text using the model deployed to Elasticsearch. if query_model_id is used, do not provide an embedding function. Args: query_model_id: Optional. ID of the model to use to embed the query text within the stack. Requires embedding model to be deployed to Elasticsearch. hybrid: Optional. If True, will perform a hybrid search using both the knn query and a text query. Defaults to False. rrf: Optional. rrf is Reciprocal Rank Fusion. When `hybrid` is True, and `rrf` is True, then rrf: {}. and `rrf` is False, then rrf is omitted. and isinstance(rrf, dict) is True, then pass in the dict values. rrf could be passed for adjusting 'rank_constant' and 'window_size'. rM)rFrMs r&rF*ElasticsearchStore.ApproxRetrievalStrategysD')c  r)rUrc[US9$)azUsed to perform sparse vector search via text_expansion. Used for when you want to use ELSER model to perform document search. At build index time, this strategy will create a pipeline that will embed the text using the ELSER model and store the resulting tokens in the index. At query time, the text will be embedded using the ELSER model and the resulting tokens will be used to perform a text_expansion query. Args: model_id: Optional. Default is ".elser_model_1". ID of the model to use to embed the query text within the stack. Requires embedding model to be deployed to Elasticsearch. r)rrs r&SparseVectorRetrievalStrategy0ElasticsearchStore.SparseVectorRetrievalStrategys*'99r))r/rrrrrr)2N)r[g?N)r[N)Nr[Nr\NNNN)NTrL)NNTTN)NNN)NN)r!rvrt)5r8r9r:r;r<rFr>r rr rrnrprorqrrrrN staticmethodrrpropertyrr?r r@rrr=rrrrr rrrrrArr)r r>r?rD classmethodrJrGrRrvrYrBr#r)r&rrsQld+/37 $%)!%$(%)"*! *A*C.2-44J' 4  0 4  4c]4#4SM4c]4 44$  '' ,, 33 224  4*(+4,DcN+-4l0C00 !%"&!%"&"&.21 13-1# 1 3- 1 3- 1DcN+1 11fHZ0 '+ ++ + + d$ +  + h+: &* ;; ; ;  ; c# ;; h;zEe !HeWe^,D ! FJGG G.6tDz.BGUXG eHeO$ %G*'+ R;R Rd$ R  R eHeO$ % R0 $15&*'+KO<@Z}Z ZDK-. Z  Z c# Zd$ZxuS$Y/?(@$(FGHZhvx'789ZZ eHeO$ %Z|$(*.+ d3i +"$+ + $ +\=A$J$J,4SM$J $JT59#' $+/&*F}FT$u+./FDc3h01 F d3i F  F%)Fd^FF cFV59#' $+/&*- }- Dc3h01- d3i -  - %) - d^- -  c- d+/#' $+/&*& !%T%[(8"9:& DJ'& d3i &  & %) & d^& &  c& P+/48&* 9"Cy9"J'9"Dc3h01 9" d^ 9"  9" 9"9"v*.' J'' :=' ' ' R+/&* 0">0"J'0"d^ 0"  0"  0"0"d(( (,!&+/#   # # eD$J' (#  # # # J"&:3-: "::r)r)'loggingr1abcrrtypingrrrrr r r r r rnumpyrlangchain_core._apirlangchain_core.documentsrlangchain_core.embeddingsrlangchain_core.vectorstoresr&langchain_community.vectorstores.utilsrrrr getLoggerr8rrrFrvrrr#r)r&rks #   *-03 +   8 $PCPf  HRVu 3u u p  HRV@ 2@ @ F  HRVN3NNb  HRV]:]:]:r)