创建与使用自定义 Specialist

本教程创建一个“队列数据核查”角色，演示如何把团队的研究要求变成可复用配置。先完成快速开始，准备可用模型和科学计算环境。

1. 明确职责与交付

先写清角色负责什么、需要哪些输入以及交付什么。下面的角色负责检查输入，不负责直接解释治疗效果。它不需要外部文献连接器。

2. 创建角色

进入 系统配置 → Specialists，点击新建，填写：

你负责核查用户提供的队列数据。
先读取字段和实际数据范围；不确定哪个字段标识患者时，先说明歧义。
记录行数、患者数（仅在可以确定时）、重复值和缺失值。
如需筛选，说明依据并记录筛选前后数量，不自行补造数据。
保存实际执行的脚本与核查结果，声明为产物，在最终回复中给出入口。
没有足够信息时明确记录限制，不从核查直接推断治疗效果。

只选择角色需要的连接器。若角色需要自建数据接口，先按自定义 MCP 教程配置并测试，再回到角色页面选择。

支持按角色选择技能的界面中，可选 code-engineer。在 JiuwenSwarm 后端，角色编辑器会显示技能由 Swarm 管理的提示，不提供同样的技能复选框；改到 Skills 的 JiuwenSwarm 视图确认所需技能可用。不要把未显示的设置当作已经生效。

保存后，自定义角色出现在角色列表中。内置角色只支持启停；若要改变某个预置职责，创建自己的角色，而不是修改内置条目。

3. 在会话中验证

新建 Session，上传一份你有权使用的小 CSV，在会话的 Specialist 选择器中选中该角色。发送：“请核查这个文件的数据质量，交付核查脚本和结果。”

检查执行记录是否真正读取文件，并在产物区打开脚本与结果。如果没有运行代码，检查模型工具能力、环境状态和审批；如果需要的来源不可用，检查连接器配置。角色名称本身不能证明工作按预期完成。

选择 Specialist 让它承担当前会话角色，与让主 Agent 分派给它一个子任务，是两种不同用法。需要跨角色协作时，保留协调者，并在任务中说明分工需求，再查看实际子任务记录。

4. 逐步完善

根据试运行结果调整描述、指令和资源范围，再开始新任务验证。模型、凭据与运行环境仍按平台的对应设置配置，不是在这个角色表单里独立创建。

• 专业 Specialist：预置角色与适用场景。
• 导入与管理 Skill：加入自己的方法与脚本。