§ .çhÌFãó²—ddlmZddlmZmZddlmZmZddlmZddl m Z ddl m Z m Z mZmZmZmZmZmZmZmZmZdd lmZdd lmZerdd lmZ dOdPd„ZdQd„ZdRd„Z dSdTd'„Z dUdVd+„Z! dWdXd2„Z" dOdYd6„Z# dUdZd:„Z$ dOd[d=„Z% d\d]d@„Z& d^d_dD„Z' d`dadH„Z( dOdbdJ„Z) dUdcdN„Z*d S)dé)Ú annotations)ÚMappingÚSequence)Ú TYPE_CHECKINGÚAnyé)Úloggeré)ÚGLOBAL_TRACE_PROVIDER) Ú AgentSpanDataÚCustomSpanDataÚFunctionSpanDataÚGenerationSpanDataÚGuardrailSpanDataÚHandoffSpanDataÚMCPListToolsSpanDataÚResponseSpanDataÚSpeechGroupSpanDataÚSpeechSpanDataÚTranscriptionSpanData)ÚSpan)ÚTrace)ÚResponseNFÚ workflow_nameÚstrÚtrace_idú str | NoneÚgroup_idÚmetadataúdict[str, Any] | NoneÚdisabledÚboolÚreturnrcó†—tj¦«}|rtjd¦«tj|||||¬¦«S)a( Create a new trace. The trace will not be started automatically; you should either use it as a context manager (`with trace(...):`) or call `trace.start()` + `trace.finish()` manually. In addition to the workflow name and optional grouping identifier, you can provide an arbitrary metadata dictionary to attach additional user-defined information to the trace. Args: workflow_name: The name of the logical app or workflow. For example, you might provide "code_bot" for a coding agent, or "customer_support_agent" for a customer support agent. trace_id: The ID of the trace. Optional. If not provided, we will generate an ID. We recommend using `util.gen_trace_id()` to generate a trace ID, to guarantee that IDs are correctly formatted. group_id: Optional grouping identifier to link multiple traces from the same conversation or process. For instance, you might use a chat thread ID. metadata: Optional dictionary of additional metadata to attach to the trace. disabled: If True, we will return a Trace but the Trace will not be recorded. This will not be checked if there's an existing trace and `even_if_trace_running` is True. Returns: The newly created trace object. zKTrace already exists. Creating a new trace, but this is probably a mistake.)Únamerrrr!)r Úget_current_tracer ÚwarningÚ create_trace)rrrrr!Ú current_traces úR/var/www/FlaskApp/flask-venv/lib/python3.11/site-packages/agents/tracing/create.pyÚtracer+s\€õ>*Ô;Ñ=Ô=€MØð ÝŒØ Yñ ô ð õ !Ô -Ø ØØØØð  ñ ô ðóú Trace | Nonecó(—tj¦«S)z/Returns the currently active trace, if present.)r r&©r,r*r&r&Js€å Ô 2Ñ 4Ô 4Ð4r,úSpan[Any] | Nonecó(—tj¦«S)z.Returns the currently active span, if present.)r Úget_current_spanr/r,r*r2r2Os€å Ô 1Ñ 3Ô 3Ð3r,r%Úhandoffsúlist[str] | NoneÚtoolsÚ output_typeÚspan_idÚparentúTrace | Span[Any] | NoneúSpan[AgentSpanData]cóT—tjt||||¬¦«|||¬¦«S)a¶Create a new agent span. The span will not be started automatically, you should either do `with agent_span() ...` or call `span.start()` + `span.finish()` manually. Args: name: The name of the agent. handoffs: Optional list of agent names to which this agent could hand off control. tools: Optional list of tool names available to this agent. output_type: Optional name of the output type produced by the agent. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created agent span. )r%r3r5r6©Ú span_datar7r8r!)r Ú create_spanr )r%r3r5r6r7r8r!s r*Ú agent_spanr?Ts<€õ6 !Ô ,Ý T°HÀEÐWbÐcÑcÔcØØØð  ñ ô ðr,ÚinputÚoutputúSpan[FunctionSpanData]cóR—tjt|||¬¦«|||¬¦«S)a,Create a new function span. The span will not be started automatically, you should either do `with function_span() ...` or call `span.start()` + `span.finish()` manually. Args: name: The name of the function. input: The input to the function. output: The output of the function. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created function span. )r%r@rAr<)r r>r)r%r@rAr7r8r!s r*Ú function_spanrDws9€õ2 !Ô ,Ý"¨°EÀ&ÐIÑIÔIØØØð  ñ ô ðr,ú"Sequence[Mapping[str, Any]] | NoneÚmodelÚ model_configúMapping[str, Any] | NoneÚusageúSpan[GenerationSpanData]c óV—tjt|||||¬¦«|||¬¦«S)a%Create a new generation span. The span will not be started automatically, you should either do `with generation_span() ...` or call `span.start()` + `span.finish()` manually. This span captures the details of a model generation, including the input message sequence, any generated outputs, the model name and configuration, and usage data. If you only need to capture a model response identifier, use `response_span()` instead. Args: input: The sequence of input messages sent to the model. output: The sequence of output messages received from the model. model: The model identifier used for the generation. model_config: The model configuration (hyperparameters) used. usage: A dictionary of usage information (input tokens, output tokens, etc.). span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created generation span. )r@rArFrGrIr<)r r>r)r@rArFrGrIr7r8r!s r*Úgeneration_spanrL˜sK€õD !Ô ,Ý$ØØØØ%Øð  ñ ô ðØØð ñ ô ð r,ÚresponseúResponse | NoneúSpan[ResponseSpanData]cóN—tjt|¬¦«|||¬¦«S)a¥Create a new response span. The span will not be started automatically, you should either do `with response_span() ...` or call `span.start()` + `span.finish()` manually. Args: response: The OpenAI Response object. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )rMr<)r r>r)rMr7r8r!s r*Ú response_spanrQÈs5€õ$ !Ô ,Ý"¨HÐ5Ñ5Ô5ØØØð  ñ ô ðr,Ú from_agentÚto_agentúSpan[HandoffSpanData]cóP—tjt||¬¦«|||¬¦«S)a1Create a new handoff span. The span will not be started automatically, you should either do `with handoff_span() ...` or call `span.start()` + `span.finish()` manually. Args: from_agent: The name of the agent that is handing off. to_agent: The name of the agent that is receiving the handoff. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created handoff span. )rRrSr<)r r>r)rRrSr7r8r!s r*Ú handoff_spanrVâs7€õ. !Ô ,Ý!¨ZÀ(ÐKÑKÔKØØØð  ñ ô ðr,ÚdataúSpan[CustomSpanData]cóT—tjt||pi¬¦«|||¬¦«S)aCCreate a new custom span, to which you can add your own metadata. The span will not be started automatically, you should either do `with custom_span() ...` or call `span.start()` + `span.finish()` manually. Args: name: The name of the custom span. data: Arbitrary structured data to associate with the span. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created custom span. )r%rWr<)r r>r )r%rWr7r8r!s r*Ú custom_spanrZs;€õ0 !Ô ,Ý  d°°¸Ð<Ñ<Ô<ØØØð  ñ ô ðr,Ú triggeredúSpan[GuardrailSpanData]cóP—tjt||¬¦«|||¬¦«S)aÚCreate a new guardrail span. The span will not be started automatically, you should either do `with guardrail_span() ...` or call `span.start()` + `span.finish()` manually. Args: name: The name of the guardrail. triggered: Whether the guardrail was triggered. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )r%r[r<)r r>r)r%r[r7r8r!s r*Úguardrail_spanr^!s7€õ( !Ô ,Ý#¨¸ÐCÑCÔCØØØð  ñ ô ðr,ÚpcmÚ input_formatúSpan[TranscriptionSpanData]c óV—tjt|||||¬¦«|||¬¦«S)aJCreate a new transcription span. The span will not be started automatically, you should either do `with transcription_span() ...` or call `span.start()` + `span.finish()` manually. Args: model: The name of the model used for the speech-to-text. input: The audio input of the speech-to-text transcription, as a base64 encoded string of audio bytes. input_format: The format of the audio input (defaults to "pcm"). output: The output of the speech-to-text transcription. model_config: The model configuration (hyperparameters) used. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created speech-to-text span. )r@r`rArFrGr<)r r>r)rFr@r`rArGr7r8r!s r*Útranscription_spanrc=sJ€õ< !Ô ,Ý'ØØ%ØØØ%ð  ñ ô ðØØð ñ ô ð r,Ú output_formatÚfirst_content_atúSpan[SpeechSpanData]c óX—tjt||||||¬¦«|||¬¦«S)a)Create a new speech span. The span will not be started automatically, you should either do `with speech_span() ...` or call `span.start()` + `span.finish()` manually. Args: model: The name of the model used for the text-to-speech. input: The text input of the text-to-speech. output: The audio output of the text-to-speech as base64 encoded string of PCM audio bytes. output_format: The format of the audio output (defaults to "pcm"). model_config: The model configuration (hyperparameters) used. first_content_at: The time of the first byte of the audio output. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )rFr@rArdrGrer<)r r>r) rFr@rArdrGrer7r8r!s r*Ú speech_spanrhisM€õ8 !Ô ,Ý ØØØØ'Ø%Ø-ð  ñ ô ðØØð ñ ô ð r,úSpan[SpeechGroupSpanData]cóN—tjt|¬¦«|||¬¦«S)aºCreate a new speech group span. The span will not be started automatically, you should either do `with speech_group_span() ...` or call `span.start()` + `span.finish()` manually. Args: input: The input text used for the speech request. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )r@r<)r r>r)r@r7r8r!s r*Úspeech_group_spanrk”s5€õ$ !Ô ,Ý%¨EÐ2Ñ2Ô2ØØØð  ñ ô ðr,ÚserverÚresultúSpan[MCPListToolsSpanData]cóP—tjt||¬¦«|||¬¦«S)aáCreate a new MCP list tools span. The span will not be started automatically, you should either do `with mcp_tools_span() ...` or call `span.start()` + `span.finish()` manually. Args: server: The name of the MCP server. result: The result of the MCP list tools call. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )rlrmr<)r r>r)rlrmr7r8r!s r*Úmcp_tools_spanrp®s7€õ( !Ô ,Ý&¨f¸VÐDÑDÔDØØØð  ñ ô ðr,)NNNF) rrrrrrrr r!r"r#r)r#r-)r#r0)NNNNNF)r%rr3r4r5r4r6rr7rr8r9r!r"r#r:)NNNNF)r%rr@rrArr7rr8r9r!r"r#rB)NNNNNNNF)r@rErArErFrrGrHrIr r7rr8r9r!r"r#rJ) rMrNr7rr8r9r!r"r#rO) rRrrSrr7rr8r9r!r"r#rT) r%rrWr r7rr8r9r!r"r#rX)FNNF) r%rr[r"r7rr8r9r!r"r#r\)NNr_NNNNF)rFrr@rr`rrArrGrHr7rr8r9r!r"r#ra) NNNr_NNNNF)rFrr@rrArrdrrGrHrerr7rr8r9r!r"r#rf) r@rr7rr8r9r!r"r#ri) rlrrmr4r7rr8r9r!r"r#rn)+Ú __future__rÚcollections.abcrrÚtypingrrr Úsetupr r=r r rrrrrrrrrÚspansrÚtracesrÚopenai.types.responsesrr+r&r2r?rDrLrQrVrZr^rcrhrkrpr/r,r*úrxsqðØ"Ð"Ð"Ð"Ð"Ð"à-Ð-Ð-Ð-Ð-Ð-Ð-Ð-Ø%Ð%Ð%Ð%Ð%Ð%Ð%Ð%àÐÐÐÐÐØ(Ð(Ð(Ð(Ð(Ð(ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ð ðÐÐÐÐÐØÐÐÐÐÐàð0Ø/Ð/Ð/Ð/Ð/Ð/ð  ØØ&*Øð +ð+ð+ð+ð+ð\5ð5ð5ð5ð 4ð4ð4ð4ð"&Ø"Ø"ØØ'+Øð ð ð ð ð ðJØØØ'+Øð ðððððD15Ø15ØØ-1Ø#'ØØ'+Øð-ð-ð-ð-ð-ðb!%ØØ'+Øð ððððð6"ØØØ'+Øð ðððððB#'ØØ'+Øð ðððððDØØ'+Øð ððððð:ØØ$ØØ-1ØØ'+Øð)ð)ð)ð)ð)ðZØØØ %Ø-1Ø#'ØØ'+Øð(ð(ð(ð(ð(ðXØØ'+Øð ððððð6Ø#ØØ'+Øð ððððððr,