跳到主要内容

🚀 快速开始

本指南将帮助您快速上手 Wegent 平台。

📋 前置要求​

在开始之前，请确保您的系统已安装：

  • Docker 和 Docker Compose

⚡ 一键启动​

curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash

然后在浏览器中访问 http://localhost:3000

标准模式（docker compose）会随 Backend 一起启动知识库检索服务（Knowledge Runtime）。可选：需要内置 Elasticsearch 存储时执行 docker compose --profile rag up -d

📦 预置智能体​

团队用途
chat-team通用 AI 助手 + Mermaid 图表
translator多语言翻译
dev-teamGit 工作流：分支 → 编码 → 提交 → PR
code-wiki-team代码库 Wiki 文档生成（前端需开启 RUNTIME_ENABLE_CODE_WIKI）

🏗️ 架构​

Frontend (Next.js) → Backend (FastAPI) → Executor Manager → Executors (ClaudeCode/Dify/Chat)

核心概念：

  • Ghost (提示词) + Shell (执行环境) + Model = Bot
  • 多个 Bot + 协作模式 = Team

📖 下一步​

现在您已经成功启动了 Wegent！接下来可以：

📚 深入学习​

🎨 创建自定义智能体​

💻 开发与扩展​

🔧 常见问题​

服务启动失败？​

# 查看服务日志
docker compose logs -f

# 重启服务
docker compose restart

无法访问 Web 界面？​

  • 确保端口 3000 未被占用
  • 检查 Docker 容器是否正常运行：docker compose ps

API 连接失败？​

  • 确保后端服务正常运行
  • 访问 http://localhost:8000/api/docs 检查 API 状态

📞 获取帮助​

祝您使用愉快！🎉