polite.aiDocs
BUILD / The Builder

Reading the team graph

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

The canvas in the Builder is an accurate map of who answers, who helps, and how calls arrive.

Plain view: the full-width graph with a legend explaining every node and line.

Nodes are agents

Each box is one agent. Badges mark the kind: the main agent is where inbound calls land first, voice agents speak to callers, and text agents work silently as quiet helpers. Tapping a node opens that agent's editor drawer.

Four 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 for help 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, pointing at the agent that answers. Browser test sessions are throwaway and never drawn here.
  • Dotted claret — hand-backs. Where a transfer to a human lets the human key the caller back to an agent, the line is labelled with the key the human presses.

The graph follows the conversation

When a change lands, the new or changed node gets a halo and the camera flies to it. While the assistant is mid-edit the canvas softens under an assistant is editing — provisional chip — what is drawn may still move until the change lands.

Getting around

Drag pans, scroll zooms. In AI edit the canvas adds , fit and + buttons — fit is the quick way home. Plain view shows the full-width version with a legend explaining every node and edge kind.

The connected to draft tag

Endpoints that were already connected keep answering the live version while a draft is edited. An endpoint deliberately connected while drafting carries a NEW tag on the canvas — it answers the draft right away, and stays connected after Go live. That tag is the sign a real number is pointed at unfinished work — usually exactly what is wanted while testing. The full story is in Drafts, versions & going live.

Good to know

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

Last updated 2026-08-17