Skip to content

Repository files navigation

DeepTicket 品牌 Banner

English · 更新日志 · v0.3.1 · MIT

Python 3.11+ release OpenHands Docker

业务组自托管的 Agent 编排层

让一线先查证据,再决定要不要升级研发

跑在 OpenHands 上 · 接 Git / 日志 / 配置 / MCP · 也能接工单和告警 · 不替代公司 Copilot

简介 · 演示 · 特性 · 典型场景 · 快速开始 · 文档


简介

DeepTicket 是业务组自己部署的 Agent 编排层:把 Git 知识库、内网日志与配置、MCP 工具、工单/告警接到同一工作台,在 OpenHands 上跑多轮排查。

它解决的不是「多聊几句」,而是 一线关单前能查到依据——源码路径、日志行、配置项——而不是只检索几段文档。研发继续用 Copilot;业务组通常 Docker 起一套小的,先在小范围试。


演示

_2026-08-19_00-07-35_5mb.mp4

ad-agent ROI 归因 Demo · 查日志 等功能需真实接入mcp或skill后生效 部分ui为突出展示与实际项目样式不一致


特性

接得进

  • 多项目 — 侧栏切换,每项目独立 repos、MCP、agents.md
  • Ingress — 工单/告警 HTTP 进来,后台异步分析
  • 按项目配 MCP — 查配置、查发布、接内网文档,各管各的

查得到

  • Git 同步 — 代码进 workspace,Agent 能翻源码
  • 日志 / 配置 — Skill 模板或 MCP,接你们已有平台
  • 回答带证据 — 路径、片段、配置键;agents.md 约束只读与依据优先

回得去

  • Webhook 写回 — 分析结论回工单/ITSM,写哪里项目里配
  • 人机分工 — 能对上先关单;对不上再 @ 研发,少截图来回
  • yaml + 侧栏 — 配置可版本管理,也可运行时改

亮点

证据优先,不空聊

DeepTicket 默认让 Agent 在 workspace 里找依据再下结论,而不是堆通用建议。项目级 agents.md 写清楚:只读、引用路径、不确定就标注。

一线要的是「能不能关单」;研发要的是「升级时带上下文」——中间这层就是 DeepTicket 干的事。


和纯 RAG / 公司 Copilot 的区别

帮你归类:你要的是「灌库问答」、公司统一 Copilot,还是「业务组自己接内网、能写回工单」?

纯 RAG 平台 Copilot DeepTicket
读 Git 源码 片段 有限
内网日志 / 配置 灌库 ✅ MCP / Skill
工单 / 告警回写 ✅ Ingress
业务组自己部署 看情况 等平台 ✅ Docker / yaml

和 OpenHands:OpenHands 跑 Agent 引擎;DeepTicket 是外面的工作台、知识库同步与工单接入。


典型场景

产品 / 运营 / QA

日志、配置接好,再挂几个 MCP,就可以给非研发开账号。常见问法:「这是 bug 吗?」「和设计一致吗?」「文档写的和线上为什么不一样?」

回答里会带上日志片段、配置项、代码位置,自己能对上就先关单;对不上再 @ 研发。

报表、指标

接了报表或 BI 的 MCP 之后,可以问跨表问题,比如活动 ROI 和日报对不上。人先让机器跑一轮关联,再看最后几条要不要信。

垂类例子见 ad_agent(投放 ROI);DeepTicket 本身只管接线和多项目配置。

工单、告警

内部工单或报警平台 HTTP 打进来,后台异步分析,结论用 Webhook 写回去。值班先看一眼机器总结,再决定要不要升级叫人。


快速开始

打开 http://127.0.0.1:8600 · 默认 admin / admin · LLM Key 可在侧栏 LLM 配置 填写

🐳 Docker(远程镜像,推荐)
mkdir deepticket && cd deepticket
curl -LO https://raw.githubusercontent.com/shanananana/deepticket/main/docker-compose.image.yml
curl -LO https://raw.githubusercontent.com/shanananana/deepticket/main/.env.docker.example
cp .env.docker.example .env
docker compose -f docker-compose.image.yml up -d

ghcr.io/shanananana/deepticket:v0.3.1 · 详见 docs/docker.md

📦 Clone(开发调试)
git clone https://github.com/shanananana/deepticket.git
cd deepticket
bash scripts/setup.sh
bash scripts/start_all.sh

体验:粘贴 DEMO_PROMPT 里的 Nginx 日志 · 录屏 quickstart-demo

停止:docker compose down · 日志:docker compose logs -f deepticket · 自检:bash scripts/verify.sh


架构

五层架构


文档

文档 说明
docs/docker.md Docker 部署、GHCR 镜像、持久化配置
docs/DEMO_PROMPT.md 复制即用的示例提问(Nginx 日志等)
docs/quickstart-demo.md 录屏 demo 与 ROI 场景说明
deepticket.example.yaml 统一配置模板(复制为 deepticket.yaml)
CONTRIBUTING.md 本地开发、测试、贡献指南
CHANGELOG.md 版本更新记录

多项目、MCP、Ingress、agents.md 可在工作台侧栏配置,或通过管理员 API:/api/admin/projects/{id}


常见问题

最少要有什么? LLM Key;Git 仓库可选;日志、配置 MCP 用到再接。

和公司 Copilot? 不冲突,一般是业务组自己起一套小的。

项目阶段? Alpha(当前 v0.3.1),欢迎 Star 和 Issue。

本地开发:pip install -e ".[dev]" · pytest -q · bash scripts/verify.sh --online


⭐ 有帮助请 Star · MIT

About

面向业务组的自托管 SRE 编排层:串联 MCP、日志、配置、ITSM,与平台 Agent 并存 · 内网部署 · 薄编排 · on-call

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages