Skip to content

新增 service-ai:统一 AI 能力服务插件 #999

@hotlong

Description

@hotlong

背景

当前 packages/services 下已经有 service-analytics、service-automation、service-cache、service-i18n 等标准化能力服务插件,均与相应的 contracts 保持一一对应,实现统一的内核插件化框架,并支持 REST/SSE、自注册路由、标准服务名。

但 AI 相关能力现状分散:已有 contracts (IAIService in contracts/ai-service.ts)、数据协议(agent、conversation、model-registry、orchestration、rag-pipeline.zod.ts 等),但缺少一个正式的 AI 服务端插件,导致:

  • 业务/工程层接入 AI(LLM、Tool、Agent)能力没有规范化入口
  • 每个项目容易出现 LLM 直连、会话逻辑散落各处等现象
  • 生态扩展和继承成本高

目标

  • 创建 packages/services/service-ai,实现内核分层的 AI Service 插件:
    • 能够注册为 kernel 'ai' 服务,契合 IAIService contract
    • 支持 REST/SSE 路由自注册(例:/api/v1/ai/conversations、/api/v1/ai/chat 等)
    • 提供标准的 LLM 适配层+会话及 Tool/Agent 编排逻辑
    • 工厂化内聚"ai"上下游相关协议及风格最佳实践

拟议方案

  1. 明确 contract 升级:扩展 IAIService,增加 streamChat、多参数、tool调用协议
  2. 增加 IAIConversationService,专责会话与 Tool/Agent 执行流
  3. 遵循现有 service-* 体系,参考 service-automation、service-analytics 内部结构:
    • adapters/(对接 LLM Provider 层,统一 streaming + Tool 调用)
    • conversation/(多轮会话与消息/上下文持久化)
    • tools/(元数据/业务工具注册、handler 路由)
    • routes/(REST+SSE 路由注册,不侵入 global)
  4. 提供基础内存实现和真实 provider 实现,便于本地测试及扩展
  5. 严格对齐 src/ai/*.zod.ts、contracts 及 DevKernel 全链路接口测试

相关影响

  • 规范所有 AI 能力接入路径,促进行业一流工程标准
  • 为后续所有 Agent、数据智能、RAG、元数据助手等高级功能演进打基础

参考


如无异议,将以此方案推进。

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions