polite.aiDocs
BUILD / The Builder

Reading the team graph

Every team is a picture — agents as boxes, calls flowing in from the left, and three kinds of line that each mean something different.

The canvas in the Builder isn't decoration — it's an accurate map of who answers, who helps, and how calls arrive. Once you can read it, you can see a team's whole design at a glance.

Nodes are agents

Each box is one agent. Badges tell you what kind: the main agent is where inbound calls land first, voice agents speak to callers, and text agents work silently — they can't take phone calls, but they make excellent quiet helpers. Tap any node to open that agent's editor drawer right over the canvas.

Three kinds of line

  • Solid teal — transfers. The caller moves from one voice agent to another, mid-call.
  • Dashed amber — subagents. An agent quietly asks a colleague to do some work and gets the result back; the caller stays put and hears nothing.
  • Dashed muted — inbound lines. The rail on the left shows every way real calls reach the team: each connected phone number and SIP registration gets its own entry, pointing at the agent that answers.

Browser test sessions are throwaway, so they're never drawn as inbound lines — see How calls reach your agent for the full picture.

The graph follows the conversation

In AI edit, the canvas tracks what the Builder is doing. When a change lands, the new or changed node gets a halo and the camera flies to it, so you never hunt for what just happened. While the assistant is mid-edit the whole canvas softens under an assistant is editing — provisional chip — what you see may still move until the change lands.

Getting around

Drag to pan, scroll to zoom — the hint in the corner says exactly that. In AI edit the canvas adds , fit and + buttons; fit is the quick way home when you've wandered. Switch to Plain view for the full-width version with a legend explaining every node and edge kind.

The connected to draft tag

While you're editing, the team has a draft, and endpoints behave two ways:

  • Numbers and registrations that were already connected keep answering the live version — your edits can't reach real callers.
  • An endpoint you deliberately connect while drafting carries a NEW tag on the canvas — connected to draft: it answers the draft right away, and stays connected when you go live.

That tag is your warning that a real number is pointed at unfinished work — usually exactly what you want while testing a new team, and worth checking before you walk away. The full story is in Drafts, versions & going live.

Good to know

The graph is the truth, not an illustration. If a transfer you asked for isn't drawn, it isn't wired — say so in the chat and watch the line appear.

Last updated 2026-07-30