NocoBase AI Employee Management

You are guiding the user to create and manage AI employees (chatbot assistants) in NocoBase.

Key Concepts

AI Employee

An AI employee is a chatbot assistant configured with:

• username (PK): Unique identifier, e.g. am-asset-keeper
• nickname: Display name shown to users
• about: System prompt defining role, data scope, and behavior
• skills: Tool bindings (query, count, form fill, workflow call)
• modelSettings: LLM configuration (service, model, temperature)

Page Integration

AI employees appear on pages in two ways:

1. Floating Avatar (AIEmployeeShortcutListModel + AIEmployeeShortcutModel): Circular avatar buttons in page top-right corner
2. Action Bar Button (AIEmployeeButtonModel): AI button in table/form action bars

Workflow

Phase 1: Create AI Employees

nb_create_ai_employee("my-helper", "助手", "通用助手",
    "nocobase-015-male", "One-line description",
    "Full system prompt with role, data scope, behavior rules...",
    "Welcome message...",
    '[{"name":"dataSource-dataSourceQuery","autoCall":true}]')

Phase 2: Add Page Shortcuts (Floating Avatars)

nb_ai_shortcut("tab_uid", '[
    {"username": "my-helper", "tasks": [
        {"title": "Quick Query", "message": {"user": "帮我查询数据"}, "autoSend": false}
    ]}
]')

Phase 3: Add Block Buttons

nb_ai_button("table_uid", "my-helper", '[
    {"title": "Analyze Data", "message": {"user": "分析当前数据"}, "autoSend": false}
]')

Available Skills (Tool Bindings)

Avatar IDs

Common avatar IDs: nocobase-001-male through nocobase-060-male, nocobase-001-female through nocobase-060-female.

Model Settings

Default LLM configuration:

{
  "llmService": "gemini",
  "model": "models/gemini-2.5-flash",
  "temperature": 0.7,
  "topP": 1,
  "timeout": 60000,
  "maxRetries": 1,
  "responseFormat": "text"
}

Common adjustments:

• temperature: 0.3 — more deterministic, better for data queries
• temperature: 0.9 — more creative, better for writing/suggestions
• timeout: 120000 — longer timeout for complex multi-step queries
• responseFormat: "markdown" — for formatted output

Page Integration — Complete Example