Building Agents from Admin UI
The Eloquent App includes a visual agent builder that allows administrators to create and configure AI agents without writing code.
Agent List
Navigate to Admin > Agents > Manage to see all agents in the current organization. Each agent card shows:
- Avatar (custom image or preset)
- Title and name
- Type badge: Chat (conversational) or React (tool-using reasoning agent)
- Status: Draft, Active, Inactive, or Archived
- Version number
- Visibility scope
Creating an Agent
Click "Create Agent" to open the agent editor. The editor has two main tabs.
Agent Settings Tab
Goal
The most important field. Describe what the agent should achieve in plain language:
"You are a customer support agent for our e-commerce platform. Help users with order tracking, returns, and product questions."
The platform uses this goal to auto-generate an appropriate system prompt when you save.
Skills
Skills are pre-built capabilities that can be assigned to agents. They are organized by category:
| Category | Examples |
|---|---|
| Productivity | Task management, scheduling, reminders |
| Content Creation | Document writing, summarization |
| Creative | Image generation, brainstorming |
| Integration | Email, calendar, external APIs |
| Analysis | Data analysis, reporting |
| Communication | Chat routing, notifications |
| Custom | Organization-specific skills |
For each skill you can:
- Enable/disable with a toggle
- Reorder via drag-and-drop (affects priority)
- Configure tool-specific settings (click the gear icon)
- Search/filter to find skills quickly
Advanced Settings
Expand the "Advanced Settings" section for fine-grained control:
System Prompt
- Choose a template: General Assistant, Expert Advisor, Task-Focused Agent, or Conversational
- Edit the full system prompt in the markdown editor
- Click "Regenerate" to rebuild the prompt from your goal and current skill/tool configuration
Model Configuration
| Setting | Options |
|---|---|
| Provider | Azure OpenAI, OpenAI, Anthropic, Google |
| Model | Depends on provider (e.g., GPT-4o, Claude Sonnet, Gemini Pro) |
| Temperature | 0 (focused/deterministic) to 2 (creative/varied) |
| Max Tokens | Maximum response length |
Features
- CSAT Survey — automatically prompt users for satisfaction rating after chat ends
- Handoff to Human — allow the agent to transfer conversations to a human operator (with customizable handoff message)
Access Level
| Level | Visibility |
|---|---|
| Public | All members of the organization |
| Private | Only the agent creator |
| Team | Specific teams (enter team IDs) |
| Custom | Specific users (enter email addresses) |
Context Variables Toggle which context is available to the agent at runtime:
- Today's date
- User email
- User name
- Organization ID
- Chat key
- Custom variables (free-text, press Enter to add)
Test Agent Tab
After saving, switch to the Test tab to chat with your agent in real-time:
- See connection status
- Send test messages
- View active tool calls as they execute
- If you make changes to settings, save before testing (unsaved changes warning appears)
- Click "Restart" to begin a fresh conversation
Agent Avatar
Click the avatar area at the top of the editor to customize:
| Option | Description |
|---|---|
| Presets | 5 built-in avatar options |
| Upload | JPG, PNG, GIF, WEBP, or Rive animation file |
| Generate | AI-generated avatar from a text description |
| Remove | Reset to default |
Status Lifecycle
| Status | Meaning |
|---|---|
| Draft | Agent is being configured, not available to users |
| Active | Agent is live and available based on access level |
| Inactive | Agent is paused, not available to users |
| Archived | Agent is retired, hidden from lists |
Widget Embedding
For agents that should be accessible as an embedded chat widget on external websites, navigate to the Embed page.
Appearance Tab
- Position: bottom-right or bottom-left
- Primary, background, and text colors (hex color picker)
- Border radius (0-32px)
- Bubble size (48-80px)
- Custom bubble icon URL
Behavior Tab
- Welcome message displayed when widget opens
- Suggested prompts (up to 4) shown as quick-action buttons
- Auto-open delay (0-60 seconds, 0 = disabled)
- "Powered by Eloquent" branding toggle
Security Tab
- Domain whitelist — only listed domains can load the widget
- Supports wildcards:
*.example.com - Warning alert if no domains are configured (widget will not load on any site)
Embed Code Tab
- Master enable/disable toggle for the widget
- Copy-paste
<script>tag for your website:
<script
src="https://your-api-domain/widget.js"
data-widget-id="<widget-id>"
data-api-base="https://your-api-domain">
</script>
JavaScript API for programmatic control:
EloquentWidget.open()— open the widgetEloquentWidget.close()— close the widgetEloquentWidget.destroy()— remove the widget from the page