Managing Assistants
Assistants are the core of Diosc. Each assistant is a configured AI agent with its own personality, tools, and behavior rules.
Assistants List
Navigate to Assistants in the sidebar to see all configured assistants.
Each assistant shows:
- Assistant — Display name and greeting preview
- Domain — The domain this assistant serves
- Model — The configured LLM model
- Role — The default role
- Created / Updated — Timestamps
From the list you can:
- Search for assistants by name
- Add Assistant to create a new one
- Click an assistant to open its Settings
- Use the ... menu to delete an assistant
Creating an Assistant
Click + Add Assistant to set up a new assistant.
| Field | Description | Required |
|---|---|---|
| Assistant Name | Display name (max 30 characters) | Yes |
| Greeting Message | Welcome message when users open the chat | Yes |
| Model | LLM model from the catalog, grouped by tier (Premium / Standard / Budget) | Yes |
The model picker shows all available models grouped by category with a provider badge. If the selected model's provider API key is not configured on the server, a warning is displayed.
A random colored avatar is automatically assigned to new assistants. You can change it later in the assistant's General settings.
After creation, you'll be taken to the assistant's settings page to complete the configuration.
Configuration Tabs
Click an assistant to open its settings. The settings are organized into tabs:
| Tab | Documentation |
|---|---|
| General, Authentication, API Key, Embed | General & Authentication |
| System Prompt | System Prompt |
| Model | Model Configuration |
| Sitemap | Sitemap |
| Roles | Roles |
| Approval | Approval Policies |
| Rate Limits, Plugins, Audit Log | Plugins, Rate Limits & Audit |
Recommended Configuration Order
- Create — Set name, greeting, and select the model
- System Prompt — Define personality and instructions
- Model — Fine-tune temperature and max tokens
- General — Set domain, branding, and user resolution
- Authentication — Configure CORS
- Plugins — Enable needed plugin types
- Sitemap — Define your application's navigation
- Roles — Set up role-based behavior
- Approval — Configure approval workflows for sensitive tools
- Rate Limits — Set usage limits
Deleting an Assistant
To delete an assistant:
- Open the assistants list
- Click the delete action on the assistant
- Confirm the deletion
Deleting an assistant permanently removes all its configuration, roles, sitemap entries, and approval policies.