Repolode
提交项目
agentscope-ai

agentscope-ai/agentscope-java

一个用于构建长时运行、分布式智能体的 Java 框架，内置事件流、工具权限与沙箱执行。

在 GitHub 查看官网
Star
6,276
Fork
1,575
未关闭 Issue
972
最近提交
21小时前

这是什么？

AgentScope Java 是一个用 Java 构建基于大模型智能体的框架，面向需要长时间运行、服务多用户并能在重启后延续会话的场景。核心是 ReAct 推理与行动循环，上层的 HarnessAgent 在此基础上提供记忆、技能、计划模式和子智能体委派。

框架覆盖了生产环境中常见的运行时需求。工具调用可以被直接允许、暂停等待用户审批或拒绝；统一的事件流可实时输出模型结果、文本增量和工具执行状态。工具可在本地子进程、Docker、Kubernetes 或 E2B 云沙箱中运行，会话状态可持久化到内存、JSON 文件、MySQL、Redis 或 PostgreSQL，滚动发布时对话不会中断。

模型厂商以独立扩展模块提供，包括 DashScope、OpenAI、Anthropic、Gemini 和 Ollama。需要 JDK 17 及以上版本，可通过 Maven Central 引入。

核心功能

  • 01统一事件流，提供多种类型事件用于实时渲染和人工介入。
  • 02工具调用权限分为允许、需审批和拒绝三种状态。
  • 03通过中间件钩子扩展推理与行动循环。
  • 04工具可在本地、Docker、Kubernetes 或 E2B 沙箱中执行。
  • 05会话与记忆可持久化到 Redis、MySQL、PostgreSQL 等存储，支持跨副本恢复。
  • 06通过 agent_spawn 和 agent_send 创建并调度子智能体。

适用场景

  • 需要智能体处理多轮长时任务的 Java 后端服务。
  • 要求对敏感工具调用进行审批与审计的企业应用。
  • 需要会话隔离和沙箱代码执行的多租户 SaaS 系统。
  • 将智能体工作流接入现有 Java 系统并支持滚动发布。

快速上手

  1. 1

    添加 agentscope-harness Maven 依赖（需要 JDK 17+）

  2. 2

    添加模型提供方扩展，例如 DashScope

  3. 3

    设置 DASHSCOPE_API_KEY 并运行 Hello AgentScope 示例

使用前须知

  • 需要 JDK 17 或更高版本。
  • 模型提供方是需要单独添加的扩展模块。
  • 运行 Hello 示例需要 DashScope API 密钥。

收录于专题

多智能体编排框架开源 AI Agent 框架与应用微服务框架与服务基础设施

标签

#agent#llm#java#agent-framework#multi-agent#sandbox#human-in-the-loop#distributed-systems#adk#agentic

常见问题

agentscope-java 是什么？
一个用于构建长时运行、分布式智能体的 Java 框架，内置事件流、工具权限与沙箱执行。 AgentScope Java 是一个用 Java 构建基于大模型智能体的框架，面向需要长时间运行、服务多用户并能在重启后延续会话的场景。核心是 ReAct 推理与行动循环，上层的 HarnessAgent 在此基础上提供记忆、技能、计划模式和子智能体委派。
agentscope-java 可以免费使用吗？用的什么许可证？
agentscope-java 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
agentscope-java 还在维护吗？
活跃维护中。agentscope-java 最近一次提交是在 2026年11月6日。
agentscope-java 适合用来做什么？
需要智能体处理多轮长时任务的 Java 后端服务。 要求对敏感工具调用进行审批与审计的企业应用。 需要会话隔离和沙箱代码执行的多租户 SaaS 系统。 将智能体工作流接入现有 Java 系统并支持滚动发布。
agentscope-java 怎么安装和运行？
添加 agentscope-harness Maven 依赖（需要 JDK 17+） 添加模型提供方扩展，例如 DashScope 设置 DASHSCOPE_API_KEY 并运行 Hello AgentScope 示例
在哪里获取 agentscope-java？
源代码和安装说明在 GitHub 上：https://github.com/agentscope-ai/agentscope-java

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目