chat-session

Chat Session Sample

This sample demonstrates session-based multi-turn chat with persistence in Genkit Java.

Features

• Multi-turn conversations - Automatic conversation history management
• Session state - Track user preferences and conversation context
• Session persistence - Save and load sessions across interactions
• Tool integration - Using tools (note-taking) within chat sessions
• Multiple personas - Choose between assistant, tutor, and creative modes

Prerequisites

1. Java 21 or later
2. Maven
3. OpenAI API key

Prerequisites

• Java 21+
• Maven 3.6+
• OpenAI API key

Running the Sample

Option 1: Direct Run (Interactive Mode)

# Set your OpenAI API key
export OPENAI_API_KEY=your-api-key-here

# Navigate to the sample directory
cd java/samples/chat-session

# Run the sample
./run.sh
# Or: mvn compile exec:java

Option 2: Demo Mode

Run the automated demo to see all features:

cd java/samples/chat-session
mvn exec:java -Dexec.args="--demo"

Option 3: With Genkit Dev UI

# Set your OpenAI API key
export OPENAI_API_KEY=your-api-key-here

# Navigate to the sample directory
cd java/samples/chat-session

# Run with Genkit CLI
genkit start -- ./run.sh

The Dev UI will be available at http://localhost:4000

Commands

During interactive chat, you can use these commands:

Command	Description
/history	Show conversation history
/notes	Show saved notes
/state	Show session state
/topic X	Set conversation topic to X
/quit	Exit the chat

Example Session

What's your name? Alice

Choose a chat persona:
  1. Assistant (general help)
  2. Tutor (learning & education)
  3. Creative (storytelling & ideas)
Enter choice (1-3): 2

✓ Session created: a1b2c3d4-e5f6-...
✓ Persona: tutor

You: What is photosynthesis?