$50 free credit for new accounts - ends in

Claim $50

Setup

How to set up ai agents for human handoff

How to set up ai agents for human handoff — answered from your own docs. How Knowledge Base Software teams use Chatref (ai agents, ai agents) to solve it. Start

Chatref Team4 min read / Updated June 25, 2026

Setting up ai agents for human handoff in Chatref means training an agent to answer from your knowledge base and routing complex questions to a shared inbox where your team takes over - with full chat history, so nothing gets lost mid-conversation.

Before you start

You need an active Chatref agent trained on your support content. Upload setup guides, how-to articles, and policy docs that cover the questions your team handles today. The agent uses those documents to answer directly, without guessing.

You also need at least one team member logged into your Chatref workspace to pick up handoffs. The Knowledge Base Software your team maintains is what makes the handoff work - stale or incomplete docs lead to more escalations, not fewer.

Team members don't need a paid seat. Chatref's pay-as-you-go model means you pay only for coin usage, not per user.

Step-by-step setup

  1. Train your agent on the right content. Go to your agent's Sources tab and add every document a support rep would reference during a ticket - PDFs, site pages, plain text. The agent answers only from this material, so include edge cases and common failure modes your team frequently explains.

  2. Enable human handoff in your agent's Settings. Under Routing, choose the option that sends conversations to your shared inbox when the agent cannot resolve a question. You control what "cannot resolve" means - typically low-confidence answers or explicit help requests from the customer.

  3. Connect your shared inbox. Every Chatref workspace includes a realtime shared inbox where your team sees live conversations. When a customer asks something the agent cannot handle, the entire thread appears there, not a new ticket in some external tool. Your team opens the conversation and picks up exactly where the agent left off.

  4. Define who picks up what. In a small team, one person watching the inbox during business hours is enough. For larger ops, set an internal norm - "Alex handles billing handoffs before noon, Dana takes them after" - so nothing sits unattended. There is no round-robin assignment in Chatref yet, so lightweight process keeps things moving.

  5. Keep your knowledge base current. Every handoff is a signal that your docs are missing something. Review handoff conversations weekly, find the gap, and add the missing content back into your agent's sources. Each addition reduces future handoffs.

Check it works

Open your widget and ask the agent a straightforward question from your docs. It should answer confidently, grounded in your content. Then ask something deliberately out of scope - a complex billing dispute, a custom integration question, or a plain "I need a human." The agent should acknowledge it cannot answer and hand the conversation to your shared inbox.

In your Chatref workspace, open the shared inbox. You should see the conversation appear in real time, with the full chat history visible. Reply from there, and verify that the customer sees your response in the same chat thread they started with the agent. The handoff is invisible to the customer - no "transferring to an agent" noise, just a smooth continuation.

Check that the agent does not re-enter the conversation while a human is active. Chatref keeps the thread human-owned until your team closes it, preventing the agent from jumping back in with an unhelpful answer.

Common issues

Handoff triggers too often, even for questions your docs cover. Your agent's confidence threshold is set too high, or your training content doesn't include the exact phrasing customers use. Add more varied wording to your sources and lower the handoff threshold in agent settings until the balance feels right.

Conversations appear in the inbox without full context. This happens when a customer starts a new session before the handoff completes. Make sure your widget's session window is long enough - users navigating away and returning within a few minutes should re-enter the same thread.

Team members miss handoffs because they aren't watching the inbox during business hours. If your team can't monitor in real time, set a clear response SLA internally and communicate expected wait times to customers early in the conversation. Chatref doesn't send push notifications for handoffs yet, so process discipline matters.

FAQ

What causes human handoff problems for Knowledge Base Software?

Three recurring issues: incomplete training content that doesn't cover the actual questions customers ask, handoff thresholds set so generously that agents punt easy questions to humans, and teams not monitoring the shared inbox during promised hours. Each problem makes the handoff feel broken even when the tool works as designed.

How do I improve human handoff for Knowledge Base Software?

Tighten the feedback loop. Review handoff conversations every week and add the missing answers to your knowledge base so the agent handles more questions next time. Lower your handoff threshold only as your content coverage improves. And assign one person clear inbox-ownership per shift so conversations don't sit unattended.

Put this into practice

Chatref answers your customers from your own content, day and night. Add it to your site and go live in minutes – free to start.

Get started