AI Assistant

The AI assistant is a chat-based interface that can manage your CMS through natural conversation. It can create projects, build collections with fields, manage content entries, and navigate the application on your behalf.

Opening the Chat Panel

Click the AI icon in the left sidebar to open the chat panel. The panel slides in from the right side and stays open while you work. You can close it by clicking the X button or clicking the sidebar icon again.

What the Assistant Can Do

Project Management

• Create new projects with custom locales
• Search and list existing projects
• Navigate to any project

Example prompts:

• "Create a new project called My Blog with English and Turkish locales"
• "Show me all my projects"
• "Go to the Blog project"

Collection Management

• Create collections with fields, validations, and field groups
• Add, update, or delete individual fields
• Navigate to collection settings

Example prompts:

• "Create a Posts collection with title, slug, content, excerpt, author, and cover image fields"
• "Add a tags relation field to the Posts collection"
• "Delete the subtitle field from Posts"

Content Management

• Create new content entries with field values
• Update existing entries
• Search for entries across collections
• Navigate to specific entries

Example prompts:

• "Create a new blog post titled 'Getting Started with AI'"
• "Show me all published posts"
• "Open the Getting Started post"

Navigation

The assistant can navigate you to any page in the CMS:

• Project dashboards
• Collection settings
• Content entry editors
• App settings pages

Example prompts:

• "Go to collection settings for Posts"
• "Open the localization settings"
• "Navigate to the asset library"

How It Works

The assistant uses tool calling to interact with your CMS. When you ask it to do something, it:

1. Analyzes your request
2. Calls the appropriate tools (e.g., create project, add field)
3. Shows you what it's doing with step indicators
4. Reports the result

You can see each tool call as it happens. A check mark indicates success, and an X indicates a failure with an error message.

Conversations

Each conversation is stored as a separate session. You can:

• Start a new conversation by clicking the "New Chat" button
• View previous conversations in the conversation list
• Delete a conversation by hovering over it and clicking the trash icon

The assistant remembers context within a conversation. For example, after creating a project, you can say "now add a Posts collection" without specifying the project again.

Context Awareness

The assistant is aware of your current location in the CMS. If you're viewing a specific project, the assistant knows which project you're in and can perform actions within that context.

Restrictions

For safety, the AI assistant cannot:

• Delete projects or collections
• Manage users, roles, or permissions
• Modify API access settings or webhooks
• Handle export/import operations
• Upload images or manage assets
• Change email addresses or passwords

If you ask the assistant to do something it can't, it will explain the limitation and suggest doing it manually.

Tips for Best Results

• Be specific: "Create a Posts collection with title (text, required), slug (slug, linked to title), and content (rich text)" works better than "create a blog"
• One thing at a time: While the assistant can handle complex requests, breaking them into smaller steps gives more predictable results
• Check the result: After the assistant makes changes, review the result to make sure everything looks right
• Use it for repetitive tasks: The assistant is especially useful for setting up multiple collections with similar field structures