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

# Agent

> A conversation step with prompt, AI model, and tools

An **Agent** node is a conversation step. Use one agent for a simple flow, or several agents with paths between them for specialized stages (greeting, booking, wrap-up).

## Add it

Right-click empty canvas → **Add Node** → **Agent**. Connect it from **Start** or from another node. Draw paths to **Task**, **Supervisor**, **Transfer**, **End**, or another **Agent**.

## General

Select the node and open **General**.

* **Agent Name** — Shown on the canvas. Use a name that matches the job of this step.
* **Prompt / Instructions** — What this agent should do, ask, and avoid. You can insert variables where the picker is available.
* **Welcome Message (Optional)** — First message when this agent starts and the customer is not set to speak first.
* **Available for Global Handoff** — When on, other agents can route here. Fill **When to hand off here** so the model knows when this specialist should take over.

Voice only:

* **Who Speaks First** — **AI agent first** or **Customer first**.
* **Allow Interruptions** — Callers can talk over the welcome message.
* **Direct TTS (Fast)** — Play the welcome with speech synthesis without waiting on the language model.
* **Node Timeout (Seconds)** — Optional time limit for this node. Leave empty for no timeout.

## AI

Open the **AI** tab. Chat workflows choose the language model. Voice workflows also set speech recognition and speech synthesis (the same voice settings you use elsewhere in the product).

Task nodes do not have an **AI** tab. Model settings live on **Agent** and **Supervisor**.

## Tools

Open the **Tools** tab and enable what this agent may call. See [Tools](/docs/build/workflows/tools).

<Note>
  A connected integration does not run until you enable the matching tool on this node and finish any configure modal (account, sheet, destination, and so on).
</Note>

## Chat vs Voice

Chat workflows use an optional welcome message and the full tool catalog.

Voice workflows add **Who Speaks First**, welcome interruptions, **Direct TTS (Fast)**, and **Node Timeout**. [Search media](/docs/build/workflows/tools/search-media) is hidden on Voice.

## Verify

<Check>
  The agent has a name and prompt, connects to start or an upstream node, and any tools you need are on. Publish the workflow before live channels use it.
</Check>