Skip to content

runtime-flow.md

Latest commit

 

History

History
123 lines (93 loc) · 3.03 KB

runtime-flow.md

File metadata and controls

123 lines (93 loc) · 3.03 KB
Raw

运行时流程

English: Runtime Flow

本地服务启动、模型导入、实体关系写入、Query Service、AgentGateway 和 MCP 的运行路径。

启动

sequenceDiagram
  participant Main as umodel-server
  participant Bootstrap as internal/bootstrap
  participant Workspace as Workspace Store
  participant Graph as GraphStore Provider
  participant HTTP as REST Router

  Main->>Bootstrap: parse flags and build app
  Bootstrap->>Graph: select provider
  Bootstrap->>Workspace: initialize workspace persistence
  Bootstrap->>HTTP: register routes and UI handler
  HTTP-->>Main: listen on address
Loading

运行参数：

Flag 含义
--addr API 监听地址，例如 :8080。
--data 本地数据目录。
--graphstore Provider 名称：memory、file.memory、local.ladybug。

模型导入

sequenceDiagram
  participant Client
  participant API as REST API
  participant UModel as UModel Service
  participant Validator as Schema Validator
  participant Graph as GraphStore

  Client->>API: POST /api/v1/umodel/{workspace}/import
  API->>UModel: import path or pack
  UModel->>Validator: validate elements
  Validator-->>UModel: validation result
  UModel->>Graph: put UModel elements
  Graph-->>UModel: write result
  UModel-->>Client: import result
Loading

内置多域 quickstart 样例通过以下 endpoint 包装同一路径：

POST /api/v1/samples/{workspace}/multi-domain-quickstart:import

Entity 与 Relation 写入

sequenceDiagram
  participant Client
  participant API
  participant Store as EntityStore
  participant Graph as GraphStore

  Client->>API: entities:write or relations:write
  API->>Store: validate workspace and payload
  Store->>Graph: write records
  Graph-->>Store: write result
  Store-->>Client: accepted / failed items
Loading

EntityStore 是写入面；运行时读取统一通过 Query Service。

查询执行

sequenceDiagram
  participant Client
  participant API
  participant Query as Query Service
  participant Planner as Parser and planner
  participant Graph as GraphStore

  Client->>API: POST /api/v1/query/{workspace}/execute
  API->>Query: query request
  Query->>Planner: parse SPL
  Planner-->>Query: source and operators
  Query->>Graph: read model/entity/topology data
  Graph-->>Query: rows
  Query-->>Client: rows and explain metadata
Loading

AgentGateway 与 MCP

AgentGateway 提供安全的 Agent-facing 层：

  • Discovery 列出 tools、resources、next actions。
  • Query tools 执行或解释 SPL。
  • Resources 暴露元数据和模板。
  • 写工具默认关闭，需显式启用。

umodel-mcp 将 MCP clients 接入同一套 AgentGateway 语义。

本地持久化

使用 file.memory 时：

data/graphstore/file-memory/workspaces/<workspace>/
├── umodels.json
├── entities.json
└── relations.json

Workspace 元数据：

data/workspaces.json

存储细节：Storage 与 GraphStore。