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

本文便开始进入正题我们先看看项目的整体依赖。1. 项目依赖Java版本JDK 17SpringBoot4.1.1AgentScope2.0.2Maven3.9.162. 创建项目首先简简单单先创建一个SpringBoot项目就不再演示。添加我们需要的依赖这里只保留了核心的依赖。propertiesjava.version17/java.versionagentscope.version2.0.2/agentscope.version/propertiesdependenciesdependencygroupIdio.agentscope/groupIdartifactIdagentscope-harness/artifactIdversion${agentscope.version}/version/dependencydependencygroupIdio.agentscope/groupIdartifactIdagentscope-extensions-model-openai/artifactIdversion${agentscope.version}/version/dependency/dependenciesHarnessAgent是推荐的入口把工作区、长期记忆、会话持久化、子 agent、沙箱等工程能力打包在一个 builder 里依赖agentscope-harness会自动把核心agentscope-core一并拉进来所以这里直接简单粗暴。gentscope-extensions-model-openai是连接大模型的依赖AgentScope提供了主流模型的扩展依赖考虑到我们后期可能使用不同厂商的模型所以以后统一走openai的模型类型。AgentScope也为SpringBoot项目提供了各种模型厂家的 starter我们后期可以动态选择依赖这里不使用starter。更多模型依赖插件见https://java.agentscope.io/v2/zh/integration/model3. 配置大模型基本每家模型厂商都会有一些免费额度的模型供我们学习使用我们这里以阿里云百炼演示。首先登录阿里云百炼平台没有账号需要注册账号登录哈。关于模型我们这里主要使用qwen3.8-flash大语言模型和qwen3.7-text-embedding-flash向量模型(列表的最后面一页)。当然用完了咱们就继续切换别的模型。API-KEY我们需要选择按量付费选择OpenAI格式。模型名称、Base URL、API Key我们后面要用到。4. 初体验需要的东西都创建好了我们先来体验一下创建一个最简单的Agent顺便测试一下上面的账号packagecom.maple.agent.core;importio.agentscope.core.ReActAgent;importio.agentscope.core.message.Msg;importio.agentscope.core.message.UserMessage;importio.agentscope.extensions.model.openai.OpenAIChatModel;publicclassReActAgent_01{publicstaticvoidmain(String[]args){OpenAIChatModelmodelOpenAIChatModel.builder().baseUrl(OpenAI的BaseUrlhttps://xxx.cn-beijing.maas.aliyuncs.com/compatible-mode/v1).apiKey(API Keysk-xxx).modelName(qwen3.8-flash).stream(true).build();ReActAgentagentReActAgent.builder().name(笑小枫的学习助手).model(model).sysPrompt(你是笑小枫的学习助手可以帮助用户快速学习使用AgentScope开发智能体。).build();Msgreplyagent.call(newUserMessage(你好)).block();System.out.println(reply.getTextContent());}}好了我们第一个 demo 这样就完成了是不是感觉很简单其实就是很简单我们接下来开始一起学习更多的功能吧。5. 后续规划后续为了更方便贴代码和提交代码我把配置放到yml配置中。在application.yml文件添加配置spring:profiles:active:dev创建一个application-dev.ymlmodel:open-ai:base-url:https://xxx.cn-beijing.maas.aliyuncs.com/compatible-mode/v1api-key:sk-xxxmodel-name:qwen3.8-flash创建一个OpenAiModelConfig.javapackagecom.maple.agent.config;importlombok.Data;importorg.springframework.boot.context.properties.ConfigurationProperties;importorg.springframework.stereotype.Component;DataComponentConfigurationProperties(prefixmodel.open-ai)publicclassOpenAiModelConfig{privateStringbaseUrl;privateStringapiKey;privateStringmodelName;}后续贴代码就使用下面这种方法了publicstaticvoidmain(String[]args){// 为了方便提及代码不暴露隐私信息密钥放到application-pro.yml中ConfigurableApplicationContextctxSpringApplication.run(MapleAgentApplication.class,args);OpenAiModelConfigpropsctx.getBean(OpenAiModelConfig.class);OpenAIChatModelmodelOpenAIChatModel.builder().baseUrl(props.getBaseUrl()).apiKey(props.getApiKey()).modelName(props.getModelName()).stream(true).build();ReActAgentagentReActAgent.builder().name(笑小枫的学习助手).model(model).sysPrompt(你是笑小枫的学习助手可以帮助用户快速学习使用AgentScope开发智能体。).build();Msgreplyagent.call(newUserMessage(你好)).block();System.out.println(reply.getTextContent());}6. 写在最后第一篇简单点讲究一个不全退喜欢的朋友可以点个关注。同时计划创建一个智能体学习沟通群有兴趣的朋友可以评论或私聊看看人数。本系列源码https://gitee.com/hack-feng/maple-agent-demo本文一览图