Skip to main content

Interface: TemporalAgentOptions

strands.TemporalAgentOptions

Options for TemporalAgent.

Accepts everything AgentConfig accepts except model (which is a factory name selecting a worker-side Model, not an instance) and retryStrategy (always disabled — Temporal handles retries via activityOptions.retry).

The ActivityOptions apply to every model invocation this agent makes. streamingTopic/streamingBatchInterval route each ModelStreamEvent to a WorkflowStream topic of that name.

Hierarchy​

  • Omit<AgentConfig, "model" | "retryStrategy">

    ↳ TemporalAgentOptions

Properties​

activityOptions​

• Optional activityOptions: ActivityOptions

appState​

• Optional appState: Record<string, JSONValue>

Optional initial state values for the agent.

Inherited from​

Omit.appState

contextManager​

• Optional contextManager: "auto" | "agentic"

Context management strategy.

  • "auto": SummarizingConversationManager with proactive compression + ContextOffloader.
  • "agentic": Lets the model drive context management via injected tools.

If conversationManager is also provided, the user's conversation manager is used instead. Defaults to undefined (SlidingWindowConversationManager, no offloader).

Remarks

The offloader uses in-memory storage that does not persist across process restarts. For agents using sessionManager, provide an explicit ContextOffloader with durable storage via the plugins parameter.

Inherited from​

Omit.contextManager

conversationManager​

• Optional conversationManager: ConversationManager

Conversation manager for handling message history and context overflow. Defaults to SlidingWindowConversationManager with windowSize of 40.

Inherited from​

Omit.conversationManager

description​

• Optional description: string

Optional description of what the agent does.

Inherited from​

Omit.description

id​

• Optional id: string

Optional unique identifier for the agent. Defaults to "agent".

Inherited from​

Omit.id

interventions​

• Optional interventions: InterventionHandler[]

Intervention handlers evaluated in registration order at each lifecycle point.

Inherited from​

Omit.interventions

memoryManager​

• Optional memoryManager: MemoryManager | MemoryManagerConfig

Memory manager for cross-session memory retrieval and storage. Manages one or more memory stores and exposes search/add tools. Accepts a MemoryManager instance or a MemoryManagerConfig object (auto-wrapped).

Inherited from​

Omit.memoryManager

messages​

• Optional messages: Message[] | MessageData[]

An initial set of messages to seed the agent's conversation history.

Inherited from​

Omit.messages

model​

• Optional model: string

modelState​

• Optional modelState: Record<string, JSONValue>

Optional initial model-provider state (e.g., restoring responseId from a prior session). Typically only set when hydrating from a snapshot.

Inherited from​

Omit.modelState

name​

• Optional name: string

Optional name for the agent. Defaults to "Strands Agent".

Inherited from​

Omit.name

plugins​

• Optional plugins: Plugin[]

Plugins to register with the agent.

Inherited from​

Omit.plugins

printer​

• Optional printer: boolean

Enable automatic printing of agent output to console. When true, prints text generation, reasoning, and tool usage as they occur. Defaults to true.

Inherited from​

Omit.printer

sandbox​

• Optional sandbox: false | Sandbox

Execution environment for running commands, code, and file operations. When provided, sandbox-aware tools route operations through it.

Two distinct intents, even though they resolve to the same host execution in Node today:

  • Omitted: use the environment's default sandbox (host execution in Node). This default is the slot reserved for richer behavior later.
  • false: explicitly opt out of a managed sandbox and run on the host.

Keep false distinct from omitting so the opt-out stays stable even if the default changes.

Inherited from​

Omit.sandbox

sessionManager​

• Optional sessionManager: SessionManager

Session manager for saving and restoring agent sessions

Inherited from​

Omit.sessionManager

streamingBatchInterval​

• Optional streamingBatchInterval: Duration

streamingTopic​

• Optional streamingTopic: string

structuredOutputSchema​

• Optional structuredOutputSchema: ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>

Zod schema for structured output validation.

Inherited from​

Omit.structuredOutputSchema

systemPrompt​

• Optional systemPrompt: string | SystemContentBlock[] | SystemContentBlockData[]

A system prompt which guides model behavior.

Inherited from​

Omit.systemPrompt

toolExecutor​

• Optional toolExecutor: ToolExecutorStrategy

Strategy for executing tool calls from a single assistant turn. Defaults to 'concurrent'. See ToolExecutorStrategy for details.

Inherited from​

Omit.toolExecutor

tools​

• Optional tools: ToolList

An initial set of tools to register with the agent. Accepts nested arrays of tools at any depth, which will be flattened automatically. Agent instances are automatically wrapped as tools via Agent.asTool.

Inherited from​

Omit.tools

traceAttributes​

• Optional traceAttributes: Record<string, AttributeValue>

Custom trace attributes to include in all spans. These attributes are merged with standard attributes in telemetry spans. Telemetry must be enabled globally via telemetry.setupTracer() for these to take effect.

Inherited from​

Omit.traceAttributes