多代理协作CBT练习生成系统

Cerina Protocol Foundry是一个多代理协作的后端系统,结合React仪表板,用于草拟、批评和最终确定认知行为治疗(CBT)练习,包含强制人工审批环节。

  • by sachinlathiya
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 sachinlathiya/Cerina-Protocol

使用说明

Cerina协议铸造厂

多代理LangGraph后端+React仪表板,可协同起草、评论和完成CBT练习,并具有强制性的人工批准门。包括MCP服务器暴露、SQLite检查点持久性和Docker化生产设置。

特性

  • 代理循环: 起草人→ 安全卫士→ 临床评论家→ 具有迭代限制和自我纠正的主管。
  • 共享状态“黑板”: 意图、草稿、安全标志、评论指标、注释、日志、先前版本和存储在SQLite检查指针中的时间戳。
  • 循环中的人: 图表停止在 awaiting_human;仪表板允许人类编辑/批准;批准恢复图形以最终确定。
  • MCP工具: create_protocol 向MCP客户端(例如Claude Desktop)公开相同的工作流。
  • 生产就绪: Docker镜像、CORS控件、基于环境的秘密、健康端点和干净的关注点分离。

回购布局

  • backend/ --FastAPI+LangGraph+MCP服务器。
  • frontend/ --React/Vite仪表板用于实时协议审查。
  • docs/architecture.md --代理拓扑图和注释。

快速入门(Docker,类似于生产环境)

cp env.example .env  # set API keys if desired
docker-compose up --build
# frontend: http://localhost:5173
# backend:  http://localhost:8000/health

本地开发(后端)

cd backend
python -m venv .venv
.venv/Scripts/activate  # or source .venv/bin/activate on mac/linux
pip install -r requirements.txt
uvicorn app.api:app --reload --host 0.0.0.0 --port 8000

本地开发(前端)

cd frontend
npm install
npm run dev -- --host --port 5173
# VITE_API_URL defaults to http://localhost:8000

MCP服务器

cd backend
python -m app.mcp_server
# Configure your MCP client to point to this server; tool name: create_protocol

测试

cd backend && pytest

人在循环中流动

  1. 用户在UI中提交意图(POST /api/protocols).
  2. LangGraph运行绘图程序→ 安全→ 批评家→ 主管,检查每一步。
  3. 主管暂停状态 awaiting_human;UI轮询 /api/protocols/{id} 显示草稿+日志。
  4. 人工编辑/批准;UI发送 /approve 或 /feedback.
  5. 图形恢复、运行 finalizer,和标记 done.