Skip to main content

Human Operator Workflow with Copilot

This tutorial covers the human side of customer operations in Flametree: you set up escalation and your operators (as an administrator), then handle a handed-over conversation (as an operator) using Copilot drafts, internal notes, assignment, and Resolve.

The example continues with EventHub, the fictional online-events company from the inbound tutorial — this time you staff the people who take over when the AI agent passes a conversation to a human. By the end you have:

  • An agent that escalates to people, with a default operator.
  • Operator users with a working schedule in Settings > Identity.
  • Operator notifications on — browser alerts plus the menu and tab badge.
  • Copilot configured on the agent.
  • One escalated conversation handled in Human Agents: read in context, answered with a Copilot draft, annotated with a note, assigned, and resolved.

Plan 30–45 minutes. The first four stages are administrator setup; the last four are the operator's day-to-day workflow. Each stage gives only the steps you need and links to the page that covers that screen in full.

Before you start

  • You are signed in to the portal. Stages 1–4 need the Tenant Admin role; stages 5–8 are done as a Tenant Operator. See Identity.
  • An agent already exists. If you do not have one, build it first with the Inbound Customer Service Agent tutorial — this tutorial reuses EventHub Assistant from there.
  • To follow both sides, have one administrator account and one operator account, or play both roles yourself.

Stage 1: Turn on escalation and set the default operator

Whether conversations reach an operator — and who they land on — is decided on the agent, not in the operator workspace. Open EventHub Assistant from AI Agents > Agents, then set escalation in the mode the agent uses.

Simple mode

  1. On the Instructions tab, switch Allow human handoff on.
  2. In Handoff Conditions, describe when to escalate, for example: Transfer to a human agent when the customer asks for a person, wants a refund, or is upset.
  3. Click Save.

Advanced mode

  1. Escalation is part of the agent's workflow — add a transition that hands the conversation to a human (for example, after repeated failures or on an explicit request). To send every conversation to a person from the first message, turn on Immediate human handoff in the General card instead.
  2. In the Advanced card, set Default operator to the portal users that this agent's handed-over conversations are assigned to by default, so escalations arrive already assigned rather than waiting in the Unassigned group.
  3. Click Save, then restart the agent: Stop agent, wait for Stopped, then Start agent.

Handoff fields in detail: Simple mode. Workflow escalation, Immediate human handoff, and the default operator: Advanced mode. How escalation drives the workspace: Human Agents.

Stage 2: Create operator users with a schedule

Operators answer live conversations in Human Agents and do not need configuration access, so give them the Tenant Operator role.

  1. Go to Settings > Identity and open the Users tab.
  2. Click Add User and fill in the Add user form: Name, Email, Password, and Role — choose Tenant Operator.
  3. In the Operator schedule section, find a day, click + to add a time range, and enter the start and end hour (0–24). Add ranges for each day the operator works. You enter hours in your local time; the schedule is stored in UTC and converted back automatically.
  4. Click Save. A User created successfully notification appears.
  5. Share the email and password so the operator can sign in.

To change a schedule later, click the edit (pencil) icon on the user's row and update the Operator schedule in the Edit user dialog. Roles, the schedule, and the full Identity screen: Identity.

Stage 3: Turn on operator notifications

So operators notice escalations, turn on browser notifications and rely on the badge. These steps run in the operator's own browser.

  1. Sign in as the operator. If the Enable notifications dialog appears, click Allow notifications and accept the browser prompt.
  2. Otherwise, open the Profile page and click Enable notifications in the header, then allow notifications if the browser asks. The header button then reads Notifications enabled.
  3. Confirm the badges work: the Human Agents item in the left menu shows a badge with the number of active conversations in the operator workspace, and a red dot marks the browser tab while the operator works in another tab.

Browser notifications fire You have new session assigned. when a conversation is assigned to the operator and New message: when a customer writes in a conversation they handle.

Permission states, the per-browser rule, and the tab badge: Notifications.

Stage 4: Configure Copilot on the agent

Copilot is the mode in which the agent drafts replies for the operator instead of answering the customer directly. To limit when the agent drafts, set Copilot working hours on the agent (Advanced mode).

  1. Open EventHub Assistant and switch on the Advanced mode toggle in the upper-right corner.
  2. In the Advanced card, find Copilot working hours.
  3. For each day, click + to add a time range with a start and end time; use the delete icon to remove a range.
  4. Click Save, then restart the agent: Stop agent, wait for Stopped, then Start agent.

You do not have to change anything else: when an operator claims a conversation, Copilot mode is on by default. Copilot working hours and the rest of the Advanced card: Advanced mode.

The setup is done. The remaining stages are the operator's workflow — sign in as the Tenant Operator from Stage 2.

Stage 5: Receive an escalated conversation

When the agent's conditions are met during a chat, the conversation moves to the operator workspace and the operator is notified.

  1. To produce one for this walkthrough, start a conversation with EventHub Assistant — for example on the web widget demo page — and write I want to talk to a human. The agent acknowledges the transfer and stops answering.
  2. As the operator, open Human Agents from the left menu. The escalated conversation is in the list — assigned to you if you are the agent's default operator, or in the Unassigned group otherwise.
  3. Choose a view at the top of the conversations list: Human Agent view groups by operator and adds an Unassigned group; AI Agent view groups by the AI agent that handled the conversation.
  4. Click the conversation card to open the chat in the center panel.

Views, filters, card warning tags, and how conversations arrive: Human Agents.

Stage 6: Read the context, then claim and answer

Before you answer, read what the conversation already produced, then take ownership.

  1. In the Information panel on the right, read Contact info, the AI-generated Summary, the Parameters, and the Results the agent collected — for EventHub, the name, email, phone, and preferred event date.
  2. Scroll up in the chat to read the full history. System markers show Transfer to human agent at <date and time> and who did what.
  3. In the chat header, click Assign, then Me. The confirmation Operator assigned. Copilot mode enabled appears, the message input becomes available, and Copilot mode is on by default.
  4. Read the Draft from Copilot suggestion in the chat, click the copy icon next to its label to insert it into the input, edit it as needed, and press Enter to send. The customer receives it as coming from you, labeled with your name.
tip

Treat drafts as a starting point — verify anything customer-specific, such as dates and commitments, before you send.

Reviewing context, claiming, and Copilot drafts: Human Agents.

Stage 7: Add a note and assign

Leave context for teammates and route the conversation when it needs another person.

  1. To record context, switch to the Notes tab above the input, write the note, and send it. It is saved with a Private note label and never reaches the customer.
  2. To hand off, click Assign (or the current owner's name) in the chat header and pick a teammate's name. Next to each name the dropdown shows how many conversations that person already owns — use the counts to balance the load. The history records <name> was assigned by <your name> at <date and time>, and the new owner sees everything that happened before.
warning

Check which tab is active before sending: Reply goes to the customer, Notes stays internal.

Private notes, assigning, and reassigning: Human Agents.

Stage 8: Resolve the conversation

When the customer's issue is handled, close the conversation so the list stays focused on what still needs attention.

  1. Open the conversation.
  2. Click the red Resolve button in the chat header — it appears only on assigned conversations.
  3. Confirm Are you sure you want to resolve this session? with Yes.

A Session resolved confirmation appears, and the conversation leaves the workspace. The chat keeps a permanent marker — The session was resolved by <your name> at <date and time> — and you can find the closed session later on the Sessions screen. If the customer writes again in the same channel, a new session starts and the AI agent handles it from the beginning.

tip

Before resolving, leave a Private note summarizing the outcome. If the conversation escalates again, the next operator sees your note in the history.

Resolving and what happens after: Human Agents.

What you built

  • An agent that escalates to people, with a default operator so handovers can arrive already assigned.
  • Operator users with the Tenant Operator role and a working schedule.
  • Operator notifications: browser alerts for assignments and replies, plus the menu and tab badge.
  • Copilot configured on the agent, with working hours.
  • One escalated conversation handled end to end: read in context, answered with a Copilot draft, annotated, assigned, and resolved.

An operator can also start a handover instead of waiting for one: on the Sessions screen, open an active session and click Hand over to the operator under the chat — the AI stops responding and the session appears in Human Agents unassigned.

Common issues

SymptomLikely causeFix
No escalations reach the workspaceThe agent has no handoff turned on, or its conditions are too narrowTurn on Allow human handoff (Simple mode) or add a workflow escalation (Advanced mode), and widen Handoff Conditions — see Configure escalation on the agent
Escalations always land in UnassignedNo Default operator is set on the agentSet Default operator in the Advanced card, then save and restart the agent
The Allow human handoff toggle is unavailableThe agent's workflow was modified in Advanced modeConfigure escalation in the workflow, or restore the default process — see Simple mode
An operator does not see Human Agents or AnalyticsThe account has the wrong roleSet the role to Tenant Operator on the Users tab of Identity
No browser notifications arriveNotifications are not enabled in that browser, or the role can't change the settingClick Enable notifications on the Profile page; subscriptions are per browser, so repeat in each one
No message input at the bottom of the chatThe conversation is unassignedClick Assign, then Me
No Draft from Copilot appearsThe Copilot switch is off, or the AI agent is stoppedTurn the Copilot switch on; ask a Tenant Admin to start the agent if the card shows Agent not running
The Resolve button is missingThe conversation is not assigned, or your role lacks the permissionAssign the conversation first; if it stays missing, ask your administrator

Was this article helpful?