For the complete documentation index, see llms.txt. This page is also available as Markdown.

Agents

Automate tasks and build conversational assistants with AI Agents

Everything in your Workspace centers around agents. Powered by agentic workflows, these agents combine LLM reasoning with tools and data to complete tasks. They go beyond basic chatbots to deliver sophisticated, logic-driven automation.

What Is an Agent

An Agent is the intelligent core of your Workspace, designed to automate complex tasks and interact with users using your specific data and logic. An agent is your versatile AI worker: manage in Workspace, build and deploy in Designer, and monitor the performance in Observatory.

Every agent is built on three essential pillars:

Workflows

Sequences of nodes that dictate the agent's behavior and decision-making

Knowledge

Data sources and documents that give the agent context for accurate, grounded answers

Plugins

External capabilities and integrations that let the agent execute complex tasks

A single Workspace can house multiple agents, allowing you to manage an entire suite of AI tools in one centralized hub. While each agent is tied to its specific Workspace, you are not limited to a single version; you can create multiple deployments for any agent to test different configurations or prompt variations simultaneously.

Creating an Agent

Every agent starts from a Blueprint: a ready-made starting point that bundles workflows and the plugins a common use case needs.

1

Pick a Blueprint

In Workspace > Agents, select Create New Agent. Browse the Blueprint cards and select the one closest to what you want to build.

Every agent you create is a Modern Agent, built on the current agent architecture.

2

Connect Its Plugins

Each plugin in the Blueprint needs an AI model integration to run. Pick one from the dropdown or select + Add new Integration to create one inline. You can change these later.

3

Add the Agent Details

Name the agent and set its language, then select Create. Your agent appears in Workspace > Agents.

Name

Use a descriptive, unique name so you can tell agents apart in the table. A structured naming approach also enables a simplified version control workflow.

Primary language

The agent's default language. The agent uses it to reply to new users and as the fallback when no other language applies. Your content is authored in this language; other languages are added as translations. Add more languages anytime under Designer > Settings.

Description (optional)

Context for other makers in the Workspace to understand the agent's role.

Avatar (optional)

Upload an image, browse your Workspace's Media Manager, or connect an external URL.

4

Start Building

Your agent is ready. Head over to Designer to build, configure, and deploy it. Track how it performs in Observatory.

Accessing an Agent

To view the Agents table, go to Workspace > Agents. From here, you can:

  • View all existing agents in your Workspace

  • Create new agents

  • Perform actions like edit, clone and replace existing agents

To access a specific agent, your options depend on your current view:

Navigate to Workspace > Agents and click on your agent.

Click the agent selection card on the top of the Designer to search for and switch between agents.

Previewing an Agent

The Live Demo button lets you chat with your agent without deploying it. Use it to validate workflow edits, prompt changes, or new Knowledge Base content before pushing them to a live channel. The chat itself behaves like a Webchat deployment, with additional controls for testing.

The button is docked to the right edge of Designer and is available from any tab. A status indicator below the play icon shows whether the agent's training is current. Click it to update the agent knowledge.

Trained

A check below the play button means the agent reflects your latest changes. The preview runs against the current Knowledge Base.

Needs Retraining

A yellow indicator means the Knowledge Base have been made since the agent was last trained. Retrain before previewing if you want the demo to reflect your most recent edits.

The preview goes beyond a chat surface. You can target a specific workflow for the run, tune context like language or metadata, and view the finished session in Observatory:

View in Observatory

Opens Observatory > Sessions > Chat Sessions pre-filtered to this agent so you can inspect the last session

Reload

Restarts the conversation from the selected workflow

Settings

Opens the Preview Settings panel to tune how the run behaves and what context it carries

Share

Copies a shareable link to a Webchat deployment so you can hand off a preview to a teammate

Open in New Tab

Opens the same preview link in a standalone browser tab

Cloning and Replacing Agents

The Agents table includes two actions that let you duplicate agents and transfer content between them. Both are available from the Actions column on each agent row. For a detailed walkthrough on how to use them see Version Control.

Clone Agent

Create an identical copy of an agent, including workflows, variables, and configurations. Clone within the same Workspace or into a different one.

Replace Agent Content

Overwrite one agent's content with another's. Use this to promote changes between environments (e.g., Dev to Staging).

Version Control

Combine Clone and Replace to set up a Dev → Staging → Production workflow that keeps your live agent safe while you iterate.

Deleting an Agent

  1. Go to Designer > Settings

  2. Click Delete this agent under the Danger Zone

  3. Type 'DELETE' (uppercase) in the textbox to confirm deletion

Backups

Backups let you save and restore a complete snapshot of your agent's configuration, including workflows, variables, and settings. Back ups are not created automatically, so you need to create them manually before making significant changes.

Go to Designer > Backups to manage backups for the current agent. Each backup is associated with the timestamp of when it was created, a unique identifier and an optional note.

Manage Backups

Managing backups is straightforward: create new ones, restore to a previous snapshot, or delete backups you no longer need.

Click Create Backup Now. A dialog prompts you to add an optional note, use it to describe what the backup captures (e.g., Before prompt rewrite or Stable v2). Click Create Backup to confirm.

Click the icon in the Actions column. A confirmation prompt appears. Click Yes to proceed.

Click the delete icon in the Actions column and confirm with Yes.

Agent Settings

Open Designer > Settings to manage an agent's core configuration: its identity, language, and how it behaves in a conversation. Privacy controls sit separately under Designer > Privacy & Security.

Setting
Description

Name, Description, Avatar

The agent's identity, set when you create the agent and editable here at any time

Timezone

The time zone the agent operates in

Session Expiration (sec)

How long, in seconds, an inactive conversation stays open before the next message starts a new session

Enable Thumb Rating

Lets end users rate the agent's responses with a thumbs up or down

Language

The agent's primary language, plus any additional languages

Enable Agent

Turns the agent on or off, controlling whether it is currently available

Delete this agent

Permanently removes the agent and all of its settings and backups. See Deleting an Agent for the full steps

Best Practices

  • Name agents for the table: Use descriptive, unique names and a consistent naming approach, which keeps agents easy to tell apart and supports a clean version control workflow

  • Back up before significant changes: Backups are not created automatically, so snapshot the agent before editing prompts, restructuring workflows, or updating variables

  • Preview before you deploy: Validate prompt and workflow changes in a Live Demo

  • Promote changes with Clone and Replace: Keep a Dev → Staging → Production workflow so your live agent stays safe while you iterate

  • Export before deleting: Deletion is permanent and removes workflows, chat sessions, surveys, and backups, so export or clone anything you might need first

Last updated