U 9%e0@sddlZddlmZmZddlZddlmZddlm Z m Z ddl m Z m Z mZe eZGdd d e Ze e Gd d d eZdS) N)ListUnion)TruncationStrategy)add_end_docstringslogging)PIPELINE_INIT_ARGSArgumentHandler ChunkPipelinec@s eZdZdZddZddZdS)%ZeroShotClassificationArgumentHandlerz Handles arguments for zero-shot for text classification by turning each possible label into an NLI premise/hypothesis pair. cCs"t|trdd|dD}|S)NcSsg|]}|r|qS)strip.0labelr r n/var/www/html/Darija-Ai-API/env/lib/python3.8/site-packages/transformers/pipelines/zero_shot_classification.py szGZeroShotClassificationArgumentHandler._parse_labels..,) isinstancestrsplit)selflabelsr r r _parse_labelss z3ZeroShotClassificationArgumentHandler._parse_labelscst|dkst|dkr td|dkr@tdt|trP|g}g}|D]|fdd|DqX||fS)Nrz>You must include at least one label and at least one sequence.zThe provided hypothesis_template "{}" was not able to be formatted with the target labels. Make sure the passed template includes formatting syntax such as {{}} where the label should go.csg|]}|gqSr )formatrhypothesis_templatesequencer rr)szBZeroShotClassificationArgumentHandler.__call__..)len ValueErrorrrrextend)r sequencesrrsequence_pairsr rr__call__s z.ZeroShotClassificationArgumentHandler.__call__N)__name__ __module__ __qualname____doc__rr$r r r rr sr cseZdZdZeffdd ZeddZddej fddZ d d Z e e ee fd fd d ZdddZddZdddZZS)ZeroShotClassificationPipelinea NLI-based zero-shot classification pipeline using a `ModelForSequenceClassification` trained on NLI (natural language inference) tasks. Equivalent of `text-classification` pipelines, but these models don't require a hardcoded number of potential classes, they can be chosen at runtime. It usually means it's slower but it is **much** more flexible. Any combination of sequences and labels can be passed and each combination will be posed as a premise/hypothesis pair and passed to the pretrained model. Then, the logit for *entailment* is taken as the logit for the candidate label being valid. Any NLI model can be used, but the id of the *entailment* label must be included in the model config's :attr:*~transformers.PretrainedConfig.label2id*. Example: ```python >>> from transformers import pipeline >>> oracle = pipeline(model="facebook/bart-large-mnli") >>> oracle( ... "I have a problem with my iphone that needs to be resolved asap!!", ... candidate_labels=["urgent", "not urgent", "phone", "tablet", "computer"], ... ) {'sequence': 'I have a problem with my iphone that needs to be resolved asap!!', 'labels': ['urgent', 'phone', 'computer', 'not urgent', 'tablet'], 'scores': [0.504, 0.479, 0.013, 0.003, 0.002]} >>> oracle( ... "I have a problem with my iphone that needs to be resolved asap!!", ... candidate_labels=["english", "german"], ... ) {'sequence': 'I have a problem with my iphone that needs to be resolved asap!!', 'labels': ['english', 'german'], 'scores': [0.814, 0.186]} ``` Learn more about the basics of using a pipeline in the [pipeline tutorial](../pipeline_tutorial) This NLI pipeline can currently be loaded from [`pipeline`] using the following task identifier: `"zero-shot-classification"`. The models that this pipeline can use are models that have been fine-tuned on an NLI task. See the up-to-date list of available models on [huggingface.co/models](https://huggingface.co/models?search=nli). cs,||_tj|||jdkr(tddS)NzFailed to determine 'entailment' label id from the label2id mapping in the model config. Setting to -1. Define a descriptive label2id mapping in the model config to ensure correct outputs.) _args_parsersuper__init__ entailment_idloggerwarning)rZ args_parserargskwargs __class__r rr-Ws  z'ZeroShotClassificationPipeline.__init__cCs2|jjjD]\}}|dr|SqdS)NZentailr*)modelconfigZlabel2iditemslower startswith)rrindr r rr.`s z,ZeroShotClassificationPipeline.entailment_idTc Ks|j}|jjdkr(td|jj|j_z|j|||||d}WnJtk r}z,dt|krv|j||||tj d}n|W5d}~XYnX|S)ze Parse arguments and tokenize only_first so that hypothesis (label) is not truncated NzfTokenizer was not supporting padding necessary for zero-shot, attempting to use `pad_token=eos_token`)add_special_tokensreturn_tensorspadding truncationz too short) framework tokenizerZ pad_tokenr/errorZ eos_token ExceptionrrZDO_NOT_TRUNCATE) rr#r=r;r>r2r<inputser r r_parse_and_tokenizegs2    z2ZeroShotClassificationPipeline._parse_and_tokenizecKs||dddk r&|d|d<tdi}d|krF|j|d|d<d|krZ|d|d<i}d|krr|d|d<|i|fS)NZ multi_class multi_labelzThe `multi_class` argument has been deprecated and renamed to `multi_label`. `multi_class` will be removed in a future version of Transformers.candidate_labelsr)getr/r0r+r)rr2Zpreprocess_paramsZpostprocess_paramsr r r_sanitize_parameterss   z3ZeroShotClassificationPipeline._sanitize_parameters)r"csNt|dkrn0t|dkr0d|kr0|d|d<ntd|tj|f|S)a Classify the sequence(s) given as inputs. See the [`ZeroShotClassificationPipeline`] documentation for more information. Args: sequences (`str` or `List[str]`): The sequence(s) to classify, will be truncated if the model input is too large. candidate_labels (`str` or `List[str]`): The set of possible class labels to classify each sequence into. Can be a single label, a string of comma-separated labels, or a list of labels. hypothesis_template (`str`, *optional*, defaults to `"This example is {}."`): The template used to turn each label into an NLI-style hypothesis. This template must include a {} or similar syntax for the candidate label to be inserted into the template. For example, the default template is `"This example is {}."` With the candidate label `"sports"`, this would be fed into the model like `" sequence to classify This example is sports . "`. The default template works well in many cases, but it may be worthwhile to experiment with different templates depending on the task setting. multi_label (`bool`, *optional*, defaults to `False`): Whether or not multiple candidate labels can be true. If `False`, the scores are normalized such that the sum of the label likelihoods for each sequence is 1. If `True`, the labels are considered independent and probabilities are normalized for each candidate by doing a softmax of the entailment score vs. the contradiction score. Return: A `dict` or a list of `dict`: Each result comes as a dictionary with the following keys: - **sequence** (`str`) -- The sequence for which this is the output. - **labels** (`List[str]`) -- The labels sorted by order of likelihood. - **scores** (`List[float]`) -- The probabilities for each of the labels. rrrGz%Unable to understand extra arguments )rr r,r$)rr"r1r2r3r rr$s $ z'ZeroShotClassificationPipeline.__call__NThis example is {}.c cs`||||\}}tt||D]:\}\}}||g} ||d|t|dkd| Vq dS)Nrrcandidate_labelris_last)r+ enumerateziprEr) rrCrGrr#r"irLZ sequence_pairZ model_inputr r r preprocesss z)ZeroShotClassificationPipeline.preprocesscsd}d}fdd|jjD}|jdkr8|jjn|jj}dt|j kr\d|d<|jf|}||dd |}|S) NrLrcsi|]}||qSr r )rkrCr r sz;ZeroShotClassificationPipeline._forward..ptZ use_cacheFrMrK) r@Zmodel_input_namesr?r5forwardcallinspect signature parameterskeys)rrCrLrZ model_inputsZ model_forwardoutputs model_outputsr rSr_forwards z'ZeroShotClassificationPipeline._forwardFcs"dd|Ddd|D}tdd|D}|jd}t}||}|||df}|sjtdkr|j} | dkr|dnd} |d| | gf} t| t| jdd d } | d } n,|d|jf} t| t| jdd d } tt | d }|dfd d|D| d|f d S)NcSsg|] }|dqS)rLr rr\r r rrsz>ZeroShotClassificationPipeline.postprocess..cSsg|] }|dqS)rr r_r r rrscSsg|]}|dqS)logits)numpy)routputr r rrsrr*r.T)Zkeepdims).rcsg|] }|qSr r )rrPrGr rrs)rrscores) npZ concatenateshaperZreshaper.expsumlistreversedZargsorttolist)rr]rFr"r`NnZ num_sequencesZreshaped_outputsr.Zcontradiction_idZentail_contr_logitsrdZ entail_logitsZtop_indsr rcr postprocesss(  z*ZeroShotClassificationPipeline.postprocess)NrJ)F)r%r&r'r(r r-propertyr.rZ ONLY_FIRSTrErIrrrr$rQr^rn __classcell__r r r3rr).s'   *- r))rXtypingrrrareZtokenization_utilsrutilsrrbaser r r Z get_loggerr%r/r r)r r r rs