Go SDK Runtime Events

Use the Go trace builder when you want the graph to include application-side runtime work that the provider proxy cannot observe directly.

Quickstart

Start with client creation, agent initialization, and your first trace event.

Proxy Transport

Review the Go proxy flow before adding runtime events on top of proxied traffic.

Manual Events API

Compare the Go helpers with the raw REST ingest endpoint and event schema.

Minimal runtime tracing

Tool span pair
Thinking block

spanID, _ := trace.ToolCallRequest(ctx, "search_orders",
	[]whyops.ToolCallPair{{Name: "search_orders", Arguments: map[string]any{"orderId": "123"}}},
	whyops.ToolCallRequestOptions{LatencyMs: 12},
)

_ = trace.ToolCallResponse(ctx, "search_orders", spanID,
	[]whyops.ToolCallPair{{Name: "search_orders", Arguments: map[string]any{"orderId": "123"}}},
	map[string]any{"status": "shipped"},
	whyops.ToolCallResponseOptions{LatencyMs: 91},
)

_ = trace.LLMThinking(ctx, "I should verify the order before replying.", whyops.LLMThinkingOptions{
	Signature: "anthropic-thinking-signature",
})

Prompt caching-aware usage

_ = trace.LLMResponse(ctx, "anthropic/claude-sonnet-4-5", "anthropic", "Done.", whyops.LLMResponseOptions{
	LatencyMs: 860,
	Usage: &whyops.TokenUsage{
		PromptTokens:        1200,
		CompletionTokens:    240,
		TotalTokens:         9940,
		CacheReadTokens:     8200,
		CacheCreationTokens: 300,
	},
})

Hybrid pattern

Use hybrid mode when the proxy already captures the model exchange, but you still want application-side tool timing and output.

spanID, _ := trace.ToolCallRequest(ctx, "charge_card",
	[]whyops.ToolCallPair{{Name: "charge_card", Arguments: map[string]any{"amount": 4999, "currency": "usd"}}},
	whyops.ToolCallRequestOptions{},
)

result := chargeCard()

_ = trace.ToolCallResponse(ctx, "charge_card", spanID,
	[]whyops.ToolCallPair{{Name: "charge_card", Arguments: map[string]any{"amount": 4999, "currency": "usd"}}},
	map[string]any{"result": result},
	whyops.ToolCallResponseOptions{},
)

Self-hosted overrides

sdk := whyops.New(whyops.Config{
	APIKey:         os.Getenv("WHYOPS_API_KEY"),
	AgentName:      "customer-support-agent",
	AgentMetadata:  whyops.AgentMetadata{SystemPrompt: "You are helpful."},
	ProxyBaseURL:   "https://proxy.internal.example.com",
	AnalyseBaseURL: "https://analyse.internal.example.com/api",
})

Method map

Method	Purpose	Notes
`InitAgent(ctx)`	Explicit agent registration	Also runs automatically before first event
`Trace(traceID)`	Create a trace builder	Use one trace per session, request, or workflow
`UserMessage()`	Log user or assembled prompt input	Optional `SystemPrompt`, `Tools`, `Params`, and `ExternalUserID`
`LLMResponse()`	Log model output	Supports `Usage`, `FinishReason`, `LatencyMs`
`LLMThinking()`	Log explicit thinking blocks	Use when the runtime exposes reasoning
`EmbeddingRequest()`	Log embedding inputs	Pairs with `EmbeddingResponse()`
`EmbeddingResponse()`	Log embedding result summary	Includes total tokens and latency
`ToolCallRequest()`	Start a tool span	Returns `spanID`
`ToolCallResponse()`	Close the tool span	Reuse the `spanID` from the request
`ToolResult()`	Record tool output returned to the model	Useful in hybrid setups
`Error()`	Record runtime or provider failure	Supports `Status` and `Stack`

Linking events to users

Use ExternalUserID to associate events with your application user IDs:

_ = trace.UserMessage(ctx, []whyops.MessageItem{{Role: "user", Content: "Reset my password."}},
	whyops.UserMessageOptions{EventOptions: whyops.EventOptions{ExternalUserID: "user_12345"}},
)

The ExternalUserID is stored on every event and trace, allowing you to filter and analyze traces by your own user identifiers.

Getting Started

SDK Overview

TypeScript SDK

Vercel AI SDK

LangChain JS (Beta)

Python SDK

Go SDK

Direct APIs

UI Features

Core Concepts

Architecture

Go SDK Runtime Events

Quickstart

Proxy Transport

Manual Events API

Minimal runtime tracing

Prompt caching-aware usage

Hybrid pattern

Self-hosted overrides

Method map

Linking events to users

Quickstart

Proxy Transport

Manual Events API

​Minimal runtime tracing

​Prompt caching-aware usage

​Hybrid pattern

​Self-hosted overrides

​Method map

​Linking events to users

Minimal runtime tracing

Prompt caching-aware usage

Hybrid pattern

Self-hosted overrides

Method map

Linking events to users