Quick Start

快速开始不是概念页,是开工顺序

如果你现在就要接一个系统,按这里的顺序做,成本最低,返工也最少。先把部署、映射和最小接口跑通,再谈全模块铺开。

开工原则

先做最小链路,再逐步扩能力

  • 先定试点模块,不做全系统幻想。
  • 先吃宿主上下文,再谈 AI 质量。
  • 先把 query / feedback / sync 打通,再扩展媒体网关和多端入口。
  • 先用标准交付物,不要项目一开始就自由发挥。

Execution Path

最短落地路径

先把最关键的工程动作按顺序固定下来,避免项目一开始就发散。

1. 先决定部署方式

优先选独立服务部署。Ziin 自己维护知识、反馈、会话记忆和审计,不直接侵入宿主核心业务库。

2. 建标准库表

执行 MySQL 或 PostgreSQL 标准 SQL。客户不知道该建什么表时,就直接按标准脚本落地,而不是临时口头设计。

3. 做三类映射

把宿主菜单、权限码、知识资产翻译成 Ziin 的标准模型。没有映射,权限感知和步骤生成都会不稳定。

4. 打通三个核心接口

至少联通 query、feedback、sync。这样才能完成问答、学习闭环和宿主上下文同步。

5. 先试点一个模块

不要一上来铺满全系统。先选入库、报销、审批等一个问题密集模块,跑通后再扩展。

By Role

按角色进入

不同人看不同入口,不再让客户、实施和研发在同一堆材料里自己筛。
角色入口

客户 / 甲方负责人

  • 看客户接入门户,确认要准备的资料和项目边界。
  • 下载接入清单、模板和 SQL,不要只停留在概念讨论。
  • 先确定试点模块和权限来源,再安排联调。
角色入口

实施 / 交付团队

  • 先执行标准 SQL,建出可承载知识、反馈、审计的独立库或 schema。
  • 按菜单映射、权限映射、知识导入三份模板推进。
  • 用 schema 和 curl 示例验证每个接口字段是否对齐。
角色入口

研发 / 集成方

  • 按接入指南完成 token、上下文、模式字段和多模态输入封装。
  • 将 Web、App、小程序或宿主智能体接入到统一 query 接口。
  • 用 sync 同步菜单、权限、用户画像,避免问答脱离真实系统。

Readiness Check

接入前先过一遍准备清单

很多项目不是死在接口,而是死在上下文不清、边界不清、资料不齐。
  • 宿主系统是否能稳定提供 userId、tenantId、roleCodes、permissionCodes 和 route。
  • 是否已决定部署方式: 独立数据库、独立 schema,还是宿主库内独立命名空间。
  • 是否已经选定一个试点模块,而不是一开始全系统铺开。
  • 是否已经准备菜单映射、权限映射、知识导入三份模板数据。
  • 是否有项目 owner 负责联调、验收和反馈回流。

Milestone

一个正常试点项目的推进节奏

把节奏说清楚,客户和实施团队才知道什么叫最小可用,什么属于后续扩展。

Day 0

明确试点模块、部署边界、权限上下文与客户交付清单。

Day 1

执行 SQL、落模板、打通 query 与基础 sync。

Day 2

接通 feedback、导入首批知识、开始在真实场景验证命中率。

After Pilot

把有效问答回流为标准知识,扩到第二个模块与第二个入口端。