feat: create-agent / update-agent v2.2.0 — 结构化 L0/L1/L2 API 输入

- create-agent: API 改为结构化 PersonaInput/PrinciplesInput JSON 输入
- create-agent: 用户确认预览从原始 markdown 改为表格形式
- create-agent: 支持最简创建(仅 name),自动补全所有默认值
- update-agent: 新增结构化 GET/PUT persona/principles 端点说明
This commit is contained in:
2026-02-28 10:12:53 +08:00
parent b8ba404577
commit 386c1c2e43
4 changed files with 90 additions and 62 deletions

View File

@@ -3,7 +3,7 @@ name: create-agent
description: >-
通过多轮对话收集需求,调用 HTTP API 创建新的 AgentFS v2 智能体,支持自定义 persona 和 principles。Use when
用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。
version: 2.1.0
version: 2.2.0
type: meta
risk_level: medium
status: enabled
@@ -14,8 +14,8 @@ tags:
- meta
metadata:
author: desirecore
version: 2.1.0
updated_at: '2026-02-26'
version: 2.2.0
updated_at: '2026-02-27'
market:
icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -113,49 +113,32 @@ create-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 创建
### 阶段 3内容生成
根据收集的需求,为新 Agent 生成以下内容:
根据收集的需求,组装结构化的 persona 和 principles 数据。**不要输出原始 markdown**,而是按字段整理后向用户展示。
**persona.md 生成规范**
**Persona 字段**(所有字段均可选,未收集到的由系统自动补全)
生成 persona.md 时,直接输出以下结构的 markdown 内容供用户阅读和确认,不要用代码块包裹:
| 层级 | 字段 | 说明 |
|------|------|------|
| L0 | — | 一句话核心身份 |
| L1 | `role` | 角色定位 |
| L1 | `personality` | 性格特征标签 |
| L1 | `communication_style` | 沟通风格 |
| L2 | — | 专业领域、核心价值观、决策偏好等free-form |
> **L0 — 核心身份**
>
> 你是 {name}{一句话角色定位}。
>
> **L1 — 行为风格**
>
> - {风格特征 1}
> - {风格特征 2}
> - {风格特征 3}
>
> **L2 — 深层动机**
>
> {2-3 句话描述深层价值观和驱动力}
**Principles 字段**(同样全部可选):
**principles.md 生成规范**
生成 principles.md 时,同样直接输出 markdown 内容:
> **L0 — 基础约束**
>
> - {安全红线 1}
> - {安全红线 2}
>
> **L1 — 行为边界**
>
> - {行为规则 1}
> - {行为规则 2}
> - {行为规则 3}
>
> **L2 — 治理原则**
>
> {2-3 句话描述最高治理原则}
| 层级 | 字段 | 说明 |
|------|------|------|
| L0 | — | 一句话最高原则 |
| L1 | `must_do` | 必须做的事项 |
| L1 | `must_not` | 绝不做的事项(安全红线) |
| L1 | `priority` | 优先级排序 |
| L2 | — | 治理原则、升级规则等free-form |
**领域匹配参考**
| 领域关键词 | 推荐风格 | 默认边界 |
|-----------|---------|---------|
| 领域关键词 | 推荐 personality | 默认 must_not |
|-----------|-----------------|--------------|
| 法律、合同、法务 | 专业、严谨、审慎 | 不提供诉讼代理、不替代正式法律意见 |
| 财务、会计、投资 | 精确、分析性、保守 | 不提供投资建议、不处理真实交易 |
| 代码、开发、架构 | 逻辑、务实、直接 | 不直接访问生产环境、不存储凭证 |
@@ -163,9 +146,7 @@ create-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 创建
### 阶段 4用户确认
**展示预览**
向用户展示预览时,以自然可读的 markdown 格式直接呈现,不使用代码块包裹:
向用户展示预览时,以自然语言/表格形式呈现各字段,**不要展示原始 markdown 源码**
> 即将创建智能体:
>
@@ -174,21 +155,23 @@ create-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 创建
>
> ---
>
> **persona.md 预览**
> **人格设定**
>
> **L0 — 核心身份**
> 你是法律顾问小助手,专注于合同审查和法律风险评估...
> | 字段 | 内容 |
> |------|------|
> | 核心身份 | 你是法律顾问小助手,专注于合同审查和法律风险评估 |
> | 角色定位 | 专注于合同审查和法律风险评估的数字法律顾问 |
> | 性格特征 | 专业、严谨、审慎 |
> | 沟通风格 | 准确使用法律术语,同时提供通俗解释 |
>
> *(完整内容)*
> **行为原则**
>
> ---
>
> **principles.md 预览**
>
> **L0 — 基础约束**
> - 不提供诉讼代理
>
> *(完整内容)*
> | 字段 | 内容 |
> |------|------|
> | 最高原则 | 以用户利益为最高优先级,不替代正式法律意见 |
> | 必须做 | 准确引用法律条文、标注不确定性、建议咨询专业律师 |
> | 绝不做 | 提供诉讼代理、替代正式法律意见、泄露用户咨询内容 |
> | 优先级 | 用户安全 > 准确性 > 效率 |
>
> ---
>
@@ -198,17 +181,45 @@ create-agent 是一个**元技能Meta-Skill**,赋予 DesireCore 创建
**API 端点**`POST /api/agents`
**请求体**
**请求体**(结构化格式)
```json
{
"name": "法律顾问小助手",
"description": "专注于合同审查和法律风险评估的数字智能体",
"persona": "# L0 — 核心身份\n\n你是法律顾问小助手...",
"principles": "# L0 — 基础约束\n\n- 不提供诉讼代理..."
"persona": {
"L0": "你是法律顾问小助手,专注于合同审查和法律风险评估的数字智能体。",
"L1": {
"role": "专注于合同审查和法律风险评估的数字法律顾问",
"personality": ["专业", "严谨", "审慎"],
"communication_style": "准确使用法律术语,同时提供通俗解释"
}
},
"principles": {
"L0": "以用户利益为最高优先级,不替代正式法律意见。",
"L1": {
"must_do": ["准确引用法律条文", "标注不确定性", "建议咨询专业律师"],
"must_not": ["提供诉讼代理", "替代正式法律意见", "泄露用户法律咨询内容"],
"priority": "用户安全 > 准确性 > 效率"
}
}
}
```
**最简创建**(只需 name其余全部自动生成
```json
{ "name": "我的助手" }
```
**基础创建**name + descriptiondescription 自动填充 persona L0
```json
{ "name": "法律顾问", "description": "专注合同审查" }
```
所有未提供的字段由系统自动补全为合理默认值。`persona``principles` 也支持传入原始 markdown 字符串(向后兼容)。
**可选**:如需指定 slug ID可根据 name 生成合理的 kebab-case slug如 "法律顾问" → "legal-advisor"),在请求体中附带 `"id": "<slug>"`。不指定时系统会自动从 name 生成。
**成功响应** (`201 Created`)