返回项目档案
FULL-STACK AGENT PLATFORMPRODUCT ENGINEERINGMINIH / AGENT OS

miniH.

把 Agent 从原型带到可运营:模型与工具配置、可视化工作流、知识库 RAG、记忆管理、版本发布、API 调用和效果评测,串成一条完整交付链。

01
BUILD / Agent Studio
02
CONNECT / RAG + Memory
03
PUBLISH / Immutable Version
04
MEASURE / Evaluation
miniH Agent Platform 控制台的 Agent Studio、工作流和知识库界面设计
AGENT OS / STUDIO · WORKFLOW · KNOWLEDGE · EVALUATIONONE CONSOLE, FULL LIFECYCLE

01 / PRODUCT THESIS

Agent 不只是一次
模型调用。

miniH 面向「峡谷寻城记」等 Agent 应用的工程化落地,把模型、工具、流程、知识、记忆和发布运行放到同一套管理平台。目标不是堆功能入口,而是让配置变化能追溯、调用能授权、知识导入能异步恢复、效果能通过基线评测持续验证。

产品覆盖 Agent Studio、工作流、知识库、记忆、运行记录、API 与发布、评测与安全等工作区,兼顾构建者的管理体验与外部系统的稳定调用。

02 / END-TO-END FLOW

配置、发布、运行、验证

从后台控制台到线上 API,每一个阶段都留下版本、状态或指标。

  1. 01

    配置 Agent

    在 Studio 管理模型参数、系统指令、工具访问方式、知识库与记忆;通过节点运行日志定位每次执行。

  2. 02

    编排工作流

    使用可视化节点组织 Start、Tool、LLM 等步骤,保存草稿并创建可追踪的工作流版本。

  3. 03

    构建知识与记忆

    上传 PDF / DOCX / TXT / Markdown,后台解析、清洗、切块、Embedding 并写入 pgvector;会话记忆支持检索与生命周期管理。

  4. 04

    发布不可变版本

    从草稿发布固定版本,通过 API Key 调用发布版 Agent;密钥仅在创建时展示明文,数据库保存 SHA-256 哈希。

  5. 05

    观测并迭代

    SSE 返回流式结果;Redis 固定窗口限流。评测批次汇总成功率、RAG 命中、引用与工具调用正确率、Token 和 P95 延迟。

03 / SYSTEM DESIGN

让每个环节都可追踪

01 / ENGINEERING

内容摄取不阻塞请求

上传先进入 Storage 抽象,再由 Redis 任务队列交给独立 Worker。任务状态、幂等处理与失败恢复让大型文档导入可追踪、可重试。

02 / ENGINEERING

开发环境与生产边界清楚

本地用文件存储跑通解析链路;生产可替换 COS / CloudBase Storage。API、Worker、PostgreSQL、Redis 与 Nginx 分层部署。

03 / ENGINEERING

从“能回答”走向“可验证”

20 条固定基线题覆盖知识问答、无依据拒答、工具失败、提示注入和越权场景;记录逐题节点日志、Token 与延迟,支持失败定位。

PERSISTENCE

PostgreSQL 保存 Agent、会话、文档、版本和评测数据;pgvector 支持语义检索。

ASYNC RELIABILITY

Redis 队列解耦文档处理;任务状态、幂等键与 Worker 生命周期让导入进度可观察。

RELEASE SAFETY

不可变 Agent 版本与哈希存储的 API Key 分离草稿配置和线上运行身份。

04 / TECHNOLOGY MAP

全栈技术地图

围绕 Agent 运行链路选择组件:交互式编排、异步知识处理与可靠发布各自承担清晰职责。

Web 控制台
React · Vite · @xyflow/react · Lucide
API 与数据层
Python 3.13 · FastAPI · Pydantic 2 · SQLAlchemy 2 · asyncpg · Alembic · Uvicorn
Agent Runtime
LangGraph · LangChain Core · OpenAI-compatible Provider · 腾讯混元
检索与异步任务
PostgreSQL · pgvector · Redis · Worker · Embedding · pypdf · python-docx
运行与交付
Docker Compose · Nginx · GitHub Actions · SSE

05 / MEASURE WHAT SHIPS

上线后,质量有迹可循。

内置 20 条固定评测基线,覆盖知识问答、引用、工具调用、失败恢复、提示注入与越权请求。每次运行记录答案、节点日志、Token 与延迟,并聚合成功率、RAG 命中率、引用准确率、工具调用正确率和 P95。