Getting Started with Chat

Learn how to use the Agency Hero chat interface to interact with AI agents, ask questions, and get work done across your workspaces.

The chat panel is your always-available interface for working with Agency Hero’s AI agents. Whether you’re deep in a client workspace or browsing your home feed, the chat is right there — ready to answer questions, surface context, take actions, and coordinate complex tasks on your behalf.

This article walks you through the basics: what the chat is, how to navigate it, and how to get the most out of your first conversations.

What is the chat interface?

The chat panel is a persistent AI workspace built into the Agency Hero shell. Unlike typical chatbots, it doesn’t just answer questions — it’s grounded in your real workspace data. The agent knows what workspace you’re looking at, can search your meeting history and knowledge base, create tasks, log decisions, and even spawn specialized sub-agents to tackle complex requests in parallel.

Key characteristics:

  • Always visible — The chat never unmounts as you navigate. Switch pages, open different workspaces, or dig into a task — the chat stays where it is.
  • Context-aware — Every message you send includes information about where you are in the app. The agent automatically loads context relevant to your current workspace, meeting, or task.
  • Action-capable — The agent can read and write. It can create tasks, log intelligence items, propose updates, and more — with your explicit approval before any changes are made.
  • Multi-threaded — You can run multiple conversations at the same time, each in its own thread tab.

Opening and navigating the chat

Work Mode vs. Chat Mode

Agency Hero has two layout modes that affect how the chat panel is presented:

Work Mode (default) — The workspace content fills the center of the screen, and the chat panel sits in a column on the right. Thread tabs appear at the top of the chat column so you can quickly switch between active conversations.

Chat Mode — Chat becomes the primary focus. It expands to the center of the screen, and a Threads Rail appears on the left, listing all your conversations grouped by date (Today, Yesterday, Previous 7 Days, etc.). The workspace content moves to a narrower column on the right.

To switch between modes, press Cmd+Shift+C (Mac) or Ctrl+Shift+C (Windows/Linux), or click the Work/Chat toggle in the left navigation rail. Your preference is saved and persists across sessions.

Adjusting chat panel width

In Chat Mode, you can resize the chat column using the Size Presets control (the sliders icon in the chat header). Options range from Small (320px) to Maximum (up to 1,200px, filling the full workspace width). Useful presets:

PresetWidthBest for
Small320pxMinimal footprint while you work
Focus420pxFocused Q&A
Standard480pxDefault — good for most tasks
Large720pxReading longer responses
Maximum~1200pxFull-screen AI work sessions

Starting a conversation

Sending your first message

Type your message in the composer at the bottom of the chat panel and press Enter to send. To insert a line break without sending, use Shift+Enter.

The composer looks like this:

[@portabletext/react] Unknown block type "codeBlock", specify a component for it in the `components.types` prop
ButtonWhat it does
**[+]** (Attach)File attachment *(coming soon)*
**[@]** (Mention)Context mentions *(coming soon)*
**[🌐]** (Web Search)Toggle web search for this turn
**[→]** (Send)Submit your message
**[■]** (Stop)Cancel a streaming response

Starting a new thread

You can start a fresh conversation at any time:

  • In Work Mode, click the [+] button in the tab bar at the top of the chat column.
  • In Chat Mode, click [+ New Chat] at the bottom of the Threads Rail, or the Plus icon in the chat header.

Each new thread is a blank slate with no prior conversation history. The agent will still have access to your workspace context — it just won’t have memory of previous chat messages.

Switching between threads

  • In Work Mode, click any tab in the tab bar to switch. You can have up to 10 tabs open at once. Active streaming is indicated by a spinner on the tab.
  • In Chat Mode, click any thread in the Threads Rail. Threads are grouped by date and searchable.

Closing a tab (the × on the tab) doesn’t delete the conversation — it just removes it from your open tabs. You can find it again in the Threads Rail or via search.

What the agent knows about your context

One of the most important things to understand about Agency Hero chat is that the agent always knows where you are. Every message you send automatically includes your current location in the app — what workspace you’re in, what page you’re on, and what item you’re looking at.

Here’s how context maps to agent behavior:

Where you areWhat the agent loads
Inside a workspaceWorkspace details, meeting history, knowledge base, tasks
Viewing a meetingThat specific meeting's summary, transcript, and action items
Viewing a taskThe task details and linked workspace context
On a topic pageThe knowledge topic and related items
On a settings pageGeneral org context (no specific workspace data)

This means you rarely need to tell the agent which workspace or meeting you’re asking about — it already knows. Just ask naturally: “What did we decide last week?” or “Summarize the key risks in this deal.”

Context chips

When you navigate to a task or meeting and click “Chat about this,” a context chip appears above the composer, showing what’s attached to the conversation:

  • 🔒 Task chip — Shows the task title. The agent will use that task as its primary focus.
  • 📅 Meeting chip — Shows the meeting title with a “Using meeting context” label.

You can remove a chip by clicking the × on it if you want to broaden the conversation scope.

What the agent can do for you

The Agency Hero agent is a general-purpose orchestrator. It handles simple questions directly and, for complex work, delegates to specialized sub-agents behind the scenes.

Reading and answering questions

The agent can search across:

  • Workspace knowledge — Documents, notes, and extracted insights from your workspace
  • Meeting summaries — Synthesized summaries from past meetings
  • Meeting transcripts — Detailed utterance-level search within a meeting
  • Topics — Structured knowledge topics your team has built up
  • Intelligence items — Decisions, risks, open questions, and signals logged in your workspaces
  • Tasks — Task lists with filtering by status, assignee, and more
  • Upcoming meetings — Your calendar across all workspaces

Taking actions (with your approval)

The agent can propose changes that require your explicit approval before they execute. When the agent wants to take an action, you’ll see an approval card inline in the chat:

  • Task creation / update — Review the proposed task details, edit if needed, then approve or deny.
  • Intelligence items — Log a decision, flag a risk, capture an open question.
  • Linear tickets — Propose a ticket with title, description, and priority.

Approval cards show you exactly what will change. You can edit fields before approving. Nothing is written without your confirmation.

Spawning sub-agents for complex work

For research-heavy or multi-step requests, the agent can spawn specialized sub-agents. These run in parallel and return results to the main conversation. You’ll see the main agent synthesize everything into a coherent response. This happens automatically — you don’t need to do anything differently.

Workspace vs. cross-workspace context

By default, the agent is scoped to the workspace you’re currently in. This keeps responses focused and relevant.

However, you can ask questions that span multiple workspaces and the agent will search across all workspaces you have access to:

“What’s my week looking like across all my projects?”
“Are there any overdue tasks anywhere in my account?”
“Find all the decisions we’ve made about the API architecture.”

When the agent needs to write something (create a task, log an intelligence item), it will ask you which workspace to target if it can’t determine the right one from context.

Thread lifecycle: how conversations are managed

Agency Hero manages thread lifecycle automatically so you don’t have to think about it:

StateWhat happens
**Active**You're chatting; the conversation is live
**Idle (1 hour)**The agent quietly closes the workflow and generates a summary
**Resumed**Send a message to any closed thread — it picks up where you left off, with the summary loaded as context
**Archived**After 7 days idle, threads move to the Archive section in the Threads Rail. Sending a message unarchives automatically

You can also manually archive a thread via its context menu in the Threads Rail. Archived threads are never deleted — they’re just tucked away.

Tips for effective use

Be specific, but not overly formal. The agent understands natural language well. You don’t need to phrase things like commands — conversational questions work great.

Use the web search toggle for external questions. If you want the agent to look something up beyond your workspace (industry news, a competitor, a technical reference), click the 🌐 globe icon in the composer before sending.

Start fresh threads for new topics. Threads accumulate context over time. If you’re switching to an unrelated topic, a new thread keeps things clean and the agent more focused.

Let context do the work. Navigate to the relevant workspace, meeting, or task before asking a question. The agent will automatically load the right context — you won’t need to explain what you’re talking about.

Review approval cards carefully. Before approving any action, check the details in the card. You can edit fields directly in the card before clicking Approve.

Ask follow-up questions freely. Each conversation maintains its history within the thread. Build on previous answers, ask for clarification, or request a different format — the agent remembers what you’ve discussed.

Keyboard shortcuts

ShortcutAction
`Enter`Send message
`Shift+Enter`New line in composer
`Cmd+Shift+C`Toggle Work Mode / Chat Mode

What’s next

Now that you know the basics, explore what your agents can really do:

Related articles

More resources to help you go deeper.