Python SDK quickstart

uv add sovara "openai-agents>=0.13,<1"

from sovara import SovaraClient, trace  
from agents import Agent, Runner, function_tool

sovara_client = SovaraClient(project_name="weather-agent")  


@function_tool
def get_zurich_temperature() -> int:
    """Return the demo temperature in Zurich in Celsius."""
    return 22


@function_tool
def get_boston_temperature() -> int:
    """Return the demo temperature in Boston in Celsius."""
    return 27


zurich_agent = Agent(
    name="Zurich weather agent",
    instructions="Call the weather tool and return only the temperature.",
    model="gpt-5.4-mini",
    tools=[get_zurich_temperature],
    output_type=int,
)

boston_agent = Agent(
    name="Boston weather agent",
    instructions="Call the weather tool and return only the temperature.",
    model="gpt-5.4-mini",
    tools=[get_boston_temperature],
    output_type=int,
)


@trace(name="choose warmer city")  
def choose_warmer_city(zurich: int, boston: int) -> str:
    if zurich == boston:
        return f"Boston and Zurich are equally warm at {zurich} C."
    city = "Zurich" if zurich > boston else "Boston"
    return f"{city} is warmer ({boston} C in Boston, {zurich} C in Zurich)."


def main() -> None:
    question = "Which city is warmer, Boston or Zurich?"
    with sovara_client.trace("compare city weather") as trace_id:  
        # Attach the user-visible request to the top-level trace.  
        if trace_id is not None:  
            sovara_client.log(trace_id=trace_id, trace_input=question)  

        # Each subtrace groups one delegated agent's work into an expandable child trace.  
        with sovara_client.subtrace("Zurich weather agent"):  
            zurich = Runner.run_sync(zurich_agent, question).final_output

        with sovara_client.subtrace("Boston weather agent"):  
            boston = Runner.run_sync(boston_agent, question).final_output

        answer = choose_warmer_city(zurich, boston)
        # Attach the final user-visible result to the top-level trace.  
        if trace_id is not None:  
            sovara_client.log(trace_id=trace_id, trace_output=answer)  

    print(answer)


if __name__ == "__main__":
    main()

uv run python weather_agent.py