ATLAS
AI Assistant Flow

Gemini-powered AI chat for both Posters and Contractors — advice, proposal writing, smart suggestions, and home analysis.

1 Chat Interface
2 AI Features
3 Settings & History
1 Chat & Features
2 Settings & History
1 AI Command Center
Section 1 — Chat Interface
AI Chat Contractor
9:41
AI Assistant
How should I price a kitchen backsplash tile job for a 120 sq ft kitchen?
Kitchen Backsplash Pricing Guide
  • Materials: $3–$8/sq ft for standard subway tile, $12–$25 for premium options
  • Labor: $10–$18/sq ft for installation (your market average)
  • 120 sq ft estimate: $1,560–$3,120 total for mid-range tile
Was this helpful?
What about if they want a herringbone pattern?
Herringbone adds 20–30% more labor due to precise angled cuts. For 120 sq ft, I'd recommend quoting $2,100–$4,200 to cover the additional time.
Was this helpful?
Include material markup?
Write a proposal
Ask me anything...

ContractorAIAssistantScreen — terracotta chat bubbles, sparkle avatar

sendChatMessage(sessionId, message, "contractor")

AI Chat Poster
9:41
AI Assistant
What should I look for when hiring a roofing contractor?
Roofing Contractor Checklist
Verify they carry general liability and workers' comp insurance
Ask for their Ohio contractor license number
Request 3 recent references for similar roof work
Get a written warranty covering materials and labor
Compare at least 3 competitive bids before deciding
Was this helpful?
Typical roofing costs?
How long does it take?
Shingle vs metal?
Ask me anything...

AIAssistantScreen — deepBlue bubbles, checklist format, in-app links

sendChatMessage(sessionId, message, "poster")

Welcome / Empty Shared
9:41
AI Assistant
Your AI Assistant
I can help you with questions about posting jobs, finding contractors, understanding costs, and more.
Get Advice
Home improvement tips and guidance
Write Proposals
AI-crafted bid proposals that win
Analyze Data
Market pricing and job insights
Find Jobs
Discover matching opportunities
Try asking:
How do I post a job?
What are typical costs for home repairs?
How does the bidding process work?
Start a conversation...

EmptyState — hero IconCircle, capability grid, QUICK_PROMPTS array

createChatSession(role) → loadChatHistory(sessionId, role)

Section 2 — AI Features
Proposal Writer Contractor
9:41
Proposal Writer
Job Details
Paste or describe the job
Kitchen backsplash installation. 120 sq ft. Homeowner wants white subway tile in herringbone pattern. Existing drywall in good condition.
Tone
Professional
Friendly
Detailed
Generated Proposal
Dear Homeowner,

Thank you for considering our team for your kitchen backsplash project. Based on the specifications you've provided, here is our proposal:

Scope of Work: Installation of white subway tile in a herringbone pattern across 120 sq ft of kitchen backsplash area, including surface preparation, tile cutting, setting, and grouting.

Estimated Cost: $2,640 – $3,480
Includes materials, labor, and cleanup

Timeline: 3–4 business days

We carry full liability insurance and provide a 2-year warranty on all tile work. Happy to schedule a walkthrough at your convenience.

ProposalWriterView — tone selector, editable preview, terracotta accent

generateProposal(jobDetails, tone) → useMutation(api.jobs.bids.update)

Smart Suggestions Contractor
9:41
Smart Suggestions
Pricing Recommendation
Market Insight
Based on 47 similar plumbing jobs in Summit County, your average bid is 12% below market rate. Consider raising your base rate from $85/hr to $95/hr.
Optimal Bid Range
New Job Match
Bathroom Remodel — Cuyahoga Falls
Based on your win rate and market data, bid between $4,200–$5,100 for highest probability of winning.
Schedule Optimization
Efficiency
You have a 2-hour gap between jobs on Tuesday 2/25. There's a small faucet repair job 0.8 miles from your afternoon appointment that could fill the gap.
Upsell Opportunity
Revenue
Client Sarah M. has a water heater that's 14 years old based on permit records. Average lifespan is 12 years. Consider suggesting a preemptive replacement.

SmartSuggestionsView — AI dashboard cards with apply/dismiss actions

useQuery(api.ai.getSmartSuggestions, { contractorId })

Home Advisor Poster
9:41
Home Advisor
Upload a Photo
Take or upload a photo of the area that needs work
AI Analysis
Based on similar projects
Estimated Cost
$1,800 – $3,200
Urgency Assessment
Moderate — address within 2–4 weeks
Recommended Contractor
Licensed Plumber (P2 or higher)
Get More Details
Similar Projects
DIY Guide

HomeAdvisorView — photo upload, AI analysis, deepBlue accent

analyzePhoto(imageUri) → Gemini 3 Flash vision endpoint

Section 3 — Settings & History
Chat History Shared
9:41
Chat History
Search conversations...
Kitchen Backsplash Pricing
8 messages · Today, 9:32 AM
Proposal for Bathroom Remodel
12 messages · Yesterday, 3:15 PM
Insurance Requirements in Ohio
5 messages · Feb 22, 11:08 AM
Customer Communication Tips
6 messages · Feb 21, 8:47 AM
Best Practices for HVAC Bids
9 messages · Feb 19, 2:30 PM
Roofing Contractor Checklist
4 messages · Feb 18, 10:15 AM
Clear All History

ChatHistoryView — searchable list, resume conversation, clear option

getChatSessions(role) → ChatSessionSummary[]

AI Preferences Shared
9:41
AI Preferences
AI Personality
Professional
Formal, concise, business-focused
Casual
Friendly, conversational, approachable
Detailed
Thorough explanations with examples
Notifications
Proactive Suggestions
Get AI tips based on your activity
Data Sharing
Allow AI to use your job history for better advice
Model
Gemini 3 Flash
gemini-3-flash-preview
Optimized for fast, accurate responses about home services, pricing, and contractor guidance.
Usage This Month
Conversations
23
Suggestions Applied
8

AIPreferencesView — personality selector, toggles, model info, usage KPIs

useQuery(api.users.preferences.getAI) → useMutation(api.users.preferences.updateAI)

Data Architecture
Schema
aiConversations — chat sessions
userId, role, sessionName, createdAt, updatedAt, messageCount, lastMessage

aiMessages — per-message records
sessionId, text, isUser, timestamp, sources[], imageUrl, isHelpful, rating

aiPreferences — user settings
userId, personality, proactiveSuggestions, dataSharing, role

aiSuggestions — proactive cards
contractorId, type, title, description, actionData, status, createdAt
Hooks & Queries
useAIChat — session management, message sending, history loading

useAISuggestions — smart suggestion cards with apply/dismiss actions

sendMessage — POST to /v1/{role}/ai/chat
generateProposal — POST with jobDetails + tone
getChatHistory — GET /v1/{role}/ai/chat/{sessionId}/history
getSmartSuggestions — contractor-only proactive cards
rateMessage — POST feedback (thumbs up/down)
deleteSession — DELETE session by ID
AI Model & Service
Gemini 3 Flash (gemini-3-flash-preview) — text/chat, summaries, Q&A · services/aiChatService.ts — createChatSession, loadChatHistory, sendChatMessage, rateMessage, deleteSession, renameSession · QUICK_PROMPTS — poster (5), contractor (5), admin (5)
Chat & Features
Chat & Features
9:41
Chat & Features
Recent Chats
342
Queries
94%
Accuracy
1.2s
Avg Response
$8.4K
Time Saved
Recent Chats
Estimate for roof repair
Today, 2:15 PM
Active
Schedule optimization
Today, 11:30 AM
Done
Material cost lookup
Yesterday
Done
Settings & History
Settings & History
9:41
Settings & History
Details
Title
Response Language: English
Description
AI tone set to professional. Responses include cost estimates when relevant.
Configuration
Auto-Suggest Replies
Save Chat History
Preview
Conversation Transcript
Full chat thread with timestamps, suggested actions, and homeowner context.
Performance
92%
Helpful
+8%
Accuracy
1.4s
Avg Reply
AI Command Center
AI Command Center
https://app.3bids.io/contractor/ai-assistant
3Bids
Main
Chat ⌘1
Suggestions ⌘2
History ⌘3
AI Settings ⌘4
Usage ⌘5
MK
Mike Kowalski
Contractor
Settings ⌘,

AI Command Center

4,281
Total Queries
96%
Accuracy Rate
$24.5K
Time Saved
1.1s
Avg Response
Recent Activity
Estimate for roof repair
Today, 2:15 PM
Schedule optimization
Today, 11:30 AM
Material cost lookup
Yesterday
Performance