本文便开始进入正题，我们先看看项目的整体依赖。

## 1. 项目依赖

Java版本：JDK 17

SpringBoot：4.1.1

AgentScope：2.0.2

Maven：3.9.16

## 2. 创建项目

首先，简简单单先创建一个SpringBoot项目，就不再演示。

<img src="https://developer.qcloudimg.com/http-save/yehe-8160077/e9237226ec05d95ad1432a09efbc5eac.png" alt="image-20260926094707927" style="zoom:50%;" />

添加我们需要的依赖，这里只保留了核心的依赖。

```xml
    <properties>
        <java.version>17</java.version>
        <agentscope.version>2.0.2</agentscope.version>
    </properties>
    <dependencies>
        
        <dependency>
            <groupId>io.agentscope</groupId>
            <artifactId>agentscope-harness</artifactId>
            <version>${agentscope.version}</version>
        </dependency>

        <dependency>
            <groupId>io.agentscope</groupId>
            <artifactId>agentscope-extensions-model-openai</artifactId>
            <version>${agentscope.version}</version>
        </dependency>
    </dependencies>
```

`HarnessAgent` 是推荐的入口，把工作区、长期记忆、会话持久化、子 agent、沙箱等工程能力打包在一个 builder 里；依赖 `agentscope-harness` 会自动把核心 `agentscope-core` 一并拉进来，所以这里直接简单粗暴。

`gentscope-extensions-model-openai`是连接大模型的依赖，AgentScope提供了主流模型的扩展依赖，考虑到我们后期可能使用不同厂商的模型，所以以后统一走openai的模型类型。

AgentScope也为SpringBoot项目提供了各种模型厂家的 starter，我们后期可以动态选择依赖，这里不使用starter。

更多模型依赖插件见：[https://java.agentscope.io/v2/zh/integration/model](https://java.agentscope.io/v2/zh/integration/model)

<img src="https://developer.qcloudimg.com/http-save/yehe-8160077/daf09e3746ec881abdf1fc39f0bdefb7.png" alt="image-20260926095632072" style="zoom: 33%;" />

## 3. 配置大模型

基本每家模型厂商都会有一些免费额度的模型供我们学习使用，我们这里以阿里云百炼演示。

首先登录阿里云百炼平台，没有账号，需要注册账号登录哈。

![image-20260926100522730](https://developer.qcloudimg.com/http-save/yehe-8160077/19ff3a05a5f65d8df1d5efd31f73813e.png)

![image-20260926100715958](https://developer.qcloudimg.com/http-save/yehe-8160077/97161dce28fe6118538c5aebd2812808.png)

关于模型，我们这里主要使用`qwen3.8-flash`大语言模型和`qwen3.7-text-embedding-flash`向量模型(列表的最后面一页)。

当然用完了，咱们就继续切换别的模型。

![image-20260926101109094](https://developer.qcloudimg.com/http-save/yehe-8160077/074c0e46b5f9f0397d1324be2e46f289.png)

API-KEY我们需要选择按量付费，选择OpenAI格式。

模型名称、Base URL、API Key我们后面要用到。

![image-20260926101227313](https://developer.qcloudimg.com/http-save/yehe-8160077/ee660017db5380ecf98fa3091f0ce6ed.png)

## 4. 初体验

需要的东西都创建好了，我们先来体验一下，创建一个最简单的Agent，顺便测试一下上面的账号

```java
package com.maple.agent.core;

import io.agentscope.core.ReActAgent;
import io.agentscope.core.message.Msg;
import io.agentscope.core.message.UserMessage;
import io.agentscope.extensions.model.openai.OpenAIChatModel;

public class ReActAgent_01 {

    public static void main(String[] args) {

        OpenAIChatModel model = OpenAIChatModel.builder()
                .baseUrl("OpenAI的BaseUrl：https://xxx.cn-beijing.maas.aliyuncs.com/compatible-mode/v1")
                .apiKey("API Key：sk-xxx")
                .modelName("qwen3.8-flash")
                .stream(true)
                .build();

        ReActAgent agent = ReActAgent.builder()
                .name("笑小枫的学习助手")
                .model(model)
                .sysPrompt("你是笑小枫的学习助手，可以帮助用户快速学习使用AgentScope开发智能体。")
                .build();

        Msg reply = agent.call(new UserMessage("你好")).block();

        System.out.println(reply.getTextContent());
    }
}
```

![image-20260926102540161](https://developer.qcloudimg.com/http-save/yehe-8160077/bbd4eb31badc856422f0ce9d3e5ac89f.png)

好了，我们第一个 demo 这样就完成了，是不是感觉很简单，其实就是很简单，我们接下来开始一起学习更多的功能吧。

## 5. 后续规划

后续为了更方便贴代码和提交代码，我把配置放到yml配置中。

在`application.yml` 文件添加配置：

```yml
spring:
  profiles:
    active: dev
```

创建一个`application-dev.yml` 

```yml
model:
  open-ai:
    base-url: https://xxx.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    api-key: sk-xxx
    model-name: qwen3.8-flash
```

创建一个`OpenAiModelConfig.java`

```java
package com.maple.agent.config;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Data
@Component
@ConfigurationProperties(prefix = "model.open-ai")
public class OpenAiModelConfig {

    private String baseUrl;
    private String apiKey;
    private String modelName;

}
```

后续贴代码就使用下面这种方法了

```java
public static void main(String[] args) {

        // 为了方便提及代码，不暴露隐私信息，密钥放到application-pro.yml中
        ConfigurableApplicationContext ctx = SpringApplication.run(MapleAgentApplication.class, args);
        OpenAiModelConfig props = ctx.getBean(OpenAiModelConfig.class);

        OpenAIChatModel model = OpenAIChatModel.builder()
                .baseUrl(props.getBaseUrl())
                .apiKey(props.getApiKey())
                .modelName(props.getModelName())
                .stream(true)
                .build();

        ReActAgent agent = ReActAgent.builder()
                .name("笑小枫的学习助手")
                .model(model)
                .sysPrompt("你是笑小枫的学习助手，可以帮助用户快速学习使用AgentScope开发智能体。")
                .build();

        Msg reply = agent.call(new UserMessage("你好")).block();

        System.out.println(reply.getTextContent());
    }
```

## 6. 写在最后

第一篇简单点，讲究一个不全退，喜欢的朋友可以点个关注。

同时计划创建一个智能体学习沟通群，有兴趣的朋友可以评论或私聊，看看人数。

本系列源码[https://gitee.com/hack-feng/maple-agent-demo](https://gitee.com/hack-feng/maple-agent-demo)

本文一览图：

![AI-Agent项目搭建一览图_笑小枫_2160x3840](https://developer.qcloudimg.com/http-save/yehe-8160077/e44c718dffa4eff38f59d6d9b5d6e22c.png)

HarnessAgent 是推荐的入口，把工作区、长期记忆、会话持久化、子 agent、沙箱等工程能力打包在一个 builder 里；依赖 agentscope-harness 会自动把核心 agentscope-core 一并拉进来，所以这里直接简单粗暴。

AgentScope 学习系列 - 01：环境搭建与初体验

编程语言

人工智能

后端

SpringBoot 4.1.1整合AgentScope 2.0.2构建智能体，基于JDK17与Maven，通过阿里云百炼配置Qwen3模型，实现ReActAgent快速调用大模型，支持YAML配置管理，提供完整源码示例，适合Java开发者学习智能体开发。

代码解释

AgentScope

智能体

Agent

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

AgentScope 学习系列 - 01：环境搭建与初体验-腾讯云开发者社区-腾讯云

AgentScope 学习系列 - 01：环境搭建与初体验

AgentScope 学习系列 - 01：环境搭建与初体验

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐