在Zion中为智能体设定角色需用UTF-8无BOM的role_schema.json定义JSON Schema,含name、description、skills、constraints四必填字段,绑定后重启智能体生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Zion函子中为智能体设定角色,需要通过JSON Schema格式明确定义其身份、能力边界与行为约束,否则智能体将沿用默认泛化人格,无法响应特定角色语境下的推理或交互。
准备角色定义的结构框架
新建一个纯文本文件,命名为role_schema.json,确保编码为UTF-8,BOM头必须去除——【带BOM会导致Zion解析失败并静默跳过该角色配置】。
在文件开头写入标准JSON Schema根结构:{"type": "object", "properties": {},"required": []},这一步不能省略,Zion只认严格符合Schema规范的对象定义。
填充核心角色字段
在"properties"内添加四个必填字段:name(字符串)、description(字符串)、skills(字符串数组)、constraints(字符串数组)。
name字段值必须是ASCII字符,中文名需转为拼音或英文别名——【Zion当前版本不支持中文字段名作为运行时标识符】。
description用一句话说明该角色存在的目的,例如:"负责审核用户提交的合规性声明,并依据GDPR第17条触发删除流程"。
skills数组列出3~5项具体能力动词短语,如["解析PDF元数据","比对欧盟成员国列表","生成DSAR响应模板"],避免使用"理解""掌握"等模糊动词。
绑定角色到指定智能体
打开Zion控制台→进入目标工作区→点击左侧「Agents」→选择待配置的智能体→点击「Edit Config」→滚动到底部找到「Role Schema Path」输入框。
将之前保存的role_schema.json文件拖入Zion上传区,或粘贴其绝对路径(Windows用双反斜杠\,macOS/Linux用正斜杠/)。
点击「Apply & Restart」,Zion会校验Schema语法并重载该智能体进程——若界面右上角出现绿色提示“Role loaded”,说明绑定成功。











