agentinsight-demo

多智能体统一前端演示平台 | Unified multi-agent demo frontend

Next.js 15 + React 19 + Zustand 5 UI for AgentInsight agents. UI-only: renders chat, streams SSE, and manages client state. Business logic stays in backend agents (docbot / researcher).

中文 | English

---

中文

项目简介

agentinsight-demo 是 agentinsight-agents 的统一前端演示平台, 仅承载 UI, 不实现 RAG / LangGraph / 工具编排等后端能力。

项	说明
本地开发端口	3000(npm run dev, 可用 PORT 覆盖)
容器端口	8801(见 Dockerfile / docker-compose.yml)
技术栈	Next.js 15.1 · React 19 · Zustand 5 · next-intl 4 · Tailwind 4
Agent SSOT	lib/agents.config.ts
已集成后端	docbot 8068 · researcher 8066
版本	v0.1.0 Initial Release

核心能力

• 💬 流式聊天 — 消费后端 POST /v1/chat/completions SSE, 展示进度 / 来源 / 工具调用
• 🧭 多智能体切换 — docbot 与 researcher 独立路由与能力面板(features 标志位驱动)
• 📦 docbot 仓库配置 — RepoConfigPanel 对接 /v1/repos
• 🔐 认证双模式 — SELF_HOST=true 跳过登录; 否则对接 AgentInsightService JWT
• 🌍 i18n — /zh · /en(next-intl)

---

快速开始

环境要求

• Node.js ≥20
• npm ≥10
• (可选) Docker ≥24

本地开发

npm ci
copy .env.template .env
npm run dev
# 打开 http://localhost:3000

.env 示例(占位符, 勿提交真实密钥):

NEXT_PUBLIC_DEPLOYMENT_MODE=local
SELF_HOST=true
NEXT_PUBLIC_AUTH_API_BASE=https://agentinsight.goldebridge.com
PORT=8801

NEXT_PUBLIC_DEPLOYMENT_MODE	行为
local(默认模板)	浏览器直连 http://localhost:{agent.port}
server	经 Next.js rewrites 代理 /api/agentinsight-*/*

启动后端(必需)

前端本身不包含智能体逻辑, 请分别启动需要的后端:

# 文档助手
cd ../agentinsight-docbot
docker compose -p agentinsight-docbot up -d --build

# 研究智能体(可选)
cd ../agentinsight-researcher
docker compose -p agentinsight-researcher -f docker-compose.yml up -d --build

容器化前端

docker compose -p agentinsight-demo up -d --build
# 打开 http://localhost:8801

---

目录要点

app/agent/docbot/chat/       # 文档助手聊天
app/agent/researcher/chat/   # 研究智能体聊天
app/api/                     # cookie / config / health / user-info(轻量)
lib/agents.config.ts         # Agent 配置 SSOT
lib/api-client.ts            # 统一后端调用
components/chat/             # 聊天与流式渲染
messages/{zh,en}.json        # i18n

详细架构见 docs/architecture.md 与 AGENTS.md。

---

开发命令

npm run lint
npm run typecheck
npm run test:unit
npm run build

贡献流程见 CONTRIBUTING.md。

---

许可证

MIT · Copyright (c) 2026 AgentInsight

与同仓库其它子项目一致采用 MIT; 若历史副本存在其它许可证声明, 以本文件与根目录 LICENSE 为准统一为 MIT。

---

English

agentinsight-demo is the unified UI-only demo frontend for AgentInsight agents.

Quick start

npm ci
cp .env.template .env
npm run dev   # http://localhost:3000

Docker: docker compose -p agentinsight-demo up -d --build → http://localhost:8801.

Start backends separately (docbot :8068, researcher :8066). Agent metadata lives in lib/agents.config.ts. See docs/architecture.md and AGENTS.md.

Licensed under MIT.