Skip to content

📜 制定DPML协议RFC规范 #7

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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions