Add instructions to the AI.

Inserts a system message as the first item in the model's context.

Examples

iex> add_instructions(%AIPayload{}, "Please summarize the text.")
%AIPayload{instructions: "Please summarize the text."}

Add a message to the AI's context.

This is usually a user message or input.

Examples

iex> add_message(%AIPayload{}, "What's the weather?")
%AIPayload{input: [%{role: "user", content: "What's the weather?"}]}

Set the AI model to use.

Examples

iex> set_model(%AIPayload{}, "gpt-4.1")
%AIPayload{model: "gpt-4.1"}

Set a schema.

Raises ArgumentError if schema's name is missing or empty.

Examples

iex> set_schema(%AIPayload{}, %AISchema{name: "test"})
%AIPayload{text: %{format: %AISchema{name: "test"}}}

iex> set_schema(%AIPayload{}, %AISchema{})
** (ArgumentError) schema name cannot be empty