67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
---
|
||
title: Hermes 编排 Agent + Web 可观测性方案
|
||
date: 2026-04-29
|
||
tags: [Hermes, Agent编排, ttyd, tmux, 可观测性]
|
||
---
|
||
|
||
# Hermes 编排 Agent + Web 可观测性方案
|
||
|
||
## 背景
|
||
|
||
Hermes 作为母 Agent 编排不同的子 Agent（Codex、Claude Code 等），但全部在后台运行，无法直观看到每个 Agent 的实时输出和进度。需要将后台 tmux session 暴露到 Web 前端观察。
|
||
|
||
## 方案：ttyd + tmux
|
||
|
||
**ttyd**（GitHub 31k+ stars）可以把任意终端程序变成 Web 页面，通过 WebSocket 实时推流。
|
||
|
||
### 架构
|
||
|
||
```
|
||
Hermes (编排大脑)
|
||
│
|
||
├─ tmux session codex1 ─── ttyd :8080 ──► http://localhost:8080
|
||
├─ tmux session claude1 ─── ttyd :8081 ──► http://localhost:8081
|
||
└─ tmux session codex2 ─── ttyd :8082 ──► http://localhost:8082
|
||
```
|
||
|
||
### 使用方式
|
||
|
||
```bash
|
||
# 启动 Agent 的 tmux session
|
||
tmux new-session -d -s codex1 -x 140 -y 40
|
||
tmux new-session -d -s claude1 -x 140 -y 40
|
||
|
||
# ttyd 暴露每个 session 到 web
|
||
ttyd -p 8080 tmux attach -t codex1 &
|
||
ttyd -p 8081 tmux attach -t claude1 &
|
||
|
||
# 浏览器打开
|
||
open http://localhost:8080 # 看 Codex
|
||
open http://localhost:8081 # 看 Claude Code
|
||
```
|
||
|
||
### 类似方案
|
||
- **Wetty / Gotty** — 与 ttyd 类似
|
||
- **LangFuse / AgentOps** — 专业 Agent trace 平台，但偏事后日志分析，非实时终端画面
|
||
|
||
### 文件握手通信
|
||
|
||
Agent 之间通过文件交换上下文：
|
||
|
||
```
|
||
/tmp/handoff.json # Codex 输出 → Claude Code 读取
|
||
/tmp/instruction.md # Claude Code 重注入指令 → 拉起新 Codex
|
||
/tmp/next_prompt.txt # 下一步指令
|
||
```
|
||
|
||
## 关键结论
|
||
|
||
1. **不要** 让 Agent 之间直接互相调用（失控）
|
||
2. **要** 用 Hermes 作为中央编排大脑
|
||
3. **用文件作为 Agent 间通信协议**
|
||
4. **ttyd 解决实时观察问题**，浏览器多标签同时查看所有 Agent
|
||
|
||
---
|
||
|
||
*来源：Hermes Agent 对话 (2026-04-29)*
|