代理编排工作区

代理编排器工作区

此工作区结合了 前端编排器UI （根据 agent-orchestrator-main)与 FastAPI后端编排器 （根据 agent-orchestrator).这两个堆栈彼此共存，因此您可以在表面和路由引擎上迭代，而无需在存储库之间跳转。

前端堆栈(agent-orchestrator-main)

• Next.js+顺风UI：React表面在中呈现具有可组合原语的查询编排控件、功能标志和服务器管理卡 components/ui.
• 与v0自动同步：仓库反映了从v0.app聊天推送的更改，每次提交都会触发Vercel部署，因此UI保持同步。
• 开发工作流程:
  1. cd agent-orchestrator-main
  2. pnpm install
  3. pnpm dev → http://localhost:3000
  4. pnpm build / pnpm lint 在发布之前。

后端堆栈(agent-orchestrator)

• FastAPI编排器API: main.py 暴露 /api/route, /api/execute, /api/servers，以及 /api/admin/register-server 管理MCP服务器路由和执行决策。
• 路由+注册表模块: routing.py 选择哪些MCP服务器处理查询 registry.py 保留服务器清单+运行状况元数据。
• 从本地开始:
  1. cd agent-orchestrator
  2. python -m venv venv （或 venv_windows 在PowerShell上）
  3. venv\\Scripts\\Activate.ps1 / source venv/bin/activate
  4. pip install -r requirements.txt
  5. uvicorn main:app --reload

部署

• 前端: https://vercel.com/sentilabs/v0-agent-orchestrator-frontend
• 后端：在本地运行或容器化FastAPI应用程序（使用 start-server.ps1 使用正确的virtualenv启动）。

保持两者同步

1. 在您正在更改的仓库内工作(agent-orchestrator-main 对于UI， agent-orchestrator 用于后端路由）。
2. 提交并推送到同一个遥控器 git push agent-orchestrator main 从父文件夹更新两侧。
3. 重新运行 git pull agent-orchestrator main --allow-unrelated-histories 如果你见过不同的历史。

问题？只需问：这个工作区混合了两个堆栈，但推送到了同一个GitHub远程(mcpmessenger/agent-orchestrator)所以你总是降落在正确的地方。