Jido.AI.Actions.LLM.Chat (Jido AI v2.1.0)

A Jido.Action for chat-style LLM interactions with optional system prompts.

This action uses ReqLLM directly to generate chat-style responses from language models. It supports model aliases via Jido.AI.resolve_model/1 and optional system prompts for conversation context.

Parameters

model (optional) - Model alias (e.g., :fast, :capable) or direct spec (e.g., "anthropic:claude-haiku-4-5")
prompt (required) - The user prompt to send to the LLM
system_prompt (optional) - System prompt to guide the LLM's behavior
max_tokens (optional) - Maximum tokens to generate (default: 1024)
temperature (optional) - Sampling temperature 0.0-2.0 (default: 0.7)
timeout (optional) - Request timeout in milliseconds

Examples

# Basic chat
{:ok, result} = Jido.Exec.run(Jido.AI.Actions.LLM.Chat, %{
  prompt: "What is Elixir?"
})

# With system prompt
{:ok, result} = Jido.Exec.run(Jido.AI.Actions.LLM.Chat, %{
  model: :capable,
  prompt: "Explain GenServers",
  system_prompt: "You are an expert Elixir teacher.",
  temperature: 0.5
})

# Direct model spec
{:ok, result} = Jido.Exec.run(Jido.AI.Actions.LLM.Chat, %{
  model: "openai:gpt-4",
  prompt: "Hello!"
})

Summary

Functions

__action_metadata__()

Returns the Action metadata. Alias for to_json/0.

category()

Returns the category of the Action.

description()

Returns the description of the Action.

name()

Returns the name of the Action.

on_after_run(result)

Lifecycle hook called after Action execution.

on_after_validate_output(output)

Lifecycle hook called after output validation.

on_after_validate_params(params)

Lifecycle hook called after parameter validation.

on_before_validate_output(output)

Lifecycle hook called before output validation.

on_before_validate_params(params)

Lifecycle hook called before parameter validation.

on_error(failed_params, error, context, opts)

Lifecycle hook called when an error occurs.

output_schema()

Returns the output schema of the Action.

run(params, context)

Executes the chat action.

schema()

Returns the input schema of the Action.

tags()

Returns the tags associated with the Action.

to_json()

Returns the Action metadata as a JSON-serializable map.

to_tool()

Converts the Action to an LLM-compatible tool format.

validate_output(output)

Validates the output result for the Action.

validate_params(params)

Validates the input parameters for the Action.

vsn()

Returns the version of the Action.

Functions

__action_metadata__()

Returns the Action metadata. Alias for to_json/0.

category()

Returns the category of the Action.

description()

Returns the description of the Action.

name()

Returns the name of the Action.

on_after_run(result)

@spec on_after_run({:ok, map()} | {:error, any()}) :: {:ok, map()} | {:error, any()}

Lifecycle hook called after Action execution.

on_after_validate_output(output)

@spec on_after_validate_output(map()) :: {:ok, map()} | {:error, any()}

Lifecycle hook called after output validation.

on_after_validate_params(params)

@spec on_after_validate_params(map()) :: {:ok, map()} | {:error, any()}

Lifecycle hook called after parameter validation.

on_before_validate_output(output)

@spec on_before_validate_output(map()) :: {:ok, map()} | {:error, any()}

Lifecycle hook called before output validation.

on_before_validate_params(params)

@spec on_before_validate_params(map()) :: {:ok, map()} | {:error, any()}

Lifecycle hook called before parameter validation.

on_error(failed_params, error, context, opts)

@spec on_error(map(), any(), map(), keyword()) :: {:ok, map()} | {:error, any()}

Lifecycle hook called when an error occurs.

output_schema()

Returns the output schema of the Action.

run(params, context)

@spec run(map(), map()) :: {:ok, map()} | {:ok, map(), any()} | {:error, any()}

Executes the chat action.

Returns

{:ok, result} - Successful response with text, model, and usage keys
{:error, reason} - Error from ReqLLM or validation

Result Format

%{
  text: "The LLM's response text",
  model: "anthropic:claude-haiku-4-5",
  usage: %{
    input_tokens: 10,
    output_tokens: 25,
    total_tokens: 35
  }
}

schema()

Returns the input schema of the Action.

tags()

Returns the tags associated with the Action.

to_json()

Returns the Action metadata as a JSON-serializable map.

to_tool()

Converts the Action to an LLM-compatible tool format.

validate_output(output)

@spec validate_output(map()) :: {:ok, map()} | {:error, String.t()}

Validates the output result for the Action.

Examples

iex> defmodule ExampleAction do
...>   use Jido.Action,
...>     name: "example_action",
...>     output_schema: [
...>       result: [type: :string, required: true]
...>     ]
...> end
...> ExampleAction.validate_output(%{result: "test", extra: "ignored"})
{:ok, %{result: "test", extra: "ignored"}}

iex> ExampleAction.validate_output(%{extra: "ignored"})
{:error, "Invalid output for Action: Required key :result not found"}

validate_params(params)

@spec validate_params(map()) :: {:ok, map()} | {:error, String.t()}

Validates the input parameters for the Action.

Examples

iex> defmodule ExampleAction do
...>   use Jido.Action,
...>     name: "example_action",
...>     schema: [
...>       input: [type: :string, required: true]
...>     ]
...> end
...> ExampleAction.validate_params(%{input: "test"})
{:ok, %{input: "test"}}

iex> ExampleAction.validate_params(%{})
{:error, "Invalid parameters for Action: Required key :input not found"}

vsn()

Returns the version of the Action.