> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cogniagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversation Flows

> Design multi-agent conversational AI on a visual canvas — actors, routing, channels, and deployment in one place.

Conversation Flows is CogniAgent's visual canvas for building **multi-agent AI conversations**. Instead of one big chatbot trying to do everything, you design a team of focused AI agents that work together — each with its own role, knowledge, and tools — and let the platform decide who speaks when.

<Frame caption="A simple two-agent Sales flow on the canvas.">
  <img src="https://mintcdn.com/glorium/eqWkhSfBUec9afZU/images/conversation-flows/canvas-overview.png?fit=max&auto=format&n=eqWkhSfBUec9afZU&q=85&s=9f0b09eb9e687847b6e4742d3168d09d" alt="Canvas overview" width="1471" height="1225" data-path="images/conversation-flows/canvas-overview.png" />
</Frame>

## When to use Conversation Flows

<CardGroup cols={2}>
  <Card title="Customer support with specialists" icon="headset">
    Triage agent routes billing questions to a billing specialist, product questions to a product expert.
  </Card>

  <Card title="Lead qualification + booking" icon="filter">
    One agent qualifies the lead; another schedules the demo. Each is good at one job.
  </Card>

  <Card title="Returns and refunds" icon="boxes-stacked">
    A returns intake agent collects details, a policy agent checks eligibility, a refund agent issues credits.
  </Card>

  <Card title="Voice-first phone flows" icon="phone">
    Inbound calls land on a receptionist agent, transfer to the right specialist mid-call.
  </Card>
</CardGroup>

## What makes it different

### A team, not a script

Each agent — called an **actor** — has its own system prompt, model, knowledge bases, and integrations. You connect actors with routing edges that say "when X happens, hand off to Y." The platform handles the routing decisions automatically using the conversation context.

### Context that travels with the user

Information collected by one actor flows to the next. The user doesn't repeat themselves. Each actor decides how much of the previous conversation it wants to inherit.

### One canvas, every channel

Connect the same flow to Widget, Email, Slack, Teams, or Phone. The conversation logic stays the same — only the delivery channel changes.

### Start the conversation, or wait for it

A flow can run two ways:

* **Responder mode** — the flow listens on its channels and replies when users write in (support inbox, web widget).
* **Initiator mode** — your team or another workflow kicks off the conversation (outbound sales call, follow-up email).

[Read more about execution modes →](/conversation-flows/concepts/execution-modes)

## How it works

```mermaid theme={null}
flowchart TB
    User[User message] --> Start[Start node<br/>channels: Widget, Email, ...]
    Start --> Triage[Triage Actor<br/>greets, identifies need]
    Triage -->|Billing question| Billing[Billing Actor<br/>invoices, refunds]
    Triage -->|Product question| Product[Product Actor<br/>features, pricing]
    Triage -->|Anything else| Human[Hand off to human]
    Billing --> Reply[Reply on same channel]
    Product --> Reply
    Human --> Reply
```

Every flow has three parts:

<Steps>
  <Step title="A Start node">
    The entry point. Owns the channel configuration — Widget, Gmail, Slack, Phone, and so on. Every flow has exactly one.
  </Step>

  <Step title="One or more actors">
    The AI agents. Each has a name, an icon, a model, a system prompt, and a set of capabilities (knowledge bases, integrations, custom tools).
  </Step>

  <Step title="Routing edges between actors">
    You write a short description of *when* this route should fire (the **activation prompt**). The platform auto-generates a short label and uses the prompt to decide routing during conversations.
  </Step>
</Steps>

## Core concepts at a glance

<CardGroup cols={2}>
  <Card title="Flows and actors" icon="diagram-project" href="/conversation-flows/concepts/flows-and-actors">
    The building blocks: Start node, actors, edges, and the map canvas.
  </Card>

  <Card title="Context and inheritance" icon="share-from-square" href="/conversation-flows/concepts/context-and-inheritance">
    How information flows between actors so the user never repeats themselves.
  </Card>

  <Card title="Focus modes" icon="crosshairs" href="/conversation-flows/concepts/focus-modes">
    How strictly each actor sticks to its job when users switch topics.
  </Card>

  <Card title="Execution modes" icon="play" href="/conversation-flows/concepts/execution-modes">
    Initiator vs Responder — does your flow start conversations, or wait for them?
  </Card>
</CardGroup>

## Get started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/conversation-flows/quickstart">
    Build your first two-actor flow in 10 minutes.
  </Card>

  <Card title="Sales triage walkthrough" icon="map" href="/conversation-flows/guides/sales-triage-walkthrough">
    A worked example: lead intake → product specialist or pricing specialist.
  </Card>

  <Card title="Connect a channel" icon="share-nodes" href="/conversation-flows/channels/overview">
    Wire your flow to Widget, Email, Slack, Teams, or Phone.
  </Card>

  <Card title="Deploy your flow" icon="rocket-launch" href="/conversation-flows/operate/deploy">
    Take it live so real users can talk to it.
  </Card>
</CardGroup>
