Create a CodeAct Module

Factory function to create a CodeActModule that can use both tools and R code execution to solve problems. Use run() to execute it. run_async() supports factory-backed modules; async streaming and module $stream() reject CodeAct. run_stream() preserves the synchronous forward() fallback unless a matching token-stream request is active; that request is rejected first.

Usage

code_act(
  signature,
  tools = list(),
  runner = NULL,
  interpreter_factory = NULL,
  max_iterations = 10L,
  config = list(),
  chat = NULL,
  ...
)

Arguments

signature

A Signature object or string notation defining inputs/outputs

tools

List of ellmer ToolDef objects for the agent to use. Non-empty list element names become the registered tool names; unnamed elements keep their ToolDef name. Effective names may contain only letters, numbers, hyphens, and underscores.

runner

Optional caller-owned code runner implementing execute() and policy(). It is retained, never automatically shut down, and must not be shared concurrently when persistent.

interpreter_factory

Optional zero-argument function returning a fresh runner with execute(), policy(), optional start(), and idempotent terminal shutdown(). Supply exactly one of runner and interpreter_factory.

max_iterations

Maximum outer agent iterations and maximum tool calls within one invocation (default 10). Exceeding the inner tool-call budget raises a dsprrr_codeact_iteration_limit error.

config

Optional prediction configuration.

chat

Optional ellmer Chat object.

...

Must be empty.

Value

A CodeActModule object

Examples

if (FALSE) { # \dontrun{
runner <- r_code_runner(timeout = 30)
agent <- code_act(
  "question -> answer",
  tools = list(),
  runner = runner
)
result <- run(agent, question = "Calculate 2^10", .llm = llm)
} # }