Thanks to visit codestin.com
Credit goes to github.com

Skip to content

installation.md

Latest commit

 

History

History
253 lines (198 loc) · 12.1 KB

installation.md

File metadata and controls

253 lines (198 loc) · 12.1 KB

安装

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

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

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

要求：JDK 17+

依赖选择

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

All-in-One（推荐）

Maven：

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

Gradle：

implementation 'io.agentscope:agentscope:1.0.12'

默认包含的依赖

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

  • DashScope 模型支持（通义千问系列模型，通过原生 HTTP 调用，无需额外 SDK）
  • MCP SDK（模型上下文协议）
  • Reactor Core、Jackson、SLF4J（基础框架）

额外功能的依赖

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

功能 依赖 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

示例：用 OpenAI 模型

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

示例：用 Qdrant RAG + PDF 处理

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

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>

Core + 扩展

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

Maven：

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

Gradle：

implementation 'io.agentscope:agentscope-core:1.0.12'

扩展模块

长期记忆

模块 功能 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

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

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

多智能体协作

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

调度

模块 功能 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
agentscope-extensions-scheduler-quartz Quartz 调度 io.agentscope:agentscope-extensions-scheduler-quartz

用户界面

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

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

示例：Core + Mem0 扩展

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

框架集成

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

Quarkus

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

Micronaut

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