nullpointexception-i/agent-sphere

AgentSphere – 由LLM驱动的AI代理编排平台

是什么

• 一个全栈Web应用程序，让您可以运行ReAct风格的AI代理（LLM + 工具）在闭环中：感知 → 规划 → 执行 → 反馈。
• 代理可以调用内置工具、远程MCP服务、用于真实浏览器自动化的Chrome扩展、CLI命令或自定义复合技能。
• 支持多代理编排：父运行可以将子任务委托给子代理，您可以定义具有依赖关系和并行通道的DAG式任务图。

关键能力

功能	作用
LLM ReAct引擎 (SessionRunner)	运行Plan → Act → Observe → Learn循环，具有每次超时、取消和自动上下文压缩。
多代理子运行 (SessionSubRunner)	父运行可以delegate工作给子代理；支持DAG编排、有限重试和结果协调。
模型路由	在OpenAI、DeepSeek、智谱AI、QuickRouter、LiteLLM、OrcaRouter中选择，具有主/备用链和优雅降级。
统一能力层	MCP服务器、内置SPI工具、CLI执行、Chrome扩展浏览器自动化和复合技能都通过单个ToolExecutor调用。
真实浏览器自动化	Manifest-V3 Chrome扩展可以导航、点击、输入、运行JS、拍摄视口/整页截图，并执行像素精确的clickAt。
支持视觉的代理	截图作为视觉观察发送回LLM；代理可以对页面图像进行推理。
聊天中图片	通过/api/v1/files/upload上传图片；它们在聊天UI中显示为缩略图，并传递给支持附件的模型。
多级记忆	持久化运行日志、工具调用记录（JSON压缩）和基于令牌预算的上下文压缩保持对话连贯。
人在环路	LLM可以使用ask_clarification工具暂停；UI让用户在运行恢复前回答、选择或输入。
非阻塞wait工具	将运行置于WAITING状态而不占用线程；定时器或cron稍后唤醒它。
循环预算	每次运行的轮次限制，能够在暂停后继续；模型每轮收到通知，并在接近上限时收到“硬关闭”提示。
OIDC SSO和RBAC	从任何身份提供者进行基于PKCE的登录，即时用户配置，私有资源的行级隔离。
技能中心	用户可以将技能（结构化LLM提示）发布为公共模板；其他人可以安装它们，获得可自动更新的分叉副本。
可嵌入聊天小部件	单个IIFE脚本挂载shadow-DOM小部件，通过REST + SSE与后端通信，使用Bearer令牌认证 – 无需CopilotKit依赖。
能力开放API	外部系统可以调用/api/v1/api/completions和/api/v1/api/tasks，具有细粒度的所有权检查和回调URL。

技术栈

• 后端：Java 21、Spring Boot 3.4、MyBatis-Plus、PostgreSQL 14、Redis 7。
• 前端：React 19、UmiJS 4、Ant Design 6、TypeScript 6。
• 浏览器桥接：使用原生ES模块的Chrome Manifest-V3扩展，使用Chrome调试协议进行截图和executeJS。
• LLM集成：通过模型提供者层抽象；支持OpenAI、DeepSeek、智谱AI、LiteLLM、OrcaRouter和自定义中继站。

典型用例

• Web助手机器人：可以在使用LLM推理的同时浏览、填写表单和抓取数据。
• 企业工作流自动化：结合LLM规划和基于MCP的工具（Jira、GitHub、Slack、数据库）来编排多步骤流程。
• 自定义AI代理：定义分解业务任务的技能（提示模板）；发布供团队成员重用。
• 嵌入式AI聊天：将小部件放在SaaS门户上，为用户提供能够查看页面并对其采取行动的LLM驱动助手。

开始使用

1. 克隆仓库并遵循QUICK_START.md中的快速入门指南（PostgreSQL/Redis的Docker compose、Maven构建、UI的npm install）。
2. 运行后端（./mvnw spring-boot:run）和UI（npm run dev）。
3. 在as.buukle.top打开实时演示，并使用演示账户demo001 / demo001登录，探索UI、多代理聊天和可嵌入小部件。

文档和演示

• 架构图(agentsphere-architecture-v2.png)。
• Bilibili上的UI截图和视频演示（在README中链接）。
• 关于ReAct循环、循环预算处理、技能中心版本控制和Chrome扩展内部的详细设计说明已嵌入README中。

许可证：MIT – 您可以自由修改、自托管或扩展此平台。

---

以上所有信息均直接来自仓库的README；没有推断任何额外功能。