create_chat_session: Create a Chat Session

In aisdk: Unified Interface for AI Model Providers

Create a Chat Session

Description

Factory function to create a new ChatSession object.

Usage

create_chat_session(
  model = NULL,
  system_prompt = NULL,
  tools = NULL,
  hooks = NULL,
  max_steps = 10,
  metadata = NULL,
  agent = NULL
)

Arguments

model	A LanguageModelV1 object or model string ID.
system_prompt	Optional system prompt.
tools	Optional list of Tool objects.
hooks	Optional HookHandler object.
max_steps	Maximum tool execution steps. Default 10.
metadata	Optional session metadata (list).
agent	Optional Agent object to initialize from.

Value

A ChatSession object.

Examples

if (interactive()) {
  # Create a chat session
  chat <- create_chat_session(
    model = "openai:gpt-4o",
    system_prompt = "You are a helpful R programming assistant."
  )

  # Create from an existing agent
  agent <- create_agent("MathAgent", "Does math", system_prompt = "You are a math wizard.")
  chat <- create_chat_session(model = "openai:gpt-4o", agent = agent)

  # Send messages
  response <- chat$send("How do I read a CSV file?")
  print(response$text)

  # Continue the conversation (history is maintained)
  response <- chat$send("What about Excel files?")

  # Check stats
  print(chat$stats())

  # Save session
  chat$save("my_session.rds")
}

aisdk documentation built on May 29, 2026, 9:07 a.m.