Files
PromptX/protocol/base/execution.protocol.md

6.9 KiB
Raw Blame History

execution 应用协议

TL;DR: execution标签用于定义结构化的执行框架帮助AI系统完成任务包含流程(Process)、指导原则(Guideline)、强制规则(Rule)、约束条件(Constraint)和评价标准(Criteria)五个核心子概念。

🔍 基本信息

标签名: <execution> 版本: 1.0.0 类别: 执行 状态: 草稿 创建日期: 2023-06-21

目的与功能

execution标签定义了AI系统执行任务的完整框架它的主要功能是

  • 提供执行任务的结构化定义
  • 明确执行的流程步骤、指导原则、规则、约束和评价标准
  • 帮助AI系统进行精确、可靠的任务执行
  • 提供执行状态追踪和错误处理机制

📝 语法定义

(* 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 - 适合使用图形表达

流程是最适合使用图形表达的元素,推荐使用流程图或时序图:

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 |

📋 使用示例

# 用户注册流程
```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. 输入验证失败:返回具体的字段错误信息
# 用户体验建议
```mermaid
mindmap
  root((注册体验))
    表单设计
      字段顺序从简单到复杂
      实时字段验证
      进度指示器
    错误提示
      友好明确的错误信息
      提供修正建议
    流程优化
      最少必填字段
      分步注册可选
```

- 使用渐进式表单,先收集必要信息,成功后再补充其他信息
- 提供社交媒体快捷注册选项
- 密码强度视觉指示器
# 必须遵循的规则
1. 密码必须至少8个字符包含大小写字母、数字和特殊字符
2. 用户邮箱必须通过验证才能激活账户
3. 敏感个人信息必须加密存储
4. 用户协议必须显式接受
5. IP地址和注册时间必须记录日志
# 系统限制条件
```mermaid
graph TD
  A[技术约束] --> B[数据库连接池上限: 100]
  A --> C[API调用频率: 10次/秒]
  D[业务约束] --> E[注册用户年龄: >13岁]
  D --> F[服务区域: 指定国家/地区]
```

- 存储空间限制用户头像最大2MB
- 处理时间约束注册流程必须在3秒内完成
- 并发限制同一IP每分钟最多5次注册请求
# 成功标准
| 指标 | 目标值 | 最低要求 |
|-----|-------|---------|
| 注册成功率 | >95% | >90% |
| 平均完成时间 | <60秒 | <90秒 |
| 邮箱验证率 | >80% | >70% |
| 表单放弃率 | <20% | <30% |

## 质量检查点
1. 所有必填字段已验证
2. 用户记录已正确创建
3. 确认邮件已发送或进入队列
4. 欢迎信息已显示