Alloy.Agent.Config (alloy v0.7.4)

Configuration for an agent run.

Built from the options passed to Alloy.run/2. Immutable for the duration of the run.

Summary

Types

t()

Functions

from_opts(opts)

Builds a config from Alloy.run/2 options.

with_provider(config, provider)

Returns an updated config with a new provider while preserving unrelated options.

Types

t()

@type t() :: %Alloy.Agent.Config{
  code_execution: boolean(),
  context: map(),
  fallback_providers: [{module(), map()}],
  max_pending: non_neg_integer(),
  max_retries: non_neg_integer(),
  max_tokens: pos_integer(),
  max_tokens_explicit?: boolean(),
  max_turns: pos_integer(),
  middleware: [module()],
  model_metadata_overrides: map(),
  on_compaction: (list(), Alloy.Agent.State.t() -> any()) | nil,
  on_shutdown: (Alloy.Session.t() -> any()) | nil,
  provider: module(),
  provider_config: map(),
  pubsub: module() | nil,
  retry_backoff_ms: pos_integer(),
  subscribe: [String.t()],
  system_prompt: String.t() | nil,
  timeout_ms: pos_integer(),
  tool_timeout: pos_integer(),
  tools: [module()],
  working_directory: String.t()
}

Functions

from_opts(opts)

@spec from_opts(keyword()) :: t()

Builds a config from Alloy.run/2 options.

with_provider(config, provider)

@spec with_provider(t(), module() | {module(), keyword() | map()}) :: t()

Returns an updated config with a new provider while preserving unrelated options.

If max_tokens was not set explicitly, the budget is re-derived from the new provider model and current model_metadata_overrides.