/jSSKJr SSKrSSKJrJr SSKJrJr \(aSSK J r \"SS55r "S S 5r g) ) annotationsN) dataclassfield) TYPE_CHECKINGAny)EvaluationResultcN\rSrSr%SrS\S'\"\RS9rS\S'Sr g) _TagEntry Ndict[str, Any] | Nonemetadata)default_factoryfloat timestamp) __name__ __module__ __qualname____firstlineno__r__annotations__rtimer__static_attributes__rM/app/agent/.venv/lib/python3.13/site-packages/livekit/agents/observability.pyr r s &*H#*TYY7Iu7rr c\rSrSrSrSSjrSSSjjrSSSjjrSS.SSjjrSS jr \ SS j5r \ SS j5r \ SS j5r \ SS j5rSSjrSrg)TaggeraTag sessions with metadata for observability. The Tagger allows adding string tags (key:value format) with optional structured metadata to sessions. Tags and metadata 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") # Add tags with structured metadata ctx.tagger.add( "appointment:booked", metadata={"slot_id": "abc123", "calendar": "cal.com"}, ) # Remove a tag ctx.tagger.remove("voicemail:true") ``` c.0Ul/UlSUlgN)_tags_evaluation_results_outcome_reasonselfs r__init__Tagger.__init__/s+- 9; +/rNcvURRSS5 [5URS'Xlg)zuMark the session as successful. Args: reason: Optional reason for the success (stored separately from the tag). lk.failN lk.successr!popr r#r%reasons rsuccessTagger.success4s, y$'#,; < %rcvURRSS5 [5URS'Xlg)zqMark the session as failed. Args: reason: Optional reason for the failure (stored separately from the tag). r*Nr)r+r-s rfail Tagger.fail?s, |T* )  9%rrc0[US9URU'g)zAdd a tag to the session with optional structured metadata. Args: tag: The tag string in "key:value" format (e.g., "voicemail:true", "language:es"). metadata: Optional dict of structured metadata associated with this tag. r4N)r r!)r%tagrs radd Tagger.addJs$X6 3rc<URRUS5 g)zIRemove a tag from the session. Args: tag: The tag string to remove. N)r!r,)r%r6s rremove Tagger.removeSs sD!rcH[URR55$)zAll current tag strings.)setr!keysr$s rtags Tagger.tags[s4::??$%%rc6URR5$)zAll evaluation results.)r"copyr$s r evaluationsTagger.evaluations`s'',,..rcHSUR;agSUR;agg)z;The session outcome: 'success', 'fail', or None if not set.r*r/r)r2N)r!r$s routcomeTagger.outcomees% 4:: % $** $rcUR$)z#Reason for success/failure outcome.)r#r$s routcome_reasonTagger.outcome_reasonns###rc URR5Hmup#SUSUR3n[5URU'UR R UUURURURS.5 Mo g)zmTag the session with evaluation results (internal use only). Called automatically by JudgeGroup.evaluate(). z lk.judge.:)namer6verdict reasoning instructionsN) judgmentsitemsrNr r!r"appendrOrP)r%resultrMjudgmentr6s r _evaluationTagger._evaluationss %..446NDdV1X%5%5$67C'kDJJsO  $ $ + + '//!)!3!3$,$9$9  7r)r"r#r!)returnNoner )r. str | NonerXrY)r6strrr rXrY)r6r[rXrY)rXzset[str])rXzlist[dict[str, Any]])rXrZ)rTr rXrY)rrrr__doc__r&r/r2r7r:propertyr?rCrFrIrVrrrrrrs|:0 & &BF7"&&//$$rr) __future__rr dataclassesrrtypingrrevalsr r rrrrrbs<" (%' 88 8 rrr