Skip to main content

Interface: TemporalModelOptions

googleAdkAgentsWorkflow.TemporalModelOptions

Properties​

activity​

• Optional activity: ActivityOptions

Per-call Temporal Activity configuration (timeouts, retry, task queue).

When ADK aborts the invocation a call belongs to (in a graph, when a sibling node fails), the call's Activity cancellation is requested, and cancellationType decides what the agent then waits for. Unset means TRY_CANCEL: the call ends at once and the Activity winds down on its own. WAIT_CANCELLATION_COMPLETED waits for the Activity to acknowledge, which it does at its next heartbeat; the model Activities heartbeat at half the heartbeatTimeout, and not at all without one.

A timeout on the agent's graph node is not such an abort. ADK runs the agent with the run's signal, not the node's deadline (runLlmAgentAsNode), so a node that times out leaves its model call running, and an ADK retry starts the next call beside it. Bound the call with this Activity's own startToCloseTimeout or scheduleToCloseTimeout instead.

streamingBatchInterval​

• Optional streamingBatchInterval: Duration

Coalescing interval for streamed chunks (default '100 milliseconds').

streamingTopic​

• Optional streamingTopic: string

Stream topic for incremental (SSE) responses, surfaced via @temporalio/workflow-streams. When set and stream is requested, the Activity publishes each LlmResponse chunk to this topic for external observers while still returning the full accumulated transcript to the Workflow (deterministic on replay).

summary​

• Optional summary: string | (req: LlmRequest) => string

A Temporal-UI summary for each model Activity. A function receives the outgoing LlmRequest so callers can derive a label from it; keep it deterministic for replay safety. Takes precedence over activity.summary; when neither is set, the request's adk_agent_name label is used, falling back to a generic auto-generated label.