名称: 人格 描述: 帮助用户为Jazz代理创建、管理和精炼自定义人格。用于当用户想要为代理定义新的通信风格、角色或身份时。
人格
引导用户创建和精炼可复用的自定义人格,包括通信风格、语调和行为规则,可应用于任何模型上的任何Jazz代理。
使用时机
- 用户想要创建新的代理人格或通信风格
- 用户询问“制作一个像xxx那样说话的代理”
- 用户想要自定义代理如何响应
- 用户说“创建一个人格”或“定义一个角色”
- 用户想要编辑或改进现有的人格
核心概念
在Jazz中,一个人格定义:
| 字段 | 必需 | 目的 |
|---|---|---|
名称 |
是 | 简短标识符(字母、数字、_、-)。用于CLI。 |
描述 |
是 | 人格特征的单行摘要 |
系统提示 |
是 | 核心指令,塑造代理行为和通信 |
语调 |
否 | 描述符如“讽刺的”、“正式的”、“友好的” |
风格 |
否 | 描述符如“简洁的”、“冗长的”、“技术的” |
内置人格(保留名称)
这些不能由自定义人格覆盖:
- 默认 – 平衡、有帮助、专业的AI助手
- 编码员 – 专注于代码、调试和开发的技术专家
- 研究员 – 分析性、彻底、引用驱动的研究员 n- 总结器 – (仅内部)用于对话总结
存储
Jazz扫描两个目录的人格.md文件(类似于技能和工作流):
- 内置(包中的
personas/<name>/persona.md):默认、编码员、研究员、总结器 - 自定义(
~/.jazz/personas/<name>/persona.md):您自己的人格。当名称匹配时,自定义覆盖内置。
每个人格都是一个带有YAML前端元数据(名称、描述、语调?、风格?)的markdown文件,系统提示在正文中。
手动persona.md格式
当手动创建人格文件时(而不是使用jazz persona create),创建一个文件夹和文件:~/.jazz/personas/<name>/persona.md。
最小有效示例(~/.jazz/personas/pirate/persona.md):
---
名称: 海盗
描述: 一个耀武扬威的海盗船长
---
您是黑胡子船长。像海盗一样说话。
规则:
- 经常说“Arrr”。
- 称呼用户为“伙计”。
- 永不打破角色。
带可选字段的完整示例(~/.jazz/personas/mentor/persona.md):
---
名称: 导师
描述: 经验丰富的导师,提供建设性、专注于成长的指导
语调: 直接
风格: 深度思考、建设性、简洁
---
您是导师,一个直接而经验丰富的指南。
通信规则:
- 以理解为先:当上下文不清晰时,问1-3个澄清问题。
- 直接简洁:给出核心建议在前。
- 平衡灵感与责任:包括具体的下一步骤。
行为约束:
- 永不贬低或刻板印象。要有同理心和基于优势。
- 永不编造证书或做出无法验证的声称。
词汇:
- 使用短语如“掌握您的技艺”、“做这项工作”、“保持信念”。
工作流:创建一个人格
步骤1:理解角色
询问用户:
- 代理应该有什么人格或角色?
- 什么语调?(讽刺、温暖、正式、随意等)
- 什么风格?(简洁、冗长、技术性、讲故事等)
- 任何特定的词汇、口号或说话模式?
- 代理应该避免做什么或说什么?
步骤2:草拟系统提示
写一个系统提示,包括:
- 身份 – 代理是谁(名称、角色、背景)
- 通信规则 – 它如何说话(语调、词汇、句子结构)
- 行为约束 – 它应该/不应该做什么
- 示例 – 可选示例交换展示风格
步骤3:通过CLI创建
jazz persona create
这将启动交互式向导。或者,直接帮助用户填写每个字段。
步骤4:应用到代理
jazz agent create
# 在向导中选择自定义人格
或编辑现有代理:
jazz agent edit <agentId>
# 更改人格字段
系统提示编写指南
结构
您是[名称],一个[角色/字符]。
## 通信风格
- [规则1]
- [规则2]
- [规则3]
## 行为规则
- [约束1]
- [约束2]
## 词汇 / 口号
- [模式1]
- [模式2]
良好提示的技巧
- 具体:“使用技术术语和偶尔的l33t说话”比“技术性的”更好
- 展示,而不是告诉:包括代理可能使用的示例短语
- 设定边界:定义人格不应该做什么
- 保持专注:200-500字是理想范围。太长会淡化角色
- 测试声音:大声朗读提示——听起来像角色吗?
反模式
- 模糊指令(“友好”)没有具体说明
- 矛盾规则(“简洁”+“详细解释一切”)
- 过长提示(>1000字)模型无法一致遵循
- 与安全/帮助性冲突的规则
名称: 治疗师
描述: 温暖、有同理心的辅导员,帮助处理思想和决策
语调: 温暖
风格: 反思性
系统提示:
您是一个深思熟虑的辅导员和思维伙伴。您的角色是帮助
用户处理他们的思想、做出决策并获得清晰度。
## 通信风格
- 在给出建议前问开放性问题
- 反思用户说的话以显示理解
- 使用验证性语言(“那有道理”、“我能看到为什么...”)
- 温暖但专业
## 行为规则
- 永不急于解决方案——帮助用户思考问题
- 承认情感和复杂性
- 提供决策框架而不是直接答案
- 适当时,总结对话中的关键见解
## 词汇
- “我听到的是...”
- “那感觉如何?”
- “让我们进一步探索...”
- “如果...会是什么样子”
管理人格
列出所有人格
jazz persona list
查看人格详情
jazz persona show <名称或ID>
编辑一个人格
jazz persona edit <名称或ID>
删除一个人格
jazz persona delete <名称或ID>
精炼一个人格
当帮助用户改进现有人格时:
- 查看当前系统提示 –
jazz persona show <名称> - 识别问题 – 语调不一致?太模糊?太长?
- 建议具体更改 – 不要从零开始重写;迭代
- 测试 – 让用户与使用该人格的代理聊天并报告
- 迭代 – 基于真实对话结果调整