o i @s>ddlmZddlmZmZerddlmZGdddZdS)) annotations) TYPE_CHECKINGAny)EvaluationResultc@szeZdZdZdddZd d!d d Zd d!d d Zd"ddZd"ddZe d#ddZ e d$ddZ e d%ddZ d&ddZ dS)'Taggera^Tag sessions with metadata for observability. The Tagger allows adding string tags (key:value format) to sessions. Tags are uploaded to LiveKit Cloud at session end. Example: ```python # Mark session as successful ctx.tagger.success(reason="Task completed successfully") # Mark session as failed ctx.tagger.fail(reason="User hung up before completing booking") # Add custom tags ctx.tagger.add("voicemail:true") ctx.tagger.add("language:es") # Remove a tag ctx.tagger.remove("voicemail:true") ``` returnNonecCst|_g|_d|_dSN)set_tags_evaluation_results_outcome_reasonselfr^/var/www/html/livekit_bhavya/venv/lib/python3.10/site-packages/livekit/agents/observability.py__init__ s zTagger.__init__Nreason str | NonecC"|jd|jd||_dS)zMark the session as successful. Args: reason: Optional reason for the success (stored separately from the tag). lk.fail lk.successNr discardaddrrrrrrsuccess%   zTagger.successcCr)zMark the session as failed. Args: reason: Optional reason for the failure (stored separately from the tag). rrNrrrrrfail0rz Tagger.failtagstrcC|j|dS)zAdd a tag to the session. Args: tag: The tag string in "key:value" format (e.g., "voicemail:true", "language:es"). N)r rrr rrrr;z Tagger.addcCr")zaRemove a tag from the session. Args: tag: The tag string to remove. N)r rr#rrrremoveCr$z Tagger.removeset[str]cC |jS)zAll current tags.)r copyrrrrtagsK z Tagger.tagslist[dict[str, Any]]cCr')zAll evaluation results.)r r(rrrr evaluationsPr*zTagger.evaluationscCs|jS)z#Reason for success/failure outcome.)rrrrroutcome_reasonUszTagger.outcome_reasonresultrcCsJ|jD]\}}|jd|d|j|j||j|jdqdS)z}Tag the session with evaluation results (internal use only). Called automatically by JudgeGroup.evaluate(). z lk.judge.:)nameverdict reasoningN) judgmentsitemsr rr1r appendr2)rr.r0judgmentrrr _evaluationZszTagger._evaluation)rr r )rrrr )r r!rr )rr&)rr+)rr)r.rrr )__name__ __module__ __qualname____doc__rrrrr%propertyr)r,r-r7rrrrr s      rN) __future__rtypingrrevalsrrrrrrs