Assistant Configuration Guide

🤖 AionUi Assistant Configuration Guide

This guide details how to create and configure custom assistants in AionUi, including Rules and Skills setup.

English | 简体中文

🎯 What is an Assistant?

An Assistant is an intelligent agent focused on doing specific tasks. Think of it as your dedicated AI employee, where each assistant has its own area of expertise.

Simple Understanding

• Default Assistant: AionUi's built-in Gemini CLI that can handle various general tasks
• Custom Assistants: You can create assistants specialized for specific tasks, such as:
  • 📁 File Management Assistant: Specialized in organizing files and batch renaming
  • 📊 Excel Processing Assistant: Specialized in processing spreadsheet data and generating reports
  • 💻 Code Review Assistant: Specialized in checking code quality and optimizing performance

Assistant Features

• Runs Locally: All assistants run on your computer, data is never uploaded
• Customizable Rules: Tell assistants "how to work" by writing Rules
• Extensible Capabilities: Add new features to assistants by adding Skills
• Choose AI Model: Select Gemini, Claude, or Codex as the underlying AI

---

🚀 Creating a New Assistant

Step 1: Access Assistant Management

1. Open AionUi application
2. Click the "Settings" icon (⚙️) in the left sidebar
3. Find the "Assistants" section in the settings page
4. Click the "Create" button

Step 2: Configure Basic Information

In the assistant editing interface, configure the following basic information:

• Name & Avatar (Required):

  • Enter the assistant's name
  • Select or enter an emoji as the avatar

• Description (Optional):

  • Briefly describe the purpose and functionality of this assistant

• Main Agent:

  • Select the primary AI model for the assistant
  • Options: Gemini, Claude, Codex

---

📝 Configuring Rules

Rules are the core configuration of an assistant, used to define AI behavior guidelines and working methods. Rules are written in Markdown format.

Purpose of Rules

• Define Workflows: Tell AI how to execute tasks
• Set Constraints: Limit AI's behavior scope
• Provide Context: Let AI understand domain-specific knowledge
• Standardize Output Format: Unify AI's response style

How to Write Rules

1. Enter Rules Editing Area

   • Find the "Rules" section in the assistant editing interface
   • Click the "Edit" tab to switch to edit mode

2. Write Markdown Rules

   • Use Markdown syntax to write rule content
   • Supports headings, lists, code blocks, etc.

3. Preview Effect

   • Click the "Preview" tab to view the rendered effect

Rules Writing Example

# File Management Assistant Rules

## File Path Rules

**Critical**: When users mention files, follow these rules:

1. **Default to workspace**: All files mentioned by users are assumed to be in the current workspace directory
2. **Use Glob to find**: If an exact filename is given but path is unclear, use Glob tool to search in workspace
3. **Don't ask for path**: Never ask "where is the file?" - proactively search for it

## Core Execution Principles

- Break complex tasks into executable steps
- Execute independently, make wise decisions
- Report progress clearly to users

## Constraints

- Don't create files unless task requires
- Prioritize editing existing files over creating new ones
- Keep solutions simple and focused

Rules Best Practices

• ✅ Clear and Explicit: Use concise language to describe rules
• ✅ Structured: Use headings and lists to organize content
• ✅ Specific: Provide concrete examples and scenarios
• ✅ Executable: Ensure rules can be understood and executed by AI

---

🛠️ Configuring Skills

Skills are modules that extend assistant functionality, adding specific capabilities and tools to assistants.

Types of Skills

AionUi supports two types of Skills:

1. Builtin Skills

   • Skill modules built into AionUi
   • Includes: PDF processing, Excel processing, PPT generation, etc.
   • Can be enabled directly by checking

2. Custom Skills

   • Skill modules developed by users
   • Imported by scanning folder paths
   • Supports local and remote skill libraries

Adding Builtin Skills

1. Expand Skills Section

   • Find the "Skills" section in the assistant editing interface
   • Expand the "Builtin Skills" collapse panel

2. Select Skills

   • Check the skills you want to enable
   • Multiple skills can be enabled simultaneously

3. View Skill Descriptions

   • Each skill has a brief description explaining its functionality

Adding Custom Skills

Method 1: Quick Scan Common Paths

1. Click "Add Skills" Button

   • Click the "Add Skills" button in the Skills section

2. Select Common Paths

   • System automatically detects common skill paths
   • Click path buttons to quickly add

Method 2: Manual Path Input

1. Open Add Dialog

   • Click the "Add Skills" button

2. Enter Skill Path

   • Enter the skill folder path in the input box
   • Supports multiple paths, separated by commas
   • Example: /path/to/skills, /another/path/to/skills

3. Confirm Addition

   • Click the "Confirm" button
   • System will automatically scan and import skills from the path

Skills Management

View Added Skills

• Imported Skills:

  • Shows all skills added via "Add Skills"
  • Includes pending and imported skills

• Builtin Skills:

  • Shows all available builtin skills
  • Can be enabled directly by checking

Enable/Disable Skills

• Check the checkbox before the skill name to enable
• Uncheck to disable
• Can modify skill enable status at any time

Remove Skills

• Remove Custom Skills:

  • Hover over the skill item
  • Click the delete icon (🗑️) on the right
  • Confirm removal operation

• Remove Builtin Skills:

  • Uncheck to disable
  • Builtin skills cannot be completely removed, only disabled

---

💾 Saving and Enabling Assistants

Save Configuration

1. Check Configuration

   • Confirm name, description, Rules, and Skills are correctly configured

2. Save Assistant

   • Click the "Save" or "Create" button at the bottom
   • Assistant configuration will be saved immediately

Enable/Disable Assistants

1. In Assistant List

   • Find the assistant to manage
   • Toggle the switch on the right to enable or disable

2. Use Assistant

   • Enabled assistants appear in the assistant list on the welcome page
   • Can select the assistant when creating new conversations

---

🔧 Editing Existing Assistants

Edit Assistant Configuration

1. Enter Edit Mode

   • Click the assistant item in the assistant list
   • Or click the settings icon (⚙️) on the right

2. Modify Configuration

   • Can modify name, description, Rules, and Skills
   • Builtin assistants' names and avatars cannot be modified

3. Save Changes

   • Click the "Save" button to save changes

Delete Assistant

1. Open Delete Confirmation

   • Click the "Delete" button at the bottom of the assistant editing interface
   • Builtin assistants cannot be deleted

2. Confirm Deletion

   • Confirm deletion in the confirmation dialog
   • Cannot be recovered after deletion

---

📚 Use Cases

Case 1: File Management Assistant

Goal: Create an assistant specifically for file organization and management

Rules Configuration:

# File Management Assistant

## Core Functions
- Batch rename files
- Smart classification and organization
- Find duplicate files
- File format conversion

## Working Principles
- Confirm file location before operations
- Keep file backups
- Use Glob patterns to find files

Skills Configuration:

• ✅ Enable builtin file processing skills
• ✅ Add custom file operation skills

Case 2: Code Review Assistant

Goal: Create an assistant specifically for code review and optimization

Rules Configuration:

# Code Review Assistant

## Review Focus
- Code quality and readability
- Performance optimization suggestions
- Security vulnerability checks
- Best practice compliance

## Output Format
- Use Markdown format
- Provide specific code examples
- Mark priority (High/Medium/Low)

Skills Configuration:

• ✅ Enable code analysis skills
• ✅ Add code formatting skills

---

❓ Common Questions

Q: What's the difference between Rules and Skills?

A:

• Rules: Define AI behavior guidelines and working methods, written in Markdown format, telling AI "how to work"
• Skills: Extend AI functionality modules, providing specific tools and capabilities, telling AI "what can be done"

Q: Can I configure multiple Skills for one assistant?

A: Yes! An assistant can enable multiple Skills simultaneously, including both builtin and custom skills.

Q: What format should custom Skills paths be?

A:

• Supports absolute paths: /Users/username/skills
• Supports relative paths: ./skills or ../skills
• Supports multiple paths: separated by commas, e.g., /path1, /path2

Q: How do I know if a Skill is enabled?

A:

• Enabled skills: Checkbox is checked (✓)
• Disabled skills: Checkbox is empty

Q: Can builtin assistants be modified?

A:

• Builtin assistants' names and avatars cannot be modified
• Can modify description, Rules, and Skills configuration
• Builtin assistants cannot be deleted

Q: What Markdown syntax does Rules support?

A: Supports standard Markdown syntax, including:

• Headings (# ## ###)
• Lists (ordered and unordered)
• Code blocks (```)
• Bold, italic
• Links and images

---

🔗 Related Documentation

• Quick Start: Quick Start Guide
• Multi-Agent Mode: Multi-Agent Mode Setup
• MCP Configuration: MCP Configuration Guide
• FAQ: Frequently Asked Questions

---

Need Help?

• 🐛 Report Issues
• 💬 Community Discussions
• 📖 Complete Documentation

Create your exclusive AI assistant by configuring Rules and Skills!