#AI 员工

在 NocoBase 中，AI 员工（AI Employee） 是一类可以围绕具体职责持续工作的 Agent。一个 AI 员工由角色设定、LLM、Skill 和 Tool 共同组成：角色设定说明它是谁、怎样回答；LLM 负责理解和生成；Skill 提供完成任务的方法；Tool 让它读取业务数据或执行操作。

AI 员工并不局限于一个聊天窗口。你可以把完整对话放在独立页面或业务区块里，也可以把入口放在应用右下角、记录操作区或表单旁边。页面还可以把当前记录、表单和局部操作作为上下文交给 AI 员工，让对话和正在处理的业务保持一致。

#从哪里开始

#先分清三类扩展

AI 员工相关内容分别属于应用源码、应用配置和管理后台。三者解决的问题不同。

应用运行时只有一个由 AI 员工插件注册的 AIManager。应用资源应接入这个实例，不要另外调用 createAIManager() 建一套平行运行时。普通前端对话使用插件提供的 nocobase-ai Registry 安装副本；安装后由其中的 Service 和 Transport 处理会话、文件上传、流式响应、Tool 审批和断线恢复。

#应用中的目录

下面是和 AI 员工扩展直接相关的目录。

config.yml
server/
├── ai/
│   ├── employees/          # 应用自己的 AI 员工
│   ├── tools/              # 应用级后端 Tool
│   └── index.ts            # 静态聚合并注册 Employee 和 Tool
└── providers/              # 把应用 AI 资源接入运行时
ai/
└── skills/<name>/SKILL.md  # Skill 的工作说明，不包含 Tool 代码
client/
└── extensions/nocobase-ai/ # 应用拥有的 AI 前端 Registry 源码

Employee 和 Tool 通过静态 import 注册，Skill 使用 SkillsLoader 从 SKILL.md 加载。MCP 连接只通过 config.yml 的 ai.mcpServers 配置。Skill 目录不定义 Tool，Skill 的 tools 只写已经在代码中注册的 Tool 名称。员工引用的 Skill 和 Tool 在运行时按名称查找，和注册的先后顺序无关，详见 定义自己的 AI 员工。

#相关链接

• 快速开始 — 配置 LLM 并创建全局对话入口
• 定义 AI 员工 — 注册 Employee、Tool 和 Skill
• 使用 AI 组件 — 将 AI 对话接入应用页面
• 配置参考 — 查看 config.yml 的 AI 配置项
• 管理 AI 服务 — 使用管理页调整运行状态
• 扩展服务端 AI 服务 — 在服务端直接调用 Agent