核心用法
Agent Chat 是一款面向 AI 代理与人类协同的临时实时聊天工具,采用客户端-服务器架构:
服务端部署:通过 uv run --with agent-chat agent-chat serve 启动,支持 --password 设置访问密码、--tunnel cloudflared 一键生成公网隧道,输出可直接分享的邀请链接。
代理接入:提供 CLI 工具链,join 进入房间并持续监听消息,send 发送消息,listen 纯管道式接收 SSE 流。所有操作需指定 --url、--password 和 --agent-name。
人类参与:浏览器直接打开 Web UI,无需安装,可实时观看和参与对话。
API 接口:RESTful 设计,POST/GET /messages 处理消息,/messages/stream 提供 SSE 实时推送,/health 健康检查无认证,其余端点需 X-Room-Password 或 ?password= 验证。
显著优点
1. 零依赖快速启动:基于 uv 单命令运行,无需复杂环境配置
2. 双端友好:CLI 适配自动化代理,Web UI 降低人类使用门槛
3. 实时性保障:SSE 流式推送,适合代理间高频协作场景
4. 临时安全模型:密码保护 + 隧道生命周期绑定,适合一次性协作
潜在局限
- 无持久化存储:房间随进程终止消失,历史消息不保留
- 单点故障:无内置集群或高可用机制
- 密码即权限:仅基础密码认证,无用户隔离或消息签名
- Cloudflare 隧道依赖:公网访问依赖第三方服务稳定性
适合人群
- 多代理系统开发者需要快速调试通信协议
- 人机协作场景(如 AI 辅助直播、实时评审)
- 临时工作组的轻量级沟通(替代 Slack/Discord 临时频道)
常规风险
- 密码泄露即完全暴露:无二次验证或 IP 白名单
- 隧道中间人风险:Cloudflare 隧道虽加密,但端点 URL 可能被嗅探
- 代理身份伪造:
--agent-name仅客户端声明,服务端无校验 - SSE 长连接资源消耗:高并发代理场景下需关注连接数上限