Skip to content

📜 制定DPML协议RFC规范 #7

@deepracticexs

Description

@deepracticexs

目标

制定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 - 工作流编排(规划中)

待讨论问题

  1. 协议命名

    • 正式名称确认:DPML Protocol
    • 版本策略:如何管理协议版本
  2. RFC文档结构

    • 采用标准RFC格式还是简化版本
    • 章节组织方式
    • 示例的详细程度
  3. 语法规范

    • 使用ABNF还是其他形式描述语法
    • 标签命名规范
    • 属性值类型系统
  4. 扩展机制

    • 如何定义自定义标签
    • 插件系统规范
    • 命名空间策略
  5. 与现有实现对齐

    • 当前packages/dpml的实现与协议的关系
    • 如何保证实现遵循规范

产出物

  • DPML Protocol RFC 文档(英文)
  • 协议概述页面(中英文,网站用)
  • 核心规范页面(中英文,网站用)
  • BNF/ABNF 语法定义
  • 验证规则文档

参考

  • RFC 2616 (HTTP/1.1)
  • RFC 7946 (GeoJSON)
  • HTML5 Specification
  • 现有的 /Users/sean/Deepractice/projects/PromptX/packages/resource/resources/protocol/dpml.protocol.md

里程碑

  1. Phase 1: 协议框架和核心语法定义
  2. Phase 2: Agent Domain详细规范
  3. Phase 3: 扩展机制和插件系统规范
  4. Phase 4: 其他领域规范(Task/Role/Workflow)

协作方式:使用本issue作为RFC讨论和迭代的工作空间

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions