@nocobase/plugin-ai 2.1.0-beta.29 → 2.1.0-beta.32

package/client-v2.d.ts

@@ -0,0 +1 @@
+export * from './dist/client-v2';

package/client-v2.js

@@ -0,0 +1 @@
+module.exports = require('./dist/client-v2/index.js');

package/dist/ai/docs/nocobase/ai/index.md

@@ -51,7 +51,7 @@ features:
         link: /ai-employees
       - title: Ready-to-Use AI Team
         details: Pre-built AI employee teams in NocoBase, covering data modeling, front-end development, data processing, and more — no configuration needed, ready to use.
-        link: /ai-employees/features/built-in-employee
+        link: /ai-employees/built-in/
       - title: Let AI Understand Your Business
         details: Import business documents and data through the AI knowledge base, making AI employees' responses and actions more aligned with your actual scenarios.
         link: /ai-employees/knowledge-base

package/dist/ai/docs/nocobase/ai-employees/built-in/atlas.md

@@ -0,0 +1,24 @@
+---
+title: 'Atlas: Team Leader'
+description: 'Atlas is the built-in AI Employee team leader in NocoBase, used to understand user intent and coordinate other AI Employees.'
+keywords: 'Atlas,Team Leader,AI Employee,NocoBase'
+---
+
+# Atlas: Team Leader
+
+## Role
+
+Atlas is the default general entry AI Employee. It understands user needs and coordinates suitable AI Employees according to the task type.
+
+## Scenarios
+
+- Describe your needs to Atlas when you are not sure which AI Employee to use.
+- Split a task across multiple AI Employees.
+- Use one entry point for analysis, organization, translation, and other tasks.
+
+## Entry Points
+
+- AI floating button in the lower-right corner
+- AI Employee chat panel
+
+![Atlas](https://static-docs.nocobase.com/20260331172734.png)

package/dist/ai/docs/nocobase/ai-employees/built-in/dara.md

@@ -0,0 +1,22 @@
+---
+title: 'Dara: Data Visualization Expert'
+description: 'Dara is the built-in data visualization expert in NocoBase, used to generate charts and visualization configurations from data.'
+keywords: 'Dara,data visualization,charts,AI Employee,NocoBase'
+---
+
+# Dara: Data Visualization Expert
+
+## Role
+
+Dara focuses on chart and visualization configuration scenarios. It can write complex SQL based on user questions and generate chart configurations suitable for display.
+
+## Scenarios
+
+- Generate charts from business questions.
+- Add visual components to dashboards.
+- Adjust chart types, dimensions, metrics, and interactions.
+
+## Entry Points
+
+- Chart configuration pages
+- AI Employee chat panel

package/dist/ai/docs/nocobase/ai-employees/built-in/dex.md

@@ -0,0 +1,32 @@
+---
+title: 'Dex: Data Organizer'
+description: 'Dex is the built-in data organization expert in NocoBase, used to extract information from unstructured text and help fill forms.'
+keywords: 'Dex,data organization,information extraction,form filling,AI Employee,NocoBase'
+---
+
+# Dex: Data Organizer
+
+## Role
+
+Dex is good at extracting key information from emails, chat records, document snippets, and other unstructured content, then organizing it into structured results.
+
+## Scenarios
+
+- Extract contacts, dates, tasks, requirements, and other information from text.
+- Organize messy content into tables or lists.
+- Fill forms based on extracted results.
+
+## Entry Points
+
+- AI Employee chat panel
+- Form pages after selecting block context
+
+![20251022155316](https://static-docs.nocobase.com/20251022155316.png)
+
+![20251022155414](https://static-docs.nocobase.com/20251022155414.png)
+
+![20251022155523](https://static-docs.nocobase.com/20251022155523.png)
+
+![20251022155555](https://static-docs.nocobase.com/20251022155555.png)
+
+![20251022155733](https://static-docs.nocobase.com/20251022155733.png)

package/dist/ai/docs/nocobase/ai-employees/built-in/ellis.md

@@ -0,0 +1,22 @@
+---
+title: 'Ellis: Email Expert'
+description: 'Ellis is the built-in email expert in NocoBase, used to understand email context, summarize messages, and draft replies.'
+keywords: 'Ellis,email,email summary,email reply,AI Employee,NocoBase'
+---
+
+# Ellis: Email Expert
+
+## Role
+
+Ellis focuses on email processing. It can combine email history, customer information, and current email content to help users understand context and draft replies.
+
+## Scenarios
+
+- Summarize email threads.
+- Identify email intent, risks, and follow-up tasks.
+- Generate professional and clear reply drafts.
+
+## Entry Points
+
+- AI Employee chat panel
+- Email-related pages or task entries

package/dist/ai/docs/nocobase/ai-employees/built-in/index.md

@@ -0,0 +1,25 @@
+---
+title: 'Built-in AI Employees'
+description: 'Overview of NocoBase built-in AI Employees: learn their roles, scenarios, and entry points.'
+keywords: 'Built-in AI Employees,Atlas,Viz,Dara,Dex,Ellis,Lexi,Vera,Lina,Nathan,NocoBase'
+---
+
+# Built-in AI Employees
+
+NocoBase provides a set of built-in AI Employees for different scenarios. They can help with data analysis, data organization, email processing, translation, localization, frontend development, and more.
+
+![](https://static-docs.nocobase.com/202605121048555.png)
+
+## Employee List
+
+| Employee | Role | Typical Scenario | Type |
+| --- | --- | --- | --- |
+| [Atlas](./atlas.md) | Team Leader | Understand user intent and coordinate suitable AI Employees | Main Agent |
+| [Viz](./viz.md) | Insights Analyst | Query business data and generate insights or reports | Business Employee |
+| [Dex](./dex.md) | Data Organizer | Extract structured information from text and help fill forms | Business Employee |
+| [Ellis](./ellis.md) | Email Expert | Summarize email context and draft replies | Business Employee |
+| [Lexi](./lexi.md) | Translation Assistant | Conversational multilingual translation | Business Employee |
+| [Vera](./vera.md) | Research Analyst | Web search, information verification, and research summaries | Business Employee |
+| [Nathan](./nathan.md) | Frontend Engineer | Help write or modify frontend code in code editors | Developer Employee |
+| [Lina](./lina.md) | Localization Engineer | Translate system localization entries and plugin UI text | Developer Employee |
+| [Dara](./dara.md) | Data Visualization Expert | Generate charts and visualization configurations from data | Developer Employee |

package/dist/ai/docs/nocobase/ai-employees/built-in/lexi.md

@@ -0,0 +1,26 @@
+---
+title: 'Lexi: Translation Assistant'
+description: 'Lexi is the built-in translation assistant in NocoBase, used for conversational multilingual translation and communication assistance.'
+keywords: 'Lexi,translation assistant,multilingual,AI Employee,NocoBase'
+---
+
+# Lexi: Translation Assistant
+
+## Role
+
+Lexi focuses on daily communication and business text translation, helping users convert content between languages.
+
+## Scenarios
+
+- Translate text entered by users.
+- Translate foreign language content into the current user language.
+- Translate current language content into a specified target language.
+
+## Entry Points
+
+- AI Employee chat panel
+- Business pages where content needs translation
+
+## Difference from Lina
+
+Lexi is mainly for user conversations and business communication translation; Lina is mainly for system localization entries and UI text translation.

package/dist/ai/docs/nocobase/ai-employees/built-in/lina.md

@@ -0,0 +1,142 @@
+---
+title: 'Lina: Localization Engineer'
+description: 'Lina is the built-in AI Employee of the Localization plugin, used to translate NocoBase system localization entries and plugin UI text.'
+keywords: 'Lina,Localization Engineer,AI translation,Localization Management,AI Employee,NocoBase'
+---
+
+# Lina: Localization Engineer
+
+## Role
+
+Lina is the built-in AI Employee registered by the Localization plugin. It focuses on system localization translation, translating localization entries into the target language while preserving variables, placeholders, tags, formatting, and concise UI wording.
+
+![](https://static-docs.nocobase.com/202605121152196.png)
+
+:::info{title=Tip}
+Lina is a dedicated AI Employee for localization scenarios and does not use general Skills or Tools.
+:::
+
+## Scenarios
+
+- Batch translate system and plugin entries.
+- Translate localization content for collections, fields, and menus.
+- Quickly generate an initial translation for a newly enabled language.
+- Incrementally translate entries that already exist but are not translated yet.
+- Translate only selected entries in the table.
+
+## Prerequisites
+
+Before using Lina, complete the following setup:
+
+- Enable the **Localization Management** plugin.
+- Configure an available LLM service and assign a default model to Lina. See [Configure AI Employee Models](/ai-employees/features/model-settings) and [Model Recommendations](#model-recommendations).
+- Enable the target language in system settings.
+- Synchronize the entries to translate on the Localization Management page.
+
+:::info{title=Tip}
+Lina creates translation tasks for the current locale. For example, if the current UI locale is Thai, the task generates Thai translations.
+:::
+
+## Usage
+
+On the Localization Management page, click Lina's avatar and choose one of the AI translation task scopes.
+
+### Incremental Translation
+
+Only translate entries that do not have a translation for the current language. This is suitable for daily maintenance after adding plugins, fields, or menus.
+
+### Selected Translation
+
+Select records in the entries table first, then choose selected translation. This is suitable for retranslating a small set of entries or entries that need manual correction.
+
+If no entry is selected, the system prompts you to select records first.
+
+### Full Translation
+
+Translate all eligible entries in the current language. This is suitable when generating the first version of a newly enabled language.
+
+:::warning{title=Note}
+Full translation may overwrite existing translations. Confirm the target language, entry count, and model service before starting.
+:::
+
+## Task Confirmation
+
+Before creating the task, the system displays a confirmation dialog with:
+
+- Number of entries to translate.
+- Provider to use.
+- Model to use.
+
+After confirmation, the system creates a background task. You can view progress in async tasks. When the task completes, translations are written to the corresponding language.
+
+![](https://static-docs.nocobase.com/202605121233608.png)
+
+## Translation Strategy
+
+Lina follows these rules when translating localization entries:
+
+- Return only the translated text without explanation, summary, Markdown, or extra content.
+- Preserve variables, placeholders, HTML tags, ICU syntax, code-like tokens, and formatting symbols.
+- Preserve meaningful line breaks.
+- Keep UI text concise and natural for buttons, fields, menus, and prompts.
+- Return text unchanged if it should not be translated.
+
+## Reference Translations
+
+Some entries are short, such as field names, button labels, and statuses. Lina uses existing reference translations when possible to improve consistency.
+
+- Built-in entries prefer Chinese translations as references.
+- Non-built-in entries prefer the system default language as references.
+- If the system default language is English, the English entry is used directly as the source.
+
+When a reference is available, Lina uses a prompt with semantics similar to:
+
+```text
+Refer to the following translation:
+{source_term} is translated as {target_term}
+
+Translate the following text into {target_language}. Output only the translated result without any additional explanation:
+
+{source_text}
+```
+
+## Model Recommendations
+
+Localization translation usually processes many entries in one task. If possible, use a locally deployed translation-specific small model first, because online models often have API rate limits, concurrency limits, or token-per-minute limits. When many entries are translated, rate limiting can make tasks much slower or cause some requests to wait or fail.
+
+If local deployment is not possible, use a translation-specific model rather than a general chat model. Translation models are usually better for short entries, UI text, and batch translation. If the model service supports dedicated translation parameters, the system passes source text, source language, target language, and terminology information according to the model rules.
+
+You can adjust request concurrency according to model capability to better control throughput, response time, and cost.
+
+For a complete practice using a locally deployed translation-specific small model, see [Use Lina and local HY-MT1.5-1.8B to translate localization entries](/ai-employees/scenarios/localization-hy-mt).
+
+:::info{title=Tip}
+The concurrency of localization translation tasks is controlled by `AI_LOCALIZATION_CONCURRENCY`. The default is `10`, the allowed range is `1` to `20`, and values outside the range use the default.
+:::
+
+## Progress and Failure Handling
+
+Lina translation tasks run as background async tasks. The task writes translation results entry by entry and updates progress.
+
+![](https://static-docs.nocobase.com/202605121235761.png)
+
+If an entry fails to translate, the task records the failure and stops to avoid continuing to write uncontrolled results when model calls, model output, or configuration is abnormal. Common causes include:
+
+- AI plugin or Async Task Manager plugin is not enabled.
+- Lina does not have an available model configured.
+- Model service is unavailable or times out.
+- Model service does not support the current request format.
+- Model returns empty content.
+
+Check async task details and server logs for provider, model, target language, failed entry ID, and model call duration.
+
+## Review Before Publishing
+
+After AI translation finishes, review before publishing:
+
+- Check whether short entries such as menus, buttons, and field names fit the product context.
+- Check whether variables, placeholders, and HTML tags are preserved.
+- Check business terminology consistency.
+- Check important pages and user-facing text for natural wording.
+- If built-in entry translations are overwritten, return to Localization Management and select `Reset system built-in entry translations` during synchronization to restore defaults. To contribute default translations for the system and official plugins, see [Translation Contribution](/get-started/translations).
+- Publish translations after review.

package/dist/ai/docs/nocobase/ai-employees/built-in/nathan.md

@@ -0,0 +1,36 @@
+---
+title: 'Nathan: Frontend Engineer'
+description: 'Nathan is the built-in frontend engineer in NocoBase, used to help write and modify frontend code in JS editors and related scenarios.'
+keywords: 'Nathan,frontend engineer,JS editor,code generation,AI Employee,NocoBase'
+---
+
+# Nathan: Frontend Engineer
+
+## Role
+
+Nathan focuses on frontend coding and debugging scenarios. It can generate, modify, or explain JavaScript code based on the current code context.
+
+## Scenarios
+
+- Write code for JSBlock, JSField, JSItem, JSColumn, JSAction, and similar editors.
+- Adjust page interaction logic or styles.
+- Provide modification suggestions based on current editor content.
+
+## Entry Points
+
+- Nathan entry in the upper-right corner of JS code editors
+- Other configuration scenarios that require JavaScript
+
+![20251022163405](https://static-docs.nocobase.com/20251022163405.png)
+
+![20251022163935](https://static-docs.nocobase.com/20251022163935.png)
+
+![20251022164041](https://static-docs.nocobase.com/20251022164041.png)
+
+![20251022164323](https://static-docs.nocobase.com/20251022164323.png)
+
+![20251022164436](https://static-docs.nocobase.com/20251022164436.png)
+
+![20251022164644](https://static-docs.nocobase.com/20251022164644.png)
+
+![20251022164713](https://static-docs.nocobase.com/20251022164713.png)

package/dist/ai/docs/nocobase/ai-employees/built-in/vera.md

@@ -0,0 +1,22 @@
+---
+title: 'Vera: Research Analyst'
+description: 'Vera is the built-in research analyst in NocoBase, used for web search, information verification, and research summaries.'
+keywords: 'Vera,research analyst,web search,information verification,AI Employee,NocoBase'
+---
+
+# Vera: Research Analyst
+
+## Role
+
+Vera focuses on external information retrieval and research. It can search public internet information and organize conclusions with source references.
+
+## Scenarios
+
+- Query the latest public information.
+- Compare information from multiple sources.
+- Summarize competitors, industries, policies, and market materials.
+
+## Entry Points
+
+- AI Employee chat panel
+- Task scenarios with web search enabled

package/dist/ai/docs/nocobase/ai-employees/built-in/viz.md

@@ -0,0 +1,25 @@
+---
+title: 'Viz: Insights Analyst'
+description: 'Viz is the built-in insights analyst in NocoBase, used to query business data and generate analytical conclusions and business reports.'
+keywords: 'Viz,insights analyst,data analysis,AI Employee,NocoBase'
+---
+
+# Viz: Insights Analyst
+
+## Role
+
+Viz focuses on data insights and business analysis. It can read specified data ranges and generate trend analysis, metric interpretation, and structured reports.
+
+## Scenarios
+
+- Generate business analysis reports.
+- Analyze sales, customers, leads, orders, and other business data.
+- Interpret trends, comparisons, conversions, retention, and other metrics.
+
+## Entry Points
+
+- AI Employee chat panel
+- AI Employee shortcut tasks configured on pages or blocks
+- Scenario entries related to business analysis reports
+
+![clipboard-image-1771913319](https://static-docs.nocobase.com/clipboard-image-1771913319.png)

package/dist/ai/docs/nocobase/ai-employees/features/built-in-employee.md

@@ -18,7 +18,6 @@ You only need to configure the LLM service and enable the corresponding employee
 | **Lexi** | Translation Assistant | Multilingual translation, communication assistance |
 | **Vera** | Research Analyst | Web search, information aggregation, deep research |
 | **Dara** | Data Visualization Expert | Chart configuration, visual report generation |
-| **Orin** | Data Modeling Expert | Assist in designing collection structures, field suggestions |
 | **Nathan** | Frontend Engineer | Assist in writing frontend code snippets, style adjustments |
 
 Click the **AI floating ball** in the bottom-right corner of the application interface to open an AI conversation and start collaborating.
@@ -45,7 +44,7 @@ In most scenarios, you can simply describe what you need. Atlas will either cont
 
 Some built-in AI employees (builder types) do not appear in the bottom-right AI employee list; they have dedicated workspaces, for example:
 
-* Orin only appears on the Data Source configuration page;
+* only appears on the Data Source configuration page;
 * Dara only appears on the chart configuration page;
 * Nathan only appears in the JS editor.
 
@@ -164,33 +163,6 @@ After sending, `Dex` will structure the data and use its skills to update the da
 
 ---
 
-## Orin: Data Modeler
-
-### Introduction
-
-> Intelligently design collections and optimize database structures.
-
-`Orin` is a data modeling expert. On the main data source configuration page, you can let `Orin` help you create or modify collections.
-
-![20251022160628](https://static-docs.nocobase.com/20251022160628.png)
-
-### Usage
-
-Enter the Data Source Manager plugin and select to configure the main data source.
-
-![20251022161146](https://static-docs.nocobase.com/20251022161146.png)
-
-Click the `Orin` avatar in the top right corner to open the AI employee dialog box.
-
-![20251022161641](https://static-docs.nocobase.com/20251022161641.png)
-
-Describe your modeling requirements to `Orin`, send, and wait for a reply. 
-
-Once `Orin` confirms your requirements, he will use his skills and reply with a preview of the data modeling.
-
-After reviewing the preview, click the **Finish review and apply** button to create collections according to `Orin`'s modeling.
-
-![20251022162142](https://static-docs.nocobase.com/20251022162142.png)
 
 ---
 

package/dist/ai/docs/nocobase/ai-employees/features/collaborate.md

@@ -1,31 +1,41 @@
+---
+pkg: '@nocobase/plugin-ai'
+title: 'Collaborate with AI Employees'
+description: 'Collaborate with AI Employees: bottom-right main entry, block Action entry, chat operations, and switching employees and models in a conversation (AI Employee Switcher, Model Switcher).'
+keywords: 'AI Employee collaboration,chat panel,employee switcher,model switcher,NocoBase'
+---
+
 # Collaborate with AI Employees
 
 After creating and enabling AI Employees, you can collaborate with them in pages.
 
 ## Entry Points
 
-There are two common entry points:
-
 1. **Bottom-right main entry**: Open the AI chat panel from the bottom-right corner of business pages. Suitable for general Q&A and cross-block collaboration.
-2. **Block Action entry**: In blocks that support `Actions`, enter via `Actions -> AI employees`. Suitable for tasks on the current block (for example JSBlock scenarios).
+2. **Block Action entry**: In blocks that support `Actions`, add AI Employees through `Actions -> AI employees`. Suitable for tasks on the current block, such as filling form blocks.
+3. **Scenario-specific entry**: Development-oriented employees, such as Nathan, Lina, and Dara, provide dedicated entries in specific scenarios such as JS blocks, chart blocks, or Localization Management.
 
-### Bottom-right main entry
+### Bottom-right Main Entry
 
 ![20260331165456](https://static-docs.nocobase.com/20260331165456.png)
 
-### Block Action entry
+### Block Action Entry
 
 ![20251022135306](https://static-docs.nocobase.com/20251022135306.png)
 
+### Scenario-Specific Entry
+
+![](https://static-docs.nocobase.com/202605121057862.png)
+
 ## Basic Chat Operations
 
 The chat panel supports common operations such as sending messages, uploading attachments, viewing history, creating new chats, and editing system prompts.
 
 ## In-Chat Switching
 
-In most cases, you can simply talk to Atlas, and he will coordinate the appropriate AI employee to help handle the task.
+In most cases, you can simply talk to Atlas, and he will coordinate the appropriate AI Employee to help handle the task.
 
-If you want to use a specific AI employee, click the AI employee dropdown in the message composer to select one.
+If you want to use a specific AI Employee, click the AI Employee dropdown in the message composer to select one.
 
 ![20260331174320](https://static-docs.nocobase.com/20260331174320.png)
 

package/dist/ai/docs/nocobase/ai-employees/features/enable-ai-employee.md

@@ -7,14 +7,14 @@ keywords: 'Enable AI Employees,AI employees,NocoBase'
 
 # Enable AI Employees
 
-NocoBase provides multiple built-in AI Employees for different scenarios.
+NocoBase provides built-in AI Employees for multiple scenarios. For the complete description, see [Built-in AI Employees](/ai-employees/built-in/).
 
 ## How to Enable
 
-Open the `AI employees` management page and toggle `Enabled` directly in the list.
+After entering the `AI employees` management page, turn on the `Enabled` switch directly in the list to enable an employee.
 
-![ai-employee-list-enable-switch.png](https://static-docs.nocobase.com/ai-employees/2026-02-14/ai-employee-list-enable-switch.png)
+![](https://static-docs.nocobase.com/202605121048555.png)
 
 ## Usage After Enabling
 
-After enabling, the employee appears in available entry points (such as bottom-right shortcut entry or scenario-specific entry).
+After enabling, the employee appears in available entries, such as the bottom-right shortcut entry or scenario-specific entry.

package/dist/ai/docs/nocobase/ai-employees/features/model-settings.md

@@ -0,0 +1,87 @@
+---
+pkg: '@nocobase/plugin-ai'
+title: 'Configure AI Employee Models'
+description: 'Restrict the model range for a single AI Employee, configure dedicated models, and understand model selection rules in chat, shortcut tasks, and workflows.'
+keywords: 'AI Employee model settings,dedicated model,model scope,LLM service,NocoBase AI'
+---
+
+# Configure AI Employee Models
+
+By default, AI Employees can use all enabled LLM services and models in the system. Administrators can also enable dedicated model settings for a specific AI Employee and restrict that employee to selected models.
+
+This is useful when you need stable model capability, cost control, or a task-specific model. For example, Lina can be fixed to a translation model, while Viz can be limited to models that are better at data analysis.
+
+## Prerequisites
+
+Before configuring models for an AI Employee, make sure that:
+
+- The **AI Employees** plugin is enabled.
+- At least one LLM service has been configured.
+- The LLM service has available `Enabled Models`.
+- The target AI Employee is enabled.
+
+For LLM service setup, see [Configure LLM Service](/ai-employees/features/llm-service).
+
+## Entry Point
+
+Go to `System Settings -> AI Employees -> AI employees`, open the AI Employee you want to configure, and switch to `Model settings`.
+
+You can enable or disable dedicated model settings for the current employee on this page.
+
+![](https://static-docs.nocobase.com/202605121216415.png)
+
+## Enable Dedicated Model Settings
+
+After enabling `Enable dedicated model configuration`, select the models that this AI Employee is allowed to use in `Models`.
+
+Multiple models can be selected. The options come from enabled LLM services and their `Enabled Models`.
+
+After this option is enabled, the AI Employee can only use the selected models:
+
+- The model switcher in chat only shows selected models.
+- Shortcut tasks can only use selected models.
+- Workflow AI Employee nodes can only select selected models.
+- If a request passes a model outside the allowed range, the system uses the first allowed model instead.
+
+:::info{title=Tip}
+If dedicated model settings are enabled but no model is selected, the AI Employee cannot resolve an available model and will report that the model is not configured.
+:::
+
+## Disable Dedicated Model Settings
+
+After disabling `Enable dedicated model configuration`, the AI Employee returns to the default model rules:
+
+- It can use all enabled LLM service models.
+- Users can switch to any available model in chat.
+- If no model is selected manually, the system uses the global default model.
+
+## Model Resolution Rules
+
+When an AI Employee executes a task, the final model is resolved in this order:
+
+1. If dedicated model settings are enabled, resolve within the selected model range first.
+2. If the request specifies a model and that model is allowed, use the specified model.
+3. If the specified model is not allowed, use the first allowed model.
+4. If dedicated model settings are not enabled, prefer the model specified by the request.
+5. If no model is specified, use the global default model.
+
+## Recommendations
+
+- Configure task-specific models for specialized employees. Translation, localization, data analysis, and code generation may benefit from different models.
+- Use lower-cost models for cost-sensitive scenarios and prevent users from switching to expensive models.
+- For employees that need tool calling, web search, or structured output, choose models that support those capabilities.
+- Keep at least one stable model available for key built-in employees to avoid task failures.
+
+## FAQ
+
+### Why is the model list empty?
+
+Usually because no LLM service has been configured, or no model is enabled in the LLM service. Check `Enabled Models` in `LLM service` first.
+
+### Why can't users switch to other models?
+
+If the AI Employee has dedicated model settings enabled, the chat window only allows switching within the selected model range. Add more models in `Model settings` or disable dedicated model settings if other models are needed.
+
+### Which entries are affected after model settings are changed?
+
+The change affects new chats, shortcut tasks, workflow AI Employee nodes, and plugin built-in tasks started by this AI Employee. Completed historical messages are not regenerated.

package/dist/ai/docs/nocobase/ai-employees/index.md

@@ -44,7 +44,7 @@ Start with [Quick Start](/ai-employees/quick-start), and complete minimal setup
 
 ### C. Advanced Capabilities (Extensions)
 
-- [Built-in AI Employees](/ai-employees/features/built-in-employee): understand built-in role positioning and suitable scenarios.
+- [Built-in AI Employees](/ai-employees/built-in/): understand built-in role positioning and suitable scenarios.
 - [Permission Control](/ai-employees/permission): control employee, skill, and data access by org permissions.
 - [AI Knowledge Base](/ai-employees/knowledge-base/index): import enterprise knowledge for stable and traceable answers.
 - [Workflow AI Employee Nodes](/ai-employees/workflow/nodes/employee/configuration): orchestrate AI Employee capabilities into automated workflows.