Create an AI Agent
By the end of this page you will have a new AI Agent open in the Agent Editor, ready to configure.
Prerequisites
- A project created (Create your first project).
- Owner, Admin, or Developer role.
Steps
Open the Agents tab
In your project sidebar, click Agentic Workspace, then Agents. You land on the Agents tab, which lists all agents in the project. Click Create Agent in the top-right of the Agent Management section.
Choose the AI Agent type
A dialog titled Create a New Agent opens, subtitled “Choose how you’d like to build your agent.” It shows two cards:
| Type | Description |
|---|---|
| AI Agent | Config-driven with LLM planning |
| Task Agent | Graph-based workflow with nodes |
The AI Agent card is marked Recommended for chat & assistants and lists: Natural language configuration, A2A Protocol compatible, Dynamic tool selection.
Click the AI Agent card. The wizard opens directly at its setup step.
Name your agent and choose modes
The AI Agent wizard is a single step — everything else is configured later in the Agent Editor. The heading reads “Name your agent & choose modes.”
Fill in:
- Agent Name (required) — for example,
Aurora Support Assistant. Must be at least 2 characters.
Then pick which modes to enable. Two are offered at creation:
| Mode | Description |
|---|---|
| Conversation | Chat sessions with memory via text messages. |
| Voice Starter | Real-time voice interactions using STT/TTS. |
A counter shows how many modes are enabled. At least one mode must stay on.
Scheduled and API modes aren’t offered here — they become available once the agent is deployed. See Modes.
Create the agent
Click Create Agent. qRaptor creates the agent, saves an initial configuration, and opens it in the Agent Editor at its own URL. The agent starts as v1 • DRAFT.
What happens next
Your agent exists but has no skills yet. The next step is to tour the editor, then give the agent an identity and skills.
Common issues
- “Name must be at least 2 characters” — Enter a longer name before continuing.
- “An agent with this name already exists” — Agent names must be unique within a project. Choose a different name.
- “Agent limit reached. Please upgrade your plan.” — Your plan caps the number of agents. Upgrade, or delete unused agents.
- “You don’t have permission to create agents.” — Ask a project Owner or Admin to grant you a Developer or Admin role.