How to Add a New Agent — User Manual
Overview
The Agent Management page lets you register AI agents that can be used in the Chat window. Each agent is backed by a data source and a flow configuration.
How to Navigate to Agent Management
- Log in to the application.
- Open Header settings menu.
- Locate **Namespace Management" and click it.
- In the left-hand sidebar, locate the Editors section.
- Click Manage Agents in the sidebar menu.
The page URL is:
/namespace-management/agent-management
The page displays a two-panel layout:
- Left panel — list of all existing agents with a search box and an Add (+) button.
- Right panel — details of the currently selected agent.
How to Add a New Agent
- On the Agent Management page, click the + (Add) button in the top-right corner of the agent list panel.
- The "Add agent" dialog opens.
- Fill in all required fields (marked below) and click Save.
Dialog Fields
The dialog is divided into three sections.
Section 1 — Data Source
This section is only shown when creating a new agent. It is hidden when editing an existing one.
| Field | Required | Description |
|---|---|---|
| Name | Yes | The internal name of the data source that will be created for this agent. |
| Path | Yes | The URL path segment used to identify the data source. Maximum 255 characters. Must be unique — if a data source with this path already exists, saving will fail. |
| OpenApi Url | No | The OpenAPI specification URL for the agent's API. |
Section 2 — Agent Configuration
| Field | Required | Description |
|---|---|---|
| Agent name | Yes | The display name of the agent shown to users in the chat and agent list. |
| Agent API key | Yes | The secret API key used to authenticate requests to the agent. Entered as a password (masked input). |
| Flow Id | Yes | The identifier of the flow that this agent is connected to. |
| Description | No | A short description of the agent's purpose. Displayed in the agent detail panel. |
Section 3 — Example Questions
All three fields are optional. Populated questions are displayed in the agent detail panel under "Example questions" and surfaced to users in the chat window.
| Field | Required | Description |
|---|---|---|
| Example question 1 | No | A sample question that demonstrates what this agent can answer. Maximum 1000 characters. |
| Example question 2 | No | A second sample question. Maximum 1000 characters. |
| Example question 3 | No | A third sample question. Maximum 1000 characters. |
Saving
Click Save to submit the form. If any required field is empty, the form will highlight validation errors without submitting.
- On success — the dialog closes and the new agent appears in the list.
- On conflict (duplicate path) — an inline error banner is shown: "A data source with this path already exists. Please use a different path."
- On general failure — an inline error banner is shown: "Failed to save agent. Please try again."
Click Cancel at any time to close the dialog without saving.