qoderwake中创建“跨境支付风控专员”数字员工需五步：点击【+ 新建角色】进入yaml编辑器；填写name、version、description、role_type四字段；在metadata中声明team、department及scope_limit；在skills区块按序挂载swift-parser-v2、aml-checker-pro、audit-snapshot技能链；在knowledge_sources绑定swifter-aml-rules知识库；最后保存并启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为QoderWake创建一个贴合实际业务场景的数字员工角色，比如“跨境支付风控专员”或“小程序灰度发布审核员”，而不是直接使用预置的后端工程师、产品经理等通用角色。
创建自定义角色入口
启动QoderWake桌面客户端并登录账号后，点击左侧导航栏最底部的【+ 新建角色】按钮。该按钮仅在启用“自定义”角色权限后可见——若未显示，请先确认当前账号已开通Pro版或企业管理员已授予自定义角色创建权限。
点击后进入角色配置向导页，系统自动跳转至YAML编辑器界面，顶部标签栏显示“role.yaml（未保存）”。
填写角色基础元信息
在YAML文件开头部分，按顺序填写以下4个必填字段：
name: 跨境支付风控专员
version: 1.0
description: 基于SWIFT报文与境内反洗钱规则库，对每笔≥5万美元跨境交易执行实时合规校验，拦截高风险路径并生成审计快照。
role_type: custom
注意：name字段必须全英文且不含空格或特殊字符，否则后续技能绑定将失败；description字段需明确写出该角色要解决的具体问题，不能写成“负责风控相关工作”这类模糊表述。
定义角色身份上下文
在metadata区块中声明该角色的组织归属与权限边界：
添加如下代码段：
metadata:
team: finance-risk
department: compliance
scope_limit:
allowed_repos: ["qoder-pay-core", "aml-rules-v3"]
forbidden_actions: ["delete_branch", "force_push"]
这一配置决定了数字员工能访问哪些代码仓库、不能执行哪些危险操作。若漏填allowed_repos，角色将无法读取任何Git资源；若未设forbidden_actions，它可能在未经确认下强制推送代码。
挂载核心技能链
进入skills区块，逐条声明该角色可调用的能力节点：
skills:
- id: swift-parser-v2
trigger: on_message_contains("MT103", "MT202")
- id: aml-checker-pro
trigger: after(swift-parser-v2)
- id: audit-snapshot
trigger: on_success(aml-checker-pro)
每个skill必须有唯一id，且id需与QoderWork开放平台中已注册的Skill完全一致。trigger字段决定调用时机，支持三种语法：on_message_contains（监听输入关键词）、after（前序技能成功后触发）、on_success（指定技能返回allowed:true时执行）。不要把trigger写成自然语言描述，例如“当收到报文时”会导致解析失败。
绑定专属知识库
在knowledge_sources区块中关联结构化业务知识：
knowledge_sources:
- type: qoder_knowledge_db
id: swifter-aml-rules
version: 2026.Q2
embedding_model: text-embedding-3-large
update_policy: auto_sync_daily
此处的id必须与你在QoderWork知识管理后台创建的知识库ID严格一致。若填错ID，角色运行时会提示“Knowledge source not found”，且不会降级 fallback 到通用知识库。
保存并激活角色
点击右上角【保存并部署】按钮，系统开始校验YAML语法与依赖完整性。
校验通过后弹出确认框，勾选【立即启用该角色】并点击确定。
等待状态栏显示“角色已就绪（Ready）”，此时可在侧边栏看到新角色图标，鼠标悬停显示名称与版本号。
