dh=SSKrSSKJrJr SSKJrJrJrJrJ r J r J r J r SSK Jr SSKJr SSKJr SSKJr SSKJrJrJrJr SS KJr S \S \4S jrS SS \4Sjr\ \\\\S4r "SS\SS9r!"SS\SS9r""SS\SS9r#"SS\SS9r$"SS\SS9r%"SS\SS9r&"SS\\SS9r'"SS \'5r("S!S"\'5r)"S#S$\SS9r*"S%S&\SS9r+S'S(S)S*S+S,.r,\"S-S.S/S09"S1S2\55r-g)3N)ABCabstractmethod)AnyCallableDictListLiteralOptionalSequenceUnion) deprecated)CallbackManagerForRetrieverRun)Document) BaseRetriever) BaseModelFieldmodel_validator validator) AnnotatedexcerptreturnchU(dU$[R"SSU5RSS5nU$)zlClean an excerpt from Kendra. Args: excerpt: The excerpt to clean. Returns: The cleaned excerpt. z\s+ z...)resubreplace)rress ]/var/www/html/shao/venv/lib/python3.13/site-packages/langchain_community/retrievers/kendra.py clean_excerptr s0  &&g & . .ub 9C Jitem ResultItemcSnUR5nU(a USUS3- n[UR55nU(a USUS3- nU$)zCombine a ResultItem title and excerpt into a single string. Args: item: the ResultItem of a Kendra search. Returns: A combined text of the title and excerpt of the given item. rzDocument Title:  zDocument Excerpt: ) get_titler get_excerpt)r"texttitlers r combined_textr*+s[ D NN E  "5',,D,,./G &wir22 Kr!cT\rSrSr%Sr\\S'\\S'\\\S'\\ \S'Sr g) HighlightGz8Information that highlights the keywords in the excerpt. BeginOffset EndOffset TopAnswerTypeN) __name__ __module__ __qualname____firstlineno____doc__int__annotations__r boolstr__static_attributes__r2r!rr,r,Gs0BLNJ~7 3->>> ! >>>> !   '' '   ## #r!r2)r3r4r5r6r7rXr r;r9rYr8rZrr[propertyDocumentAttributeValueTyper]r<r2r!rrVrVvsh(#Ix}#3#Ix}#+/OXd3i(/ !%K#% 1r!rVc0\rSrSr%Sr\\S'\\S'Srg)DocumentAttributezDocument attribute.rKrNr2N) r3r4r5r6r7r;r9rVr<r2r!rrbrbs H# !!%r!rbc\rSrSr%Sr\\\S'\\\S'\\\S'/r\\ \ \S'\\ \S'\ S\4S j5r \ S\4S j5rS\ 4S jrS\\\44S jrS\4S jr\4S\S/\4S\4SjjrSrg)r#zBase class of a result item.Id DocumentId DocumentURIDocumentAttributesScoreAttributesrcg)zDocument title.Nr2rQs rr&ResultItem.get_titler!cg)zDDocument excerpt or passage original content as retrieved by Kendra.Nr2rQs rr'ResultItem.get_excerptrmr!c0$)zDocument additional metadata dict. This returns any extra metadata except these: * result_id * document_id * source * title * excerpt * document_attributes r2rQs rget_additional_metadata"ResultItem.get_additional_metadatas  r!cUR=(d /Vs0sH#oRURR_M% sn$s snf)zDocument attributes dict.)rirKrNr])rRattrs rget_document_attributes_dict'ResultItem.get_document_attributes_dicts<8<8O8O8USU8UW8Ut$*****8UWWWs)Ac<URbURS$g)zDocument Score ConfidenceScoreConfidence NOT_AVAILABLE)rjrQs rget_score_attributeResultItem.get_score_attributes#    +''(9: :"r!page_content_formatterc "U"U5nUR5nURURURURUR 5UR 5UR5UR5S.5 [X#S9$)z!Converts this item to a Document.) result_id document_idsourcer)rdocument_attributesscore) page_contentmetadata) rqupdaterfrgrhr&r'rurzr)rRr|rrs rto_docResultItem.to_docs.d3 //1!WW#**)++-'+'H'H'J113  \EEr!r2N)r3r4r5r6r7r r;r9rirrbdictrr&r'rqrr`rurzr*rrrr<r2r!rr#r#s& - #<>&7!89>"d^#%3SSSS  Xd38R3R.SX#S#GTF&. ~s/B&CF FFr!c\rSrSr%Sr\\S'\\\S'\\\S'\\\S'/r \\ \ \S'\\\S'S \4S jr S \4S jr S \4S jrS \4S jrSrg)QueryResultItemzQuery API result item. DocumentTitle FeedbackTokenFormatr1AdditionalAttributesDocumentExcerptrc.URR$rP)rrBrQs rr&QueryResultItem.get_titles!!&&&r!cUR(dgURS(dgURSR5$)Nrr)rrSrQs rget_attribute_value#QueryResultItem.get_attribute_values9((((+,,Q/>>@ @r!cUR(a/URSRS:XaUR5nU$UR(aURRnU$SnU$)Nr AnswerTextr)rrKrrrB)rRrs rr'QueryResultItem.get_excerptsh  % %))!,00L@..0G   ! !**//GGr!c"SUR0nU$)Ntype)r1)rRadditional_metadatas rrq'QueryResultItem.get_additional_metadata s%tyy1""r!r2N)r3r4r5r6r7r@r9r r;rrrIr&rr'rrqr<r2r!rrrs %%C= A SM 3-?FH(4(A#BCHG011''3'ASA S ##r!rcZ\rSrSr%Sr\\\S'\\\S'S\4SjrS\4Sjr Sr g ) RetrieveResultItemizRetrieve API result item.rContentrc,UR=(d S$Nr)rrQs rr&RetrieveResultItem.get_titles!!'R'r!c,UR=(d S$r)rrQs rr'RetrieveResultItem.get_excerpts||!r!r!r2N) r3r4r5r6r7r r;r9r&r'r<r2r!rrrs7#C=  c]"(3("S"r!rc*\rSrSr%Sr\\\S'Srg) QueryResulti!a `Amazon Kendra Query API` search result. It is composed of: * Relevant suggested answers: either a text excerpt or table excerpt. * Matching FAQs or questions-answer from your FAQ file. * Documents including an excerpt of each document with its title. ResultItemsr2N) r3r4r5r6r7rrr9r<r2r!rrr!so&&r!rc6\rSrSr%Sr\\S'\\\S'Sr g)RetrieveResulti/z`Amazon Kendra Retrieve API` search result. It is composed of: * relevant passages or text excerpts given an input query. QueryIdrr2N) r3r4r5r6r7r;r9rrr<r2r!rrr/s  L())r!rg?g?g??)ryLOWMEDIUMHIGH VERY_HIGHz0.3.16z1.0z#langchain_aws.AmazonKendraRetriever)sinceremovalalternative_importc\rSrSr%Sr\\S'Sr\\\S'Sr \\\S'Sr \ \S'Sr \\ \S 'Sr\\\ \S '\r\\/\4\S '\\S 'Sr\\ \S '\\\\"SSS94\S'\"S5S\ S\ 4Sj5r\"SS9\S\ \\4S\4Sj55rS\S\\4SjrS\\S\\ 4Sjr!S\\ S\\ 4Sjr"S\S\#S\\ 4S jr$S!r%g)"AmazonKendraRetrieveriEa`Amazon Kendra Index` retriever. Args: index_id: Kendra index id region_name: The aws region e.g., `us-west-2`. Fallsback to AWS_DEFAULT_REGION env variable or region specified in ~/.aws/config. credentials_profile_name: The name of the profile in the ~/.aws/credentials or ~/.aws/config files, which has either access keys or role information specified. If not specified, the default credential profile or, if on an EC2 instance, credentials from IMDS will be used. top_k: No of results to return attribute_filter: Additional filtering of results based on metadata See: https://docs.aws.amazon.com/kendra/latest/APIReference document_relevance_override_configurations: Overrides relevance tuning configurations of fields/attributes set at the index level See: https://docs.aws.amazon.com/kendra/latest/APIReference page_content_formatter: generates the Document page_content allowing access to all result item attributes. By default, it uses the item's title and excerpt. client: boto3 client for Kendra user_context: Provides information about the user context See: https://docs.aws.amazon.com/kendra/latest/APIReference Example: .. code-block:: python retriever = AmazonKendraRetriever( index_id="c0806df7-e76b-4bce-9b5c-d5582f6b1a03" ) index_idN region_namecredentials_profile_nametop_kattribute_filter*document_relevance_override_configurationsr|client user_contextrr)gelemin_score_confidencer]rc0US:a[SUS35eU$)Nrtop_k () cannot be negative.) ValueError)clsr]s rvalidate_top_k$AmazonKendraRetriever.validate_top_ks# 19wug-BCD D r!before)modevaluescURS5nUbUS:a[SUS35eURS5bU$SSKnURS5(aURUSS9nOUR5n0nURS5(aUSUS'UR"S 0UD6US'U$![ a [ S 5e[ an[S 5UeSnAff=f) Nrrrrrr) profile_namerzRCould not import boto3 python package. Please install it with `pip install boto3`.zCould not load credentials to authenticate with AWS client. Please check that credentials in the specified profile name are valid.)kendra)getrboto3Sessionr ImportError Exception)rrrrsession client_paramses r create_client#AmazonKendraRetriever.create_clients 7#  wug-BCD D ::h  +M  zz455--V  *   sA3B33C" CC"querycURUR5SSURS.nURbURUS'URbURUS'UR bUR US'UR R"S0UD6n[RU5nUR(a UR$UR R"S0UD6n[RU5nUR$)Nri)IndexId QueryTextPageSizeAttributeFilter'DocumentRelevanceOverrideConfigurations UserContextr2) rstriprrrrrretriever parse_objrrr)rRr kendra_kwargsresponser_resultq_results r _kendra_query#AmazonKendraRetriever._kendra_querys}}q-    ,/3/D/DM+ ,  : : F?? C D    (+/+<+"c"$"H$3$8J+?$6HZ,@T(^X4>&<<4 < h rs] #   7C-3 ( 3 3   (#3T#Y#<= =  ='*Yg* 7  7Yg>& &>FCw>FB.#j.#b " " )7  Yg      < f