Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.telli.com/llms.txt

Use this file to discover all available pages before exploring further.

The Agent Builder is your central cockpit for building and refining an agent. Instead of jumping between separate forms, chat, and settings, the builder gives you one place to edit the prompt, manage tools, configure call behavior, review version history, and publish changes.

​
Open the Builder

  1. Log in to your account
  2. Navigate to Agents → select an agent
The agent opens directly in the Agent Builder.

​
Editing with Charlie

Charlie is the AI assistant in the chat panel on the left of the Builder. Tell Charlie what you want to change and it will draft prompt edits for you to review.

​
Give Charlie instructions

You can be specific or general — both work:
  • Specific change: “Shorten the greeting and add a goodbye line at the end”
  • General feedback: “The agent isn’t friendly enough — make it ask more personal questions”

​
File uploads and voice input

The chat accepts file uploads and voice input, so you can hand over a transcript, a script document, or a quick voice note without leaving the conversation.

​
Review and accept changes

When Charlie proposes edits, they appear inline in the prompt:
  • 🟢 Accept the change
  • 🔴 Reject the change
You can accept or reject changes individually or all at once. Charlie creates checkpoints as it works, so you can restore an earlier state at any time.
When to use Charlie vs. manual editing: Start with Charlie when you want help structuring a section, rewording, or applying a general improvement. Switch to direct editing for small, surgical tweaks once you know exactly what you want.

​
Editing the prompt directly

The prompt editor in the center of the Builder lets you read and edit the system prompt directly, with rich-text formatting (bold, italic, lists, headings).
Best Practice: Keep prompts clear, concise, and conversational. See Prompt Best Practices for the full blueprint.

​
Variables

Reference dynamic data inside your prompt with {{variableName}}. Type {{ in the editor and an autocomplete dropdown shows everything available, grouped by category:
  • System variables — read-only values like {{firstName}}, {{lastName}}, and the current date
  • Contact properties — your contact properties, automatically available
Variables render as styled chips in the editor, so prompts stay readable.

​
Tools

Reference tools your agent can call with @toolName. Tools that have multiple configured instances — like @collect_data and @transferCall — take a colon-suffixed identifier that picks the specific instance (e.g. @collect_data:email, @transferCall:sales). The Builder’s tools sidebar inserts the correct reference for you. Tell the agent in the prompt when to use each tool and the conditions for triggering it.

​
Versions and publishing

Edits in the Builder produce a draft. The live agent keeps running the published version until you publish a new one.
  • Diff against live — review what changed before publishing
  • Restore an older version — roll back to a previous revision when something needs to go back
  • Test against a specific version — start a test call against any version to verify a change before rolling it out

​
Reviewing past calls in the Builder

Call History lives inside the Builder so you can refine an agent based on what actually happened on calls. You get the full transcript, an audio player that follows along with the conversation, and consolidated filters to narrow down the calls you want to review. You can pick individual messages from a past call and bring them into the chat with Charlie to refine the agent based on real conversation moments.