+ ~j^RIHt^RIt^RIHtHt^RIHtHt]'d^RI H t ]!RR44t !RR 4t R#) ) annotationsN) dataclassfield) TYPE_CHECKINGAny)EvaluationResultcV]tRt^ t$RtR]R&]!]PR7tR]R&Rt R#) _TagEntryNdict[str, Any] | Nonemetadata)default_factoryfloat timestamp) __name__ __module__ __qualname____firstlineno__r __annotations__rtimer__static_attributes__rq/Users/mitch_tango/dev/rabbit-r1-livekit/agent/.venv/lib/python3.14/site-packages/livekit/agents/observability.pyr r s &*H#*TYY7Iu7rr c]tRt^tRtRRltRRRlltRRRlltR R/R R lltR R lt ] RRl4t ] RRl4t ] RRl4t ] RRl4tRRltRtR#)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") ``` cV^8dQhRR/#)returnNoner)formats"r __annotate__Tagger.__annotate__/s00$0rc 0/Vn.VnRVnR#N)_tags_evaluation_results_outcome_reasonselfs&r__init__Tagger.__init__/s+- 9; +/rNc V^8dQhRRRR/#rreason str | Nonerrr)r s"rr!r"4s & &j &D &rc xVPPRR4\4VPR&WnR#)zuMark the session as successful. Args: reason: Optional reason for the success (stored separately from the tag). lk.failN lk.successr%popr r'r)r.s&&rsuccessTagger.success4s, y$'#,; < %rc V^8dQhRRRR/#r-r)r s"rr!r"?s & &: & &rc xVPPRR4\4VPR&WnR#)zqMark the session as failed. Args: reason: Optional reason for the failure (stored separately from the tag). r2Nr1r3r5s&&rfail Tagger.fail?s, |T* )  9%rr c$V^8dQhRRRRRR/#)rtagstrr r rrr)r s"rr!r"Js"77s7)>7$7rc 8\VR7VPV&R#)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. )r N)r r%)r)r=r s&&$radd Tagger.addJs$X6 3rc V^8dQhRRRR/#)rr=r>rrr)r s"rr!r"Ss""#"$"rc >VPPVR4R#)zIRemove a tag from the session. Args: tag: The tag string to remove. N)r%r4)r)r=s&&rremove Tagger.removeSs sD!rcV^8dQhRR/#)rrzset[str]r)r s"rr!r"\s&&h&rc H\VPP44#)zAll current tag strings.)setr%keysr(s&rtags Tagger.tags[s4::??$%%rcV^8dQhRR/#)rrzlist[dict[str, Any]]r)r s"rr!r"as//1/rc 6VPP4#)zAll evaluation results.)r&copyr(s&r evaluationsTagger.evaluations`s'',,..rcV^8dQhRR/#rrr/r)r s"rr!r"fsrc RRVP9dR#RVP9dR#R#)z;The session outcome: 'success', 'fail', or None if not set.r2r6r1r:N)r%r(s&routcomeTagger.outcomees% 4:: % $** $rcV^8dQhRR/#rRr)r s"rr!r"os$$ $rc VP#)z#Reason for success/failure outcome.)r'r(s&routcome_reasonTagger.outcome_reasonns###rc V^8dQhRRRR/#)rresultrrrr)r s"rr!r"ss"2trc  $VPP4Fqwr#RV RVP 2p\4VPV&VP P RVRVRVPRVPRVP/4Ks R#) zmTag the session with evaluation results (internal use only). Called automatically by JudgeGroup.evaluate(). z lk.judge.:namer=verdict reasoning instructionsN) judgmentsitemsr_r r%r&appendr`ra)r)r[r^judgmentr=s&& r _evaluationTagger._evaluationss %..446NDdV1X%5%5$67C'kDJJsO  $ $ + +D3x//!3!3"H$9$9  7r)r&r'r%r$)rrrr__doc__r*r6r:r@rDpropertyrJrOrTrXrfrrrrrrs:0 & &77"&&//$$rr) __future__rr dataclassesrrtypingrrevalsrr rrrrrns<" (%' 88 8 rrr