AgentScope Java 入门：如何安装 AgentScope

AgentScope Java 支持多种模型、RAG 后端和扩展功能，各自需要不同的第三方 SDK。把所有依赖打包到一起会让项目变得臃肿，所以我们提供了两种引入方式：

• All-in-one：一个依赖搞定，默认带 DashScope SDK 和 MCP SDK，快速上手
• Core + 扩展：最小化核心包，按需加扩展模块，适合对依赖有严格要求的场景

方式	适用场景	特点
all-in-one	快速开始、大多数用户	单一依赖，默认带 DashScope SDK
core + 扩展	精细控制依赖	按需引入，依赖最小化

大多数情况下用 all-in-one 就够了，需要精细控制依赖时再换成 core + 扩展。

要求：JDK 17+

---

1. All-in-One

默认推荐使用 All-in-one 方式，大多数情况下用 all-in-one 一个依赖就可以搞定：

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

1.1 默认包含的依赖

All-in-one 包默认带以下依赖，不用额外配置：

• DashScope SDK（通义千问系列模型）
• MCP SDK（模型上下文协议）
• Reactor Core、Jackson、SLF4J（基础框架）

1.2 额外功能的依赖

用其他模型或功能时，需要手动加对应依赖：

功能	依赖	Maven 坐标
OpenAI 模型	OpenAI Java SDK	com.openai:openai-java
Google Gemini 模型	Google GenAI SDK	com.google.genai:google-genai
Anthropic 模型	Anthropic Java SDK	com.anthropic:anthropic-java
Mem0 长期记忆	OkHttp	com.squareup.okhttp3:okhttp
ReME 长期记忆	OkHttp	com.squareup.okhttp3:okhttp
百炼 RAG	百炼 SDK	com.aliyun:bailian20231229
Qdrant RAG	Qdrant Client	io.qdrant:client
PgVector RAG	PostgreSQL Driver + pgvector	org.postgresql:postgresql + com.pgvector:pgvector
Dify RAG	OkHttp	com.squareup.okhttp3:okhttp
RAGFlow RAG	OkHttp	com.squareup.okhttp3:okhttp
HayStack RAG	OkHttp	com.squareup.okhttp3:okhttp
Elasticsearch RAG	Elasticsearch Java Client	co.elastic.clients:elasticsearch-java
MySQL Session	MySQL Connector	com.mysql:mysql-connector-j
Redis Session	Jedis	redis.clients:jedis
PDF 处理	Apache PDFBox	org.apache.pdfbox:pdfbox
Word 处理	Apache POI	org.apache.poi:poi-ooxml
文档 处理	Apache Tika Core + Apache Tika Parsers	org.apache.tika:tika-core + org.apache.tika:tika-parsers-standard-package
Nacos注册中心	Nacos Client	com.alibaba.nacos:nacos-client

1.2.1 示例：用 OpenAI 模型

<!-- 在 agentscope 基础上加 -->
<dependency>
    <groupId>com.openai</groupId>
    <artifactId>openai-java</artifactId>
</dependency>

1.2.2 示例：用 Qdrant RAG + PDF 处理

<!-- 在 agentscope 基础上加 -->
<dependency>
    <groupId>io.qdrant</groupId>
    <artifactId>client</artifactId>
</dependency>
<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
</dependency>

1.3 Studio 集成

接入 AgentScope Studio 做可视化调试，需要加这些依赖：

依赖	Maven 坐标
OkHttp	com.squareup.okhttp3:okhttp
Socket.IO Client	io.socket:socket.io-client
OpenTelemetry API	io.opentelemetry:opentelemetry-api
OpenTelemetry OTLP Exporter	io.opentelemetry:opentelemetry-exporter-otlp
OpenTelemetry Reactor	io.opentelemetry.instrumentation:opentelemetry-reactor-3.1

完整配置：

<!-- 在 agentscope 基础上加 -->
<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
</dependency>
<dependency>
    <groupId>io.socket</groupId>
    <artifactId>socket.io-client</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-api</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-exporter-otlp</artifactId>
</dependency>
<dependency>
    <groupId>io.opentelemetry.instrumentation</groupId>
    <artifactId>opentelemetry-reactor-3.1</artifactId>
</dependency>

---

2. Core + 扩展

如果需要精细控制依赖时，用 agentscope-core 配合扩展模块：

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

2.1 扩展模块

2.1.1 长期记忆

模块	功能	Maven 坐标
agentscope-extensions-mem0	Mem0 长期记忆	io.agentscope:agentscope-extensions-mem0
agentscope-extensions-reme	ReME 长期记忆	io.agentscope:agentscope-extensions-reme
agentscope-extensions-autocontext-memory	AutoContext 记忆	io.agentscope:agentscope-extensions-autocontext-memory

2.1.2 RAG

模块	功能	Maven 坐标
agentscope-extensions-rag-bailian	百炼 RAG	io.agentscope:agentscope-extensions-rag-bailian
agentscope-extensions-rag-simple	简单 RAG (Qdrant, Milvus, PgVector, 内存存储, Elasticsearch)	io.agentscope:agentscope-extensions-rag-simple
agentscope-extensions-rag-dify	Dify RAG	io.agentscope:agentscope-extensions-rag-dify
agentscope-extensions-rag-ragflow	RAGFlow RAG	io.agentscope:agentscope-extensions-rag-ragflow
agentscope-extensions-rag-haystack	HayStack RAG	io.agentscope:agentscope-extensions-rag-haystack

2.1.3 Session 存储

模块	功能	Maven 坐标
agentscope-extensions-session-mysql	MySQL Session	io.agentscope:agentscope-extensions-session-mysql
agentscope-extensions-session-redis	Redis Session	io.agentscope:agentscope-extensions-session-redis

2.1.4 多智能体协作

模块	功能	Maven 坐标
agentscope-extensions-a2a-client	A2A 客户端	io.agentscope:agentscope-extensions-a2a-client
agentscope-extensions-a2a-server	A2A 服务端	io.agentscope:agentscope-extensions-a2a-server

2.1.5 调度

模块	功能	Maven 坐标
agentscope-extensions-scheduler-common	调度通用模块	io.agentscope:agentscope-extensions-scheduler-common
agentscope-extensions-scheduler-xxl-job	XXL-Job 调度	io.agentscope:agentscope-extensions-scheduler-xxl-job

2.1.6 用户界面

模块	功能	Maven 坐标
agentscope-extensions-studio	Studio 集成	io.agentscope:agentscope-extensions-studio
agentscope-extensions-agui	AG-UI 协议	io.agentscope:agentscope-extensions-agui

扩展模块会自动带上所需的第三方依赖，不用手动加。

2.2 示例

Core + Mem0 扩展：

<!-- 在 agentscope-core 基础上加 -->
<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-extensions-mem0</artifactId>
    <version>1.0.12</version>
</dependency>

3. 框架集成

3.1 Spring Boot

如果与 Spring Boot 集成：

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-spring-boot-starter</artifactId>
    <version>1.0.12</version>
</dependency>

其他 Starter：

Starter	功能	Maven 坐标
agentscope-a2a-spring-boot-starter	A2A 集成	io.agentscope:agentscope-a2a-spring-boot-starter
agentscope-agui-spring-boot-starter	AG-UI 集成	io.agentscope:agentscope-agui-spring-boot-starter
agentscope-chat-completions-web-starter	Chat Completions Web 集成	io.agentscope:agentscope-chat-completions-web-starter
agentscope-nacos-spring-boot-starter	Nacos 集成	io.agentscope:agentscope-nacos-spring-boot-starter

3.2 Quarkus

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-quarkus-extension</artifactId>
    <version>1.0.12</version>
</dependency>

3.3 Micronaut

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-micronaut-extension</artifactId>
    <version>1.0.12</version>
</dependency>