Skip to content

Fix to Untitled trace name#108

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rcholic merged 2 commits into from
Jan 3, 2026
Merged

Fix to Untitled trace name #108

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0c6f944
fix trace name
rcholic Jan 3, 2026
8b0e51e
resolve merge conflicts
rcholic Jan 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 37 additions & 3 deletions sentience/tracer_factory.py
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -26,6 +26,10 @@ def create_tracer(
api_url: str | None = None,
logger: SentienceLogger | None = None,
upload_trace: bool = False,
goal: str | None = None,
agent_type: str | None = None,
llm_model: str | None = None,
start_url: str | None = None,
) -> Tracer:
"""
Create tracer with automatic tier detection.
Expand All@@ -44,13 +48,26 @@ def create_tracer(
upload_trace: Enable cloud trace upload (default: False). When True and api_key
is provided, traces will be uploaded to cloud. When False, traces
are saved locally only.
goal: User's goal/objective for this trace run. This will be displayed as the
trace name in the frontend. Should be descriptive and action-oriented.
Example: "Add wireless headphones to cart on Amazon"
agent_type: Type of agent running (e.g., "SentienceAgent", "CustomAgent")
llm_model: LLM model used (e.g., "gpt-4-turbo", "claude-3-5-sonnet")
start_url: Starting URL of the agent run (e.g., "https://amazon.com")

Returns:
Tracer configured with appropriate sink

Example:
>>> # Pro tier user
>>> tracer = create_tracer(api_key="sk_pro_xyz", run_id="demo")
>>> # Pro tier user with goal
>>> tracer = create_tracer(
... api_key="sk_pro_xyz",
... run_id="demo",
... goal="Add headphones to cart",
... agent_type="SentienceAgent",
... llm_model="gpt-4-turbo",
... start_url="https://amazon.com"
... )
>>> # Returns: Tracer with CloudTraceSink
>>>
>>> # Free tier user
Expand All@@ -75,11 +92,28 @@ def create_tracer(
# 1. Try to initialize Cloud Sink (Pro/Enterprise tier) if upload enabled
if api_key and upload_trace:
try:
# Build metadata object for trace initialization
# Only include non-empty fields to avoid sending empty strings
metadata: dict[str, str] = {}
if goal and goal.strip():
metadata["goal"] = goal.strip()
if agent_type and agent_type.strip():
metadata["agent_type"] = agent_type.strip()
if llm_model and llm_model.strip():
metadata["llm_model"] = llm_model.strip()
if start_url and start_url.strip():
metadata["start_url"] = start_url.strip()

# Build request payload
payload: dict[str, Any] = {"run_id": run_id}
if metadata:
payload["metadata"] = metadata

# Request pre-signed upload URL from backend
response = requests.post(
f"{api_url}/v1/traces/init",
headers={"Authorization": f"Bearer {api_key}"},
json={"run_id": run_id},
json=payload,
timeout=10,
)

Expand Down