Gemini.Chat (GeminiEx v0.2.1)

View Source

Formalized chat session management with immutable history updates.

This module provides a robust, immutable approach to managing multi-turn conversations with the Gemini API, including proper handling of tool-calling turns with function calls and responses.

Usage

# Create a new chat session
chat = Gemini.Chat.new(model: "gemini-2.0-flash-lite", temperature: 0.7)

# Add turns to the conversation
chat = chat
|> Gemini.Chat.add_turn("user", "What's the weather like?")
|> Gemini.Chat.add_turn("model", [%Altar.ADM.FunctionCall{...}])
|> Gemini.Chat.add_turn("user", [%Altar.ADM.ToolResult{...}])
|> Gemini.Chat.add_turn("model", "Based on the weather data...")

# Generate content with the chat history
{:ok, response} = Gemini.generate_content(chat.history, chat.opts)

Summary

Types

t()

A chat session containing conversation history and configuration options.

Functions

add_turn(chat, role, message)

Add a turn to the chat history.

new(opts \\ [])

Create a new chat session with optional configuration.

Types

t()

@type t() :: %Gemini.Chat{history: [Gemini.Types.Content.t()], opts: keyword()}

A chat session containing conversation history and configuration options.

Functions

add_turn(chat, role, message)

@spec add_turn(
  t(),
  String.t(),
  String.t()
  | [map()]
  | [Altar.ADM.FunctionCall.t()]
  | [Altar.ADM.ToolResult.t()]
) :: t()

Add a turn to the chat history.

This function handles different types of content based on the role and message type:

  • User text messages: add_turn(chat, "user", "Hello")
  • Model text responses: add_turn(chat, "model", "Hi there!")
  • Model function calls: add_turn(chat, "model", [%FunctionCall{...}])
  • User function responses: add_turn(chat, "user", [%ToolResult{...}])

Returns a new chat struct with the updated history, preserving immutability.

new(opts \\ [])

@spec new(keyword()) :: t()

Create a new chat session with optional configuration.

Options

All standard Gemini API options are supported:

  • :model - Model name (defaults to configured default)
  • :temperature - Generation temperature (0.0-1.0)
  • :max_output_tokens - Maximum tokens to generate
  • :generation_config - Full GenerationConfig struct
  • :safety_settings - List of SafetySetting structs
  • :system_instruction - System instruction content
  • And more...

Examples

chat = Gemini.Chat.new()
chat = Gemini.Chat.new(model: "gemini-2.5-pro", temperature: 0.3)