Files
social-app/.opencode/skills/ag-ui/modules/drafts.md
T

2.6 KiB

Drafts

作用: 介绍 AG-UI 协议中正在考虑或开发中的提案功能。

源文件: llms-full.txt 行号范围: 3492-3854 (Generative UI), 3860-4105 (Interrupts), 4111-4349 (Meta Events), 4355-4846 (Multimodal)

Drafts 概述 (行 4847-4887):

  • Drafts 状态定义 - Draft/Under Review/Accepted/Implemented/Withdrawn (行 4880-4886)

Generative User Interfaces (行 3492-3854):

  • Summary - 问题陈述与动机 (行 3494-3508)
  • Challenges and Limitations - 工具描述长度、JSON Schema 约束 (行 3515-3531)
  • Detailed Specification:
    • Two-Step Generation Process - 两步生成流程图 (行 3535-3543)
    • Step 1: What to Generate? - generateUserInterface 工具 (行 3545-3596)
    • Step 2: How to Generate? - 次级 LLM 生成实际 UI (行 3598-3612)
  • Implementation Examples:
    • UISchemaGenerator - JSON Schema 输出 (行 3615-3673)
    • ReactFormHookGenerator - React Hook Form 代码生成 (行 3675-3795)
  • Implementation Considerations - SDK 变更 (行 3797-3819)
  • Use Cases - 动态表单、数据可视化、交互式工作流 (行 3821-3838)

Interrupt-Aware Run Lifecycle (行 3860-4105):

  • Summary - 人机协作暂停机制 (行 3862-3875)
  • Updates to RUN_FINISHED Event - outcome, interrupt 字段 (行 3897-3920)
  • Updates to RunAgentInput - resume 字段 (行 3922-3937)
  • Contract Rules (行 3939-3945)
  • Implementation Examples (行 3947-4026)
  • Use Cases - 人类批准、信息收集、策略强制 (行 4028-4051)
  • Implementation Considerations (行 4052-4091)

Meta Events (行 4111-4349):

  • Summary - 独立于 Agent 运行的事件注解 (行 4115-4127)
  • MetaEvent Type - metaType, payload (行 4145-4170)
  • Implementation Examples:
    • User Feedback - thumbs_up, thumbs_down (行 4174-4206)
    • Annotations - note, tag (行 4208-4239)
    • External System Events - analytics, moderation (行 4241-4276)
  • Common Meta Event Types 表 (行 4278-4292)
  • Use Cases (行 4294-4318)

Multimodal Messages (行 4355-4846):

  • Summary - 支持多模态输入消息 (行 4357-4371)
  • Status: Implemented (行 4373-4376)
  • Detailed Specification:
    • Modality Types 表 - text, image, audio, video, document (行 4473-4483)
    • Source Types - InputContentDataSource, InputContentUrlSource (行 4485-4509)
    • Content Part Types - TextInputPart, ImageInputPart, AudioInputPart, VideoInputPart, DocumentInputPart (行 4511-4561)
    • Provider Metadata (行 4562-4571)
  • Implementation Examples (行 4573-4764)
  • Implementation Considerations (行 4766-4798)
  • Use Cases (行 4800-4827)