目标
制定DPML Protocol的RFC规范文档,建立标准化的协议定义。
背景
DPML (Deepractice Prompt Markup Language) 是用于定义AI应用的声明式标记语言协议。目前已有基础实现(Agent runtime),但缺少正式的协议规范文档。
设计原则
RFC vs W3C 双层设计
根据之前讨论确定的设计策略:
-
RFC层(协议核心):面向实现者
- 语法定义(BNF/ABNF)
- 数据结构规范
- 解析规则
- 可被计算机验证和解析
-
W3C层(使用指南):面向使用者
- 实用示例
- 最佳实践
- 领域扩展(Agent/Task/Role/Workflow)
- 可被AI和人类理解
核心理念
- 声明式优先:像写HTML一样定义AI行为
- 可扩展性:插件系统和领域扩展机制
- 标准化:确保一致性和互操作性
- 低门槛:5分钟上手,无需深入了解AI模型内部
协议范围
1. 核心协议(当前focus)
- XML/HTML-like 标记语法
- 基础元素定义(agent, llm, prompt等)
- 属性系统(api-key, model等)
- 引用机制(@env:, @file:等)
- 验证规则
2. 领域扩展(未来)
- Agent Domain - 对话式AI助手(已实现)
- Task Domain - 状态机任务定义(规划中)
- Role Domain - AI角色人格定义(规划中)
- Workflow Domain - 工作流编排(规划中)
待讨论问题
-
协议命名
- 正式名称确认:DPML Protocol
- 版本策略:如何管理协议版本
-
RFC文档结构
- 采用标准RFC格式还是简化版本
- 章节组织方式
- 示例的详细程度
-
语法规范
- 使用ABNF还是其他形式描述语法
- 标签命名规范
- 属性值类型系统
-
扩展机制
-
与现有实现对齐
- 当前packages/dpml的实现与协议的关系
- 如何保证实现遵循规范
产出物
参考
- RFC 2616 (HTTP/1.1)
- RFC 7946 (GeoJSON)
- HTML5 Specification
- 现有的
/Users/sean/Deepractice/projects/PromptX/packages/resource/resources/protocol/dpml.protocol.md
里程碑
- Phase 1: 协议框架和核心语法定义
- Phase 2: Agent Domain详细规范
- Phase 3: 扩展机制和插件系统规范
- Phase 4: 其他领域规范(Task/Role/Workflow)
协作方式:使用本issue作为RFC讨论和迭代的工作空间
目标
制定DPML Protocol的RFC规范文档,建立标准化的协议定义。
背景
DPML (Deepractice Prompt Markup Language) 是用于定义AI应用的声明式标记语言协议。目前已有基础实现(Agent runtime),但缺少正式的协议规范文档。
设计原则
RFC vs W3C 双层设计
根据之前讨论确定的设计策略:
RFC层(协议核心):面向实现者
W3C层(使用指南):面向使用者
核心理念
协议范围
1. 核心协议(当前focus)
2. 领域扩展(未来)
待讨论问题
协议命名
RFC文档结构
语法规范
扩展机制
与现有实现对齐
产出物
参考
/Users/sean/Deepractice/projects/PromptX/packages/resource/resources/protocol/dpml.protocol.md里程碑
协作方式:使用本issue作为RFC讨论和迭代的工作空间