Agent身份助手（专业版）

概述

当企业内部同时运行着10+个AI助手——客服机器人、IT工单助手、HR问答机器人、销售陪练Agent——就会出现一个棘手问题：这些助手说话风格不一致，价值观彼此冲突，边界划定标准不一。有的助手对用户过度承诺，有的助手在L3边界上含糊其辞，还有的助手因为业务调整后人格未同步更新而显得突兀. Agent身份助手专业版正是为解决这类"人格治理"问题而生。它在免费版三层身份模型的基础上，提供完整的多人格矩阵、动态路由、合规审计与A/B测试能力，让团队像管理代码资产一样管理Agent人格资产.

核心能力

能力1：多人格矩阵管理

支持在一个工作区内管理20+个Agent人格卡，按业务线、品牌、用户群体多维度分类：

维度	示例	用途
业务线	售前/售后/客服/技术支持	按业务场景分配人格
品牌	主品牌/子品牌/联名品牌	品牌矩阵账号管理
用户分层	VIP/普通用户/新用户	差异化人格体验
地区	国内/海外/港澳	本地化人格适配

处理: 解析能力1：多人格矩阵管理的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力1：多人格矩阵管理的响应数据,包含状态码、结果和日志.

能力2：动态人格路由引擎

基于多信号融合的实时人格选择：

具体详情请参考下方内容.

输入格式

参数名	类型	必填	说明
input	string	是	Agent身份助手专业版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

routing_signals:
  - user_profile:        # 用户画像
      tier: VIP
      region: china-east
  - conversation_context: # 会话上下文
      intent: complaint
      sentiment: frustrated
      turn_count: 5
  - business_context:     # 业务上下文
      product_line: finance
      risk_level: high

路由引擎在毫秒级完成决策，从人格矩阵中选择最匹配的人格卡加载.

处理: 解析能力2：动态人格路由引擎的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力2：动态人格路由引擎的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

能力3：企业级合规审计

自动检测人格定义中的合规风险：

• 价值观冲突检测：发现"目标层追求销量"与"价值观层诚实"的潜在矛盾
• 边界质量检查：识别未定义L2/L3边界的业务场景
• 反语调覆盖度：检查反语调清单是否覆盖行业敏感话术
• 司法管辖区适配：根据合同中指定的司法管辖区调整边界策略

处理: 解析能力3：企业级合规审计的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力3：企业级合规审计的响应数据,包含状态码、结果和日志.

能力4：A/B测试框架

将不同人格卡分配到对照组，量化关键指标差异：

指标类别	具体指标	测量方式
转化指标	咨询→下单率	业务埋点
体验指标	满意度评分	会话结束问卷
合规指标	投诉率	客服工单标记
效率指标	平均解决轮数	会话日志统计

处理: 解析能力4：A/B测试框架的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力4：A/B测试框架的响应数据,包含状态码、结果和日志.

能力5：团队协作与权限管理

角色	权限	适用场景
管理员	全部人格卡的增删改查	平台负责人
编辑者	仅本人创建的人格卡可编辑	业务线负责人
审计员	只读 + 审计报告生成	合规/法务团队
观察者	只读	跨部门参考

处理: 解析能力5：团队协作与权限管理的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力5：团队协作与权限管理的响应数据,包含状态码、结果和日志.

能力6：版本控制与回滚

每次人格卡修改自动生成版本快照，支持：

• 任意版本回滚
• 版本差异对比（Diff）
• 灰度发布（按5%/20%/50%/100%逐步放量）
• 异常自动熔断（满意度下降超阈值自动回滚）

处理: 解析能力6：版本控制与回滚的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力6：版本控制与回滚的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：跨场景自适应、合规审计与、测试一体的、身份治理平台、身份助手专业版是、面向团队与企业的、人格治理平台、在免费版三层身份、模型的基础上、新增多人格矩阵管、跨场景自适应切换、测试框架与团队协、作能力、核心能力、支持同时管理、根据对话上下文自、动切换基调、生成价值观一致性、提供人格对比测试、量化不同人格在转、满意度上的差异、支持团队级人格库、共享与权限管理等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景组1：客服中心负责人 × 多业务线人格管理

场景1.1 售前客服人格设计

• 目标层：帮用户在3轮内判断产品是否匹配需求
• 基调：同事（专业但不冷漠）
• 边界：L3拒绝承诺未上线功能

场景1.2 售后投诉处理人格设计

• 目标层：在5轮内完成情绪安抚+方案给出
• 基调：导师（耐心引导）
• 反语调：不催促、不催办

场景1.3 技术支持人格设计

• 目标层：直接给可执行方案
• 基调：同事（直接、有判断力）
• 边界：L2请示才执行账号变更

场景组2：合规审计员 × 金融行业Agent部署

场景2.1 投顾Agent合规审计

• 检测目标层是否含"保本保收益"等违规承诺
• 检测边界L3是否覆盖"代客操作账户"

场景2.2 信贷催收Agent审计

• 检测反语调是否覆盖"暴力催收话术"
• 检测L3边界是否覆盖"威胁、辱骂"

场景组3：产品经理 × A/B测试最优人格

场景3.1 新用户引导人格测试

• 对照组A：朋友基调（温暖随意）
• 对照组B：导师基调（耐心引导）
• 测量指标：7日留存率、首单转化率

场景3.2 VIP用户服务人格测试

• 对照组A：管家基调（正式隐忍）
• 对照组B：同事基调（专业平级）
• 测量指标：NPS评分、续费率

场景组4：品牌矩阵运营 × 多品牌人格治理

场景4.1 主品牌与子品牌人格差异化

• 主品牌：管家基调（高端服务）
• 子品牌：朋友基调（年轻活力）
• 统一价值观层：不夸大功效、不隐瞒风险

场景4.2 联名品牌人格设计

• 融合双方品牌调性
• 边界L3合并取严

不适用场景

以下场景Agent身份助手专业版不适合处理：

• 需要100%确定性的关键决策
• 医疗诊断
• 法律判决

触发条件

需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于非本工具能力范围的需求.

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

60秒上手（团队管理员）

# 1. 初始化团队工作区
agent-identity init --team "我的团队" --admin admin@company.com
# ...
# 2. 导入免费版人格卡（升级迁移）
agent-identity import --from ./free-identity-card.yaml
# ...
# 3. 添加团队成员
agent-identity member add --email editor@company.com --role editor
# ...
# 4. 创建领先张人格卡
agent-identity card create --name "客服-售前" --template colleague

配置动态路由

routing:
  rules:
    - name: VIP用户优先管家服务
      condition:
        user_tier: VIP
      persona: butler-vip
# ...
    - name: 投诉场景切换导师基调
      condition:
        intent: complaint
        sentiment_score_lt: 0.3
      persona: mentor-complaint
# ...
    - name: 技术咨询切换同事基调
      condition:
        product_line: tech
      persona: colleague-tech
# ...
  default: colleague-default
  fallback_on_error: true

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

示例1：金融行业Agent完整身份卡

card:
  name: 投顾助手-合规优先
  version: 2.1.0
  edition: pro
# ...
  identity:
    purpose: 帮用户理解风险并做出知情决策
    values:
      - 不承诺保本保收益
      - 主动揭示风险
      - 不诱导频繁交易
      - 检测到非理性情绪时建议暂停
    perspective: 像一位理性的理财顾问
# ...
  voice:
    do:
      - 用具体数字描述历史回撤
      - 主动询问风险承受能力
      - 在推荐产品前先做适配性评估
    dont:
      - 不说"稳赚不赔"
      - 不用"限时""最后机会"等催促话术
      - 不在用户情绪激动时立即下单
# ...
  boundaries:
    L0: 查询产品信息、计算收益场景
    L1: 提示用户查看风险揭示书
    L2: 请示才生成订单（含二次确认）
    L3: 代客操作账户、修改风险测评结果
# ...
  compliance:
    jurisdiction: cn-banking
    audit_frequency: monthly
    forbidden_phrases: [保本, 稳赚, 内部消息]
# ...
  routing_triggers:
    - user_segment: high-net-worth
    - product_type: structured-deposit

示例2：A/B测试配置

experiment:
  name: 新用户引导人格对比
  duration: 30d
  traffic_split:
    - variant: A_friend
      weight: 50
      persona: friend-onboarding
    - variant: B_mentor
      weight: 50
      persona: mentor-onboarding
# ...
  metrics:
    primary: day7_retention
    secondary:
      - first_order_conversion
      - avg_session_length
      - nps_score
# ...
  guardrail:
    - metric: complaint_rate
      threshold: 0.02
      action: auto_pause

优选实践

实践1：人格矩阵分阶段建设

不要一次性定义20个人格。建议按"1个核心人格 → 3个业务线人格 → N个细分场景人格"的节奏迭代。每增加一个，先用A/B测试验证效果再正式上线.

实践2：合规审计前置

在人格卡上线前，先由审计员角色运行合规检查。重点检查反语调清单是否覆盖行业敏感话术、L3边界是否覆盖所有禁止场景.

实践3：灰度发布 + 自动熔断

新人格上线时先灰度5%流量，监控关键指标。若满意度下降超过5%或投诉率上升超过2%，自动回滚至上一版本.

实践4：人格版本与代码版本解耦

人格卡独立于Agent代码部署，支持热更新。这样业务侧调整人格不需要重新发布代码，降低发布风险.

实践5：定期审计与迭代

每季度运行一次全量合规审计，识别：

• 因业务变化而过时的价值观条款
• 新出现的行业敏感话术未纳入反语调
• 边界L3未覆盖的新业务场景

常见问题

Q1：专业版支持多少个人格卡？

A：单工作区上限为100张人格卡，超出可申请扩容.

Q2：动态路由引擎的延迟是多少？

A：P99延迟<50ms，对会话体验无感知影响.

Q3：合规审计报告支持哪些行业标准？

A：内置金融（银保监）、医疗（HIPAA）、电商（消保法）、教育（未成年人保护）等行业模板，支持自定义规则集.

Q4：A/B测试的统计显著性如何保证？

A：内置贝叶斯统计引擎，自动计算样本量需求，达到显著性阈值后才输出结论.

Q5：能否对接现有CRM/CDP系统？

A：支持。通过Webhook方式从CRM获取用户画像信号，也支持将路由决策日志回写至CDP.

Q6：人格卡能否导出为标准格式？

A：支持YAML、JSON、OpenAPI Persona Spec三种导出格式.

Q7：团队成员权限如何分配？

A：支持管理员/编辑者/审计员/观察者四种角色，可按工作区或单张人格卡粒度授权.

Q8：灰度发布如何与A/B测试区分？

A：灰度发布是"逐步放量降低风险"，A/B测试是"对照实验寻找最优解"。两者可组合使用——先A/B测试确定胜出人格，再灰度发布逐步放量.

Q9：人格卡变更如何回滚？

A：每次修改自动生成版本快照，支持任意版本一键回滚，回滚操作有完整审计日志.

Q10：是否支持私有化部署？

A：企业版支持私有化部署，人格卡数据全程不出企业网络.

错误处理

错误场景(现象)	可能原因	排查步骤	优先级	处理方式
路由决策延迟高	规则数量过多	检查规则数量，合并相似规则	P1	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
人格切换不生效	缓存未刷新	执行 agent-identity cache clear	P2	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
合规审计漏报	规则集版本旧	更新至最新行业规则集	P0	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
A/B测试样本不均	流量分配配置错误	检查 weight 总和是否为100	P1	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
团队成员看不到人格卡	权限配置遗漏	检查工作区授权	P2	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
灰度发布卡住	熔断阈值过低	临时调高 guardrail 阈值	P1	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
审计报告生成失败	数据源连接超时	检查CRM/CDP连接	P1	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
回滚后状态异常	版本快照损坏	从备份恢复最新快照	P0	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令

多平台集成示例

与Claude Code集成

integration:
  platform: claude-code
  mode: system_prompt_injection
  inject_point: conversation_start
  cache_strategy: session_level

与Cursor集成

integration:
  platform: cursor
  mode: rules_file
  output_format: .cursorrules
  sync_frequency: on_change

与企业自研Agent框架集成

integration:
  platform: custom
  mode: api
  endpoint: https://api.company.com/identity
  auth: bearer_token
  fallback_persona: colleague-default

版本升级迁移指南

从免费版迁移至专业版

# 1. 导出免费版人格卡
agent-identity export --from free --output ./backup.zip
# ...
# 2. 在专业版工作区导入
agent-identity import --to pro --input ./backup.zip --migrate
# ...
# 3. 验证导入结果
agent-identity card list --workspace pro
# ...
# 4. 启用动态路由
agent-identity routing enable

迁移过程中的人格卡字段映射：

免费版字段	专业版字段	迁移策略
目标层	identity.purpose	直接映射
价值观层	identity.values	直接映射
视角层	identity.perspective	直接映射
语调行为	voice.do/dont	拆分为do和dont
边界表	boundaries.L0-L3	直接映射
（无）	routing_triggers	新增字段，需手动配置
（无）	compliance	新增字段，需手动配置

专业版特性

本专业版相比免费版新增以下能力：

• ✅ 多人格矩阵：单工作区支持100张人格卡，按业务线/品牌/用户分层多维度管理
• ✅ 动态人格路由引擎：基于用户画像、会话上下文、业务信号毫秒级选择最优人格
• ✅ 企业级合规审计：内置金融/医疗/电商/教育行业规则集，自动检测价值观冲突与边界漏洞
• ✅ A/B测试框架：贝叶斯统计引擎，量化不同人格在转化率、满意度上的差异
• ✅ 团队协作：管理员/编辑者/审计员/观察者四角色权限管理
• ✅ 版本控制与灰度发布：版本快照、Diff对比、灰度放量、异常自动熔断
• ✅ 多平台集成：支持Claude Code、Cursor、企业自研框架对接
• ✅ 优先支持：专属技术支持群、48小时SLA响应、季度产品咨询

定价

版本	价格	功能	适用场景
免费体验版	¥0	单人格定义+基础模板	个人试用
收费专业版	¥99/月 或 ¥999/年	全功能+高级特性+优先支持	团队/企业

专业版通过SkillHub SkillPay发布.

依赖说明

运行环境

• Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统：Windows / macOS / Linux
• 运行时：Node.js 18+（用于动态路由引擎）/ Python 3.10+（用于合规审计脚本）

依赖详情

依赖项	类型	是否必需	获取方式	版本要求
LLM API	API	必需	由Agent平台内置LLM提供	不限
Node.js	运行时	必需	官方下载	18+
Python	运行时	必需	官方下载	3.10+
YAML解析器	库	必需	npm/pip	pyyaml 6.0+
统计引擎	库	可选	pip	scipy 1.10+

API Key 配置

• SkillHub Token：存储于 d:\skills\.skillhub-credentials\api-key.txt（已gitignore）
• CRM/CDP集成Token：通过环境变量 IDENTITY_CRM_TOKEN 注入
• 私有化部署Token：存储于企业内网密钥管理服务
• 禁止：在SKILL.md或脚本中硬编码Token

可用性分类

• 分类：MD+EXEC（Markdown指令 + 命令行工具）
• 说明：核心身份定义基于Markdown，动态路由与合规审计需要exec命令行执行能力

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

输出格式

{
  "success": true,
  "data": {
    "result": "Agent身份助手专业版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "agent assistant pro"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
网络通信安全	使用HTTPS协议，验证SSL证书有效性
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

核心功能

• 自动化执行: 多人格矩阵、跨场景自适应、合规审计与A/B测试一体的Agent身份治理平台。Agent身份助手专业版是面向团队与企业的A
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据