Examples - Smallest AI - Atoms Documentation

Getting Started
Agent Development
Calling
Platform Features
Analytics
End-to-End Projects
Observability
Running Examples
Deploying Examples

Complete, runnable examples you can deploy in minutes. Each example includes full source code, setup instructions, and deployment guide.

All examples are available in the cookbook repository.

Getting Started

Your First Agent

5 min · Build and deploy a basic conversational agent.OutputAgentNode · OpenAIClient · AtomsApp · CLI deployment

Agent Development

Agent with Tools

10 min · Give your agent actions it can perform.@function_tool · ToolRegistry · Tool execution · LLM function calling

Background Agent

15 min · Real-time sentiment analysis alongside your main agent.BackgroundAgentNode · Multi-node architecture · Shared state · Silent processing

Interrupt Control

10 min · Configure how your agent handles user interruptions.is_interruptible · Dynamic settings · Barge-in handling

Language Switching

15 min · Multilingual agent with language detection.Language detection · Dynamic prompts · Multi-language support

Calling

Call Control

10 min · End calls and transfer to human agents.SDKAgentEndCallEvent · SDKAgentTransferConversationEvent · Cold/warm transfers · Hold music

Inbound IVR

15 min · Build an interactive voice response menu.Menu navigation · DTMF handling · Department routing

Platform Features

Knowledge Base RAG

15 min · Connect your agent to a knowledge base for accurate answers.Knowledge base setup · RAG retrieval · Document upload

Campaigns

20 min · Run outbound calling campaigns at scale.AtomsClient · Audience management · Campaign creation · Batch calling

Analytics

Call Analytics

10 min · Retrieve call metrics, transcripts, and post-call analysis.Call details · Transcript export · Post-call configuration · Metrics API

End-to-End Projects

Bank CSR Agent

30 min · Production-grade voice banking agent with real database queries, identity verification, and compliance logging.BackgroundAgentNode · SQL execution · Multi-round tool chaining · KBA verification · Audit logging · Call transfers

Appointment Scheduler

20 min · Voice-based clinic receptionist that checks real Cal.com availability, negotiates time slots, and books appointments.Cal.com API · Slot negotiation · @function_tool · Real calendar booking

Form Filler

20 min · State-machine-driven voice data collection with typed validation, backtracking, and native Jotform submission.FormEngine · Step-by-step collection · Field validation · Jotform integration

Observability

Langfuse Integration

15 min · Real-time voice agent observability with Langfuse via a BackgroundAgentNode — tool calls, LLM generations, and transcripts stream to your dashboard with zero latency impact.BackgroundAgentNode · Langfuse traces · LLM generation tracking · Tool call spans

Running Examples

Each example follows the same pattern:

# Clone the cookbook
git clone https://github.com/smallest-inc/cookbook
cd cookbook/voice-agents/<example>

# Install dependencies
pip install -e .

# Set environment variables
export OPENAI_API_KEY="your-key"

# Run locally
python app.py

# Test with CLI (in another terminal)
smallestai agent chat

Deploying Examples

# Login to Smallest AI
smallestai auth login

# Link to your agent
smallestai agent init

# Deploy
smallestai agent deploy --entry-point app.py

# Make live
smallestai agent builds

Post-Call Analytics