AgentScope Java: 构建 LLM 应用的智能体编程框架

| 中文 |

AgentScope Java 是一个面向智能体（Agent-Oriented）的编程框架，专为构建基于 LLM 的应用程序而设计。它提供了创建智能体所需的一切能力：ReAct 推理、工具调用、记忆管理、多智能体协作等。

核心亮点

🎯 智能体，全面掌控

AgentScope 采用了 ReAct（Reasoning-Acting）范式，使智能体能够自主规划并执行复杂任务。与死板的流程化方法不同，ReAct 智能体可以动态决定使用何种工具以及何时使用，从而实时适应不断变化的需求。

然而，在生产环境中，没有管控的自主性往往是巨大的风险。AgentScope 提供了完善的运行时干预机制：

安全中断 (Safe Interruption) - 在保留完整上下文和工具状态的同时，随时暂停智能体执行，确保无数据丢失地无缝恢复。
优雅取消 (Graceful Cancellation) - 终止运行时间过长或无响应的工具调用，且不会破坏智能体状态，实现快速恢复与任务重定向。
人机交互 (Human-in-the-Loop) - 通过 Hook 系统在推理的任何步骤注入修正、额外上下文或指导，确保人类对关键决策的监督。

🛠️ 内置工具

AgentScope 包含了生产级的工具，能够应对智能体开发中的常见挑战：

PlanNotebook - 一种结构化的任务管理系统，将复杂目标分解为有序、可追踪的步骤。智能体可以创建、修改、暂停和恢复多个并发计划，确保多步工作流的系统化执行。
结构化输出 (Structured Output) - 自带纠错功能的输出解析器，确保响应符合类型安全。当 LLM 输出偏离预期格式时，系统会自动检测错误并引导模型生成有效输出，直接映射到 Java POJO，无需手动解析。
长期记忆 (Long-term Memory) - 支持跨会话的语义搜索功能的持久化存储。支持自动管理、智能体控制记录或混合模式。为企业级部署提供多租户隔离，使智能体能独立为不同用户服务。
RAG (检索增强生成) - 与企业知识库无缝集成。支持自建基于 Embedding 的检索以及阿里巴巴云百炼等托管服务，确保智能体的回答基于权威数据源。

🔌 无缝集成

AgentScope 的设计初衷是与现有企业基础设施无缝集成，无需进行大量改造：

MCP 协议 - 与任何兼容 MCP 的服务器集成，即刻扩展智能体能力。连接日益丰富的 MCP 工具和服务生态（从文件系统、数据库到浏览器和代码解释器），无需编写自定义集成代码。
A2A 协议 - 通过标准的服务发现实现分布式多智能体协作。将智能体能力注册到 Nacos 或类似注册中心，使智能体之间能够像调用微服务一样自然地发现并调用彼此。

🚀 生产级标准

为满足企业级部署需求而构建：

高性能 - 基于 Project Reactor 的响应式架构确保了非阻塞执行。通过 GraalVM 原生镜像编译可实现 200ms 的冷启动时间，使 AgentScope 适用于 Serverless 和自动扩缩容环境。
安全沙箱 (Security Sandbox) - AgentScope Runtime 为不可信的工具代码提供隔离的执行环境。内置 GUI 自动化、文件系统操作和移动设备交互的沙箱，防止对系统资源的未授权访问。
可观测性 - 原生集成 OpenTelemetry，实现整个智能体执行链路的分布式追踪。AgentScope Studio 提供可视化调试、实时监控以及适用于开发和生产环境的全面日志记录。

快速开始

要求： JDK 17+

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope</artifactId>
    <version>1.0.12</version>
</dependency>

ReActAgent agent = ReActAgent.builder()
    .name("Assistant")
    .sysPrompt("You are a helpful AI assistant.")
    .model(DashScopeChatModel.builder()
        .apiKey(System.getenv("DASHSCOPE_API_KEY"))
        .modelName("qwen-max")
        .build())
    .build();

Msg response = agent.call(Msg.builder()
        .textContent("Hello!")
        .build()).block();
System.out.println(response.getTextContent());

更多示例请参考官方文档。

贡献指南

我们欢迎任何形式的贡献！请阅读 CONTRIBUTING.md 了解相关准则。

社区

Discord	钉钉	微信

许可证

Apache License 2.0

agentscope-ai/agentscope-java