# Chat in the Web App

The web app is the primary way to interact with your employees. Open the workspace, pick an employee or team, and start typing.

## TL;DR

Log in, click an employee in the sidebar, type your message. You get a streaming response with real-time visibility into what the employee is thinking, doing, and planning. No setup required.

## How It Works

The workspace is a chat interface. Your AI employees are listed in the sidebar. Click one to open a conversation.

- **Streaming responses.** Tokens appear word-by-word as the employee thinks
- **Execution timeline.** See every step: reading, thinking, tool calls, each with a spinner or checkmark
- **Reasoning visible.** When the employee uses a reasoning model, you can expand the "Thinking" section to see its chain of thought
- **Planning visible.** When the employee creates a plan, a todo overlay appears showing its steps in real-time
- **Tool use.** See which tools the employee calls, with expandable results for each
- **Credit cost.** Every message shows its token count and credit cost. Hover for a full breakdown

## What You Can Do

| Action | How |
|--------|-----|
| **Send a message** | Type in the input area and hit Enter |
| **Stop a response** | Click the **Stop** button or press **Escape** |
| **Approve actions** | When the employee needs to do something sensitive, Approve/Reject buttons appear inline |
| **Choose options** | Click one of the choices the employee presents |
| **Inspect the prompt** | Click "View Prompt" to see the exact system prompt, conversation history, and tool definitions |
| **Upload files** | Drag and drop or click the attachment icon to share documents |
| **Switch to voice** | Click the microphone icon to start a voice conversation within the same chat |

## How to Set It Up

**Nothing to do.** Web Chat is the default channel. Log in and start talking to any employee.

The web app runs in any browser: desktop, tablet, or phone. Same workspace, same conversations, same real-time updates. There is also a desktop app for browser and computer control capabilities.

## Tips and Tricks

- **Be specific.** "Draft a follow-up email for the client meeting about pricing" works better than "write an email"
- **Use stop wisely.** If the employee goes in the wrong direction, hit Escape early and rephrase
- **Check the execution timeline.** Expanding tool call steps shows you exactly what the employee did and what data it used
- **Inspect prompts for debugging.** If the employee behaves unexpectedly, "View Prompt" shows the full context it received

## Behind the Scene

| | |
|---|---|
| **Powered by** | GraphQL subscriptions over WebSocket |
| **Streaming** | Tokens stream in real-time via a dedicated subscription channel |
| **Fallback** | If WebSocket disconnects, polling kicks in automatically |
| **UI library** | assistant-ui for message rendering and streaming |

## What It Costs

| | |
|---|---|
| **Token credits** | Based on model and token count per message |
| **Runtime credits** | 1 credit per minute of processing time |
| **Workflow credits** | 1 credit per execution |

## Is It Safe

- **Authenticated access.** Every session requires login. No anonymous access to employee conversations
- **Tenant isolation.** You can only see your own company's employees and conversations. Cross-tenant access is impossible
- **Encrypted transport.** All communication uses HTTPS/WSS

## Good to Know

- **Conversations persist.** Come back later and your full chat history is there
- **Mixed channels.** Messages from other channels (API, MCP, Voice) appear in the same conversation history
- **Real-time updates.** If an employee completes a scheduled task or receives a webhook, the result appears in chat automatically
- **Always available.** Web Chat is enabled by default and cannot be disabled. It is the baseline channel for every employee

## Frequently Asked Questions

**Q: Can I use Web Chat on my phone?**
A: Yes. The web app is fully responsive and works in any mobile browser.

**Q: Do I lose my conversation history if I close the browser?**
A: No. All conversations are saved and available when you log back in.

**Q: Can multiple people chat with the same employee?**
A: Each user has their own conversation thread. The employee keeps context separate per user.

**Q: Is there a message length limit?**
A: No hard limit, but very long messages use more credits. For large documents, use file upload instead.

**Q: Can I export my chat history?**
A: Not yet. This feature is on the roadmap.