{"id":49325548,"url":"https://github.com/alibaba/tron-one-agent","last_synced_at":"2026-05-29T21:00:55.806Z","repository":{"id":343664554,"uuid":"1178408474","full_name":"alibaba/tron-one-agent","owner":"alibaba","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-20T12:02:43.000Z","size":7008,"stargazers_count":20,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-20T13:52:43.562Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alibaba.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-11T01:55:11.000Z","updated_at":"2026-05-20T12:02:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alibaba/tron-one-agent","commit_stats":null,"previous_names":["alibaba/tron-one-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alibaba/tron-one-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Ftron-one-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Ftron-one-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Ftron-one-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Ftron-one-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alibaba","download_url":"https://codeload.github.com/alibaba/tron-one-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Ftron-one-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33670211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-26T20:00:31.589Z","updated_at":"2026-05-29T21:00:55.800Z","avatar_url":"https://github.com/alibaba.png","language":"Java","funding_links":[],"categories":["人工智能"],"sub_categories":["AI智能体"],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Tron OneAgent\n\n[![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-black.svg?logo=github)](https://github.com/alibaba/tron-one-agent)\n[![Jdk](https://img.shields.io/badge/JDK-17%2B-green)]()\n[![Node](https://img.shields.io/badge/Node-18%2B-green)]()\n[![License](https://img.shields.io/badge/license-Apache%202.0-red.svg?logo=apache\u0026label=License)](LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/alibaba/tron-one-agent?style=flat\u0026logo=github\u0026color=yellow\u0026label=Stars)](https://github.com/alibaba/tron-one-agent/stargazers)\n[![GitHub Forks](https://img.shields.io/github/forks/alibaba/tron-one-agent?style=flat\u0026logo=github\u0026color=purple\u0026label=Forks)](https://github.com/alibaba/tron-one-agent/network)\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README_en.md\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\n## 简介\n\nTron OneAgent 是一个企业级 AI Agent 高代码开发框架，提供开箱即用的后端服务与前端交互能力，涵盖 Agent 构建的完整流程。\n\n### 核心特性\n\n- **多智能体架构**：面向业务划分的多智能体架构，支持本地与远程子智能体集成\n- **双协议支持**：同时支持 SSE 和 WebSocket 协议，满足不同场景需求，WebSocket 提供更低延迟的实时交互\n- **异步事件驱动**：基于异步事件驱动的交互协议，实现纯异步流式输出\n- **会话级持久化**：按 Agent → User → Session 三层隔离，提供完整的会话生命周期管理\n- **Agent 控制**：支持对话中断（Cancel）功能，用户可随时停止正在执行的 Agent 任务\n- **智能建议**：内置 Follow-up Suggestion 功能，自动为用户生成后续对话建议\n- **动态配置能力**：无需重启服务即可动态调整配置、工具、MCP、知识库、长期记忆和技能\n- **HITL 人机协同**：支持 Human-in-the-Loop 交互模式，可在对话流程中插入人工确认、信息收集等环节\n- **现代化前端**：开箱即用的现代化 UI 界面和丰富的交互组件\n- **多模态支持**：除多模态大模型外，还支持外挂 TTS、ASR 功能\n- **评估框架**：集成 [Dokimos](https://dokimos.dev/) 评估框架，支持 Agent 能力评估与测试\n\nTron OneAgent 基于 [Alibaba AgentScope Java](https://java.agentscope.io/zh/intro.html) 构建，完全兼容其生态能力。\n\n## 为什么选择 Tron OneAgent\n\n- **开箱即用的企业级特性**：开发者无需从零构建智能体，显著降低开发门槛，提升开发效率\n- **灵活的通信协议**：支持 SSE 和 WebSocket 双协议，WebSocket 模式提供更低的延迟和更好的实时性\n- **多 Agent 协作**：支持 ReAct 单 Agent 模式，同时支持本地和远程（A2A 协议）多智能体编排，适用于企业多部门协作的复杂场景\n- **完善的会话状态管理**：提供完整的会话生命周期管理和纯异步流式输出\n- **强大的交互控制**：支持对话中断（Cancel）功能，用户可随时停止 Agent 执行；内置 Follow-up Suggestion 智能推荐后续问题\n- **动态配置与调试**：支持热更新配置，便于开发调试和生产环境应急处理\n- **HITL 人机协同**：支持人工介入交互，适用于需要人工确认、信息收集等场景\n- **丰富的前端交互**：提供开箱即用的现代化 UI 界面和丰富的交互组件\n- **多模态能力**：支持语音交互（TTS/ASR），扩展 Agent 的适用场景\n- **评估与测试**：集成 Dokimos 评估框架，方便进行 Agent 能力评估和持续优化\n\n## 应用场景\n\n- **企业智能助手**：支持多智能体协作、工具调用、知识库检索的企业级 AI 助手\n- **智能客服系统**：支持用户会话隔离、长期记忆、业务系统 API 接入的智能客服解决方案\n\n## 架构\n\n```mermaid\ngraph TB\n  Developer((开发者))\n  subgraph Control[\"Control (Node)\"]\n    Config[动态配置]\n    Debugger[开发调试]\n  end\n\n  subgraph Backend[\"Backend (Java)\"]\n    AgentScope[AgentScope]\n  end\n\n  subgraph Infrastruture\n    Mysql[(MySQL)]\n    OSS[(文件存储)]\n    RAG[(知识库)]\n    LongTermMemory[(长期记忆)]\n    ModelAPI[模型API]\n    McpServer[\"MCP Server\"]\n  end\n\n  RemoteSubAgent[远程子Agent]\n\n  Developer --\u003e Control\n\n  Config --\u003e Backend\n  Debugger --\u003e Backend\n\n  Backend --\u003e Mysql\n  Backend --\u003e OSS\n  Backend --\u003e ModelAPI\n  Backend --\u003e RAG\n  Backend --\u003e LongTermMemory\n  Backend --\u003e McpServer\n  Backend --\u003e RemoteSubAgent\n```\n\n## 技术栈\n\n### 后端技术\n\n| 组件 | 版本 | 说明 |\n|------|------|------|\n| Spring Boot | 3.5.9 | Web 框架 |\n| JDK | 17 | Java 运行环境 |\n| AgentScope | 1.0.11 | AI Agent 框架 |\n| MyBatis-Plus | 3.5.15 | ORM 框架 |\n| MySQL | 5.7+ / 8.0+ | 数据库 |\n| A2A SDK | 0.3.2 | Agent-to-Agent 协议 |\n| 阿里云百炼 SDK | 2.6.2 | 阿里云 AI 服务 |\n\n## 快速开始（本地启动）\n\n### 启动后端服务\n\n```bash\ncd backend_java\n\n# 1. 数据库初始化\nmysql -u root -p -e \"CREATE DATABASE tron_agent_java DEFAULT CHARACTER SET utf8mb4;\"\nmysql -u root -p tron_agent_java \u003c bootstrap/src/main/resources/schema/init.sql\n\n# 2. 配置环境变量\nexport DB_HOST=localhost\nexport DB_PORT=3306\nexport DB_NAME=tron_agent_java\nexport DB_USER=root\nexport DB_PASS=your_password\nexport DASHSCOPE_API_KEY=your_dashscope_api_key\n\n# 以下 OSS 配置为可选，用于支持多模态（图片）文件上传与存储\nexport ALIBABA_CLOUD_ACCESS_KEY_ID=your_access_key_id\nexport ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_access_key_secret\nexport OSS_BUCKET=your_bucket_name\nexport OSS_REGION=cn-hangzhou\nexport OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com\nexport FILE_SERVER_BASE_URL=https://your-domain.com/api/files\n\n# 3. 编译并启动\nmvn clean package -DskipTests\njava -jar bootstrap/target/tron-java-bootstrap-1.0-SNAPSHOT.jar\n```\n\n服务启动后访问：`http://localhost:8080`\n\n### 启动控制台应用\n\n```bash\ncd frontend\n\n# 1. 安装依赖\nyarn install\n\n# 2. 启动控制台\nyarn dev\n```\n\n控制台启动后访问：`http://localhost:4000`\n\n## 文档\n\n| 主题                                                      | 说明                                 |\n| --------------------------------------------------------- | ------------------------------------ |\n| [开发指南](docs/zh/develop_guide.md) | 针对企业特定业务的前后端定制开发 |\n| [部署指南](docs/zh/deploy_guide.md) | 通过虚拟机机或者K8S部署到生产环境 |\n\n## 开源许可\n\n本项目采用 [Apache 2.0 许可证](LICENSE)。\n\n```\nCopyright 2026 the original author or authors.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Ftron-one-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falibaba%2Ftron-one-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Ftron-one-agent/lists"}