225 lines
6.9 KiB
Markdown
225 lines
6.9 KiB
Markdown
# execution 应用协议
|
||
|
||
> **TL;DR:** execution标签用于定义结构化的执行框架，帮助AI系统完成任务，包含流程(Process)、指导原则(Guideline)、强制规则(Rule)、约束条件(Constraint)和评价标准(Criteria)五个核心子概念。
|
||
|
||
## 🔍 基本信息
|
||
|
||
**标签名:** `<execution>`
|
||
**版本:** 1.0.0
|
||
**类别:** 执行
|
||
**状态:** 草稿
|
||
**创建日期:** 2023-06-21
|
||
|
||
### 目的与功能
|
||
|
||
execution标签定义了AI系统执行任务的完整框架，它的主要功能是：
|
||
- 提供执行任务的结构化定义
|
||
- 明确执行的流程步骤、指导原则、规则、约束和评价标准
|
||
- 帮助AI系统进行精确、可靠的任务执行
|
||
- 提供执行状态追踪和错误处理机制
|
||
|
||
## 📝 语法定义
|
||
|
||
```ebnf
|
||
(* EBNF形式化定义 *)
|
||
execution_element ::= '<execution' attributes? '>' content '</execution>'
|
||
attributes ::= (' ' attribute)+ | ''
|
||
attribute ::= name '="' value '"'
|
||
name ::= [a-zA-Z][a-zA-Z0-9_-]*
|
||
value ::= [^"]*
|
||
content ::= (markdown_content | process_element | guideline_element | rule_element | constraint_element | criteria_element)+
|
||
|
||
process_element ::= '<process' attributes? '>' markdown_content '</process>'
|
||
guideline_element ::= '<guideline' attributes? '>' markdown_content '</guideline>'
|
||
rule_element ::= '<rule' attributes? '>' markdown_content '</rule>'
|
||
constraint_element ::= '<constraint' attributes? '>' markdown_content '</constraint>'
|
||
criteria_element ::= '<criteria' attributes? '>' markdown_content '</criteria>'
|
||
|
||
markdown_content ::= (* 任何有效的Markdown文本，可包含特定语法元素 *)
|
||
```
|
||
|
||
## 🧩 语义说明
|
||
|
||
execution标签表示一个完整的执行框架。标签内容可以包含五种不同概念的子标签，每个子标签都有明确的语义：
|
||
|
||
- **process**: 表示执行的具体步骤，包含正常和异常路径，是执行的核心路径定义
|
||
- **guideline**: 表示建议性指导原则，具有灵活性和可变通性，用于推荐最佳实践
|
||
- **rule**: 表示强制性行为准则，必须严格遵守，通常涉及安全、合规或核心质量要求
|
||
- **constraint**: 表示客观限制条件，客观存在且不可改变，需要被动适应
|
||
- **criteria**: 表示评价标准，用于判断执行结果是否满足要求
|
||
|
||
这五个子概念构成了完整的执行框架，从不同维度定义了AI系统如何执行任务。
|
||
|
||
## 💡 最佳实践
|
||
|
||
以下是使用execution标签的一些建议做法，这些并非强制要求，仅作为参考：
|
||
|
||
### 优先级关系
|
||
|
||
execution框架内的子概念具有内在的优先级关系：
|
||
|
||
1. **Constraint(约束)** - 最高优先级，不可违反
|
||
2. **Rule(规则)** - 次高优先级，必须遵循
|
||
3. **Guideline(指导原则)** - 较低优先级，推荐遵循但可灵活调整
|
||
4. **Process(流程)** - 定义执行路径，需在约束、规则框架内实施
|
||
5. **Criteria(标准)** - 评价依据，用于验证执行结果
|
||
|
||
在设计执行框架时，应遵循此优先级关系，确保低优先级元素不与高优先级元素冲突。
|
||
|
||
### 表达原则
|
||
|
||
各子概念推荐使用不同的表达方式：
|
||
|
||
#### process - 适合使用图形表达
|
||
|
||
流程是最适合使用图形表达的元素，推荐使用流程图或时序图：
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[开始] --> B{条件判断}
|
||
B -->|条件成立| C[执行步骤1]
|
||
B -->|条件不成立| D[执行步骤2]
|
||
C --> E[下一步]
|
||
D --> E
|
||
E --> F[结束]
|
||
```
|
||
|
||
#### guideline - 适合使用列表表达
|
||
|
||
建议性指导原则适合使用有序或无序列表，突出推荐性质：
|
||
|
||
```
|
||
- 提供用户友好的错误信息
|
||
- 对敏感操作进行二次确认
|
||
- 使用渐进式信息收集方式
|
||
```
|
||
|
||
#### rule - 适合使用编号列表表达
|
||
|
||
强制性规则适合使用编号列表，突出其必须遵守的性质：
|
||
|
||
```
|
||
1. 密码必须包含大小写字母、数字和特殊字符
|
||
2. 敏感数据传输必须使用加密通道
|
||
3. 用户操作必须记录审计日志
|
||
```
|
||
|
||
#### constraint - 适合使用分类列表表达
|
||
|
||
约束条件适合使用分类列表，按约束类型组织：
|
||
|
||
```
|
||
技术约束：
|
||
- 服务器内存限制: 16GB
|
||
- 数据库连接数上限: 100
|
||
|
||
业务约束：
|
||
- 用户年龄限制: >13岁
|
||
- 服务区域限制: 指定国家/地区
|
||
```
|
||
|
||
#### criteria - 适合使用表格表达
|
||
|
||
评价标准最适合使用表格，清晰展示指标和目标值：
|
||
|
||
```
|
||
| 指标 | 目标值 | 最低要求 |
|
||
|-----|-------|---------|
|
||
| 响应时间 | <200ms | <500ms |
|
||
| 成功率 | >99% | >95% |
|
||
| 用户满意度 | >4.5/5 | >4/5 |
|
||
```
|
||
|
||
## 📋 使用示例
|
||
|
||
<execution domain="web" context="server">
|
||
<process>
|
||
# 用户注册流程
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[开始] --> B[验证输入]
|
||
B --> C{输入有效?}
|
||
C -->|是| D[检查用户是否存在]
|
||
C -->|否| E[返回错误信息]
|
||
D --> F{用户存在?}
|
||
F -->|是| G[返回用户已存在]
|
||
F -->|否| H[创建用户]
|
||
H --> I[发送确认邮件]
|
||
I --> J[结束]
|
||
E --> J
|
||
G --> J
|
||
```
|
||
|
||
## 异常处理路径
|
||
1. 数据库连接失败：重试3次，仍失败则返回系统错误
|
||
2. 邮件服务不可用：将邮件加入队列，返回部分成功信息
|
||
3. 输入验证失败：返回具体的字段错误信息
|
||
</process>
|
||
|
||
<guideline>
|
||
# 用户体验建议
|
||
|
||
```mermaid
|
||
mindmap
|
||
root((注册体验))
|
||
表单设计
|
||
字段顺序从简单到复杂
|
||
实时字段验证
|
||
进度指示器
|
||
错误提示
|
||
友好明确的错误信息
|
||
提供修正建议
|
||
流程优化
|
||
最少必填字段
|
||
分步注册可选
|
||
```
|
||
|
||
- 使用渐进式表单，先收集必要信息，成功后再补充其他信息
|
||
- 提供社交媒体快捷注册选项
|
||
- 密码强度视觉指示器
|
||
</guideline>
|
||
|
||
<rule>
|
||
# 必须遵循的规则
|
||
|
||
1. 密码必须至少8个字符，包含大小写字母、数字和特殊字符
|
||
2. 用户邮箱必须通过验证才能激活账户
|
||
3. 敏感个人信息必须加密存储
|
||
4. 用户协议必须显式接受
|
||
5. IP地址和注册时间必须记录日志
|
||
</rule>
|
||
|
||
<constraint>
|
||
# 系统限制条件
|
||
|
||
```mermaid
|
||
graph TD
|
||
A[技术约束] --> B[数据库连接池上限: 100]
|
||
A --> C[API调用频率: 10次/秒]
|
||
D[业务约束] --> E[注册用户年龄: >13岁]
|
||
D --> F[服务区域: 指定国家/地区]
|
||
```
|
||
|
||
- 存储空间限制：用户头像最大2MB
|
||
- 处理时间约束：注册流程必须在3秒内完成
|
||
- 并发限制：同一IP每分钟最多5次注册请求
|
||
</constraint>
|
||
|
||
<criteria>
|
||
# 成功标准
|
||
|
||
| 指标 | 目标值 | 最低要求 |
|
||
|-----|-------|---------|
|
||
| 注册成功率 | >95% | >90% |
|
||
| 平均完成时间 | <60秒 | <90秒 |
|
||
| 邮箱验证率 | >80% | >70% |
|
||
| 表单放弃率 | <20% | <30% |
|
||
|
||
## 质量检查点
|
||
1. 所有必填字段已验证
|
||
2. 用户记录已正确创建
|
||
3. 确认邮件已发送或进入队列
|
||
4. 欢迎信息已显示
|
||
</criteria>
|
||
</execution> |