AI 超级智能体全栈项目阶段一：AI大模型概述、选型、项目初始化以及基于阿里云灵积模型 Qwen-Plus实现模型接入四种方式（SDK/HTTP/SpringAI/langchain4j）

spring:
  application:
    name: var-ai-agent
  profiles:
    active: local
server:
  port: 33333
  servlet:
    context-path: /api # api接口前缀
# springdoc-openapi项目配置
springdoc:
  swagger-ui:
    path: /swagger-ui.html
    tags-sorter: alpha
    operations-sorter: alpha
  api-docs:
    path: /v3/api-docs
  group-configs:
    - group: 'default'
      paths-to-match: '/**'
      packages-to-scan: cn.varin.varaiagent.controller #对应Controller接口包路径
# knife4j的增强配置，不需要增强可以不配
knife4j:
  enable: true
  setting:
    language: zh_cn

spring:
  application:
    name: spring-ai-alibaba-qwq-chat-client-example
  ai:
    dashscope:
      api-key: "阿里云申请的key"
      chat:
        options:
          model: qwen-plus

<dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.8.38</version>
        </dependency>

<dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
            <version>4.4.0</version>
        </dependency>

<dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

<dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>dashscope-sdk-java</artifactId>
            <!-- 请将 'the-latest-version' 替换为最新版本号：https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
            <version>2.21.10</version>
        </dependency>

package cn.varin.varaiagent.invoke;// 建议dashscope SDK的版本 >= 2.12.0
import java.util.Arrays;
import java.lang.System;
import java.util.Map;
import cn.varin.varaiagent.config.AliyunConfig;
import com.alibaba.dashscope.aigc.generation.Generation;
import com.alibaba.dashscope.aigc.generation.GenerationParam;
import com.alibaba.dashscope.aigc.generation.GenerationResult;
import com.alibaba.dashscope.common.Message;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.fastjson.JSON;
import jakarta.annotation.Resource;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import javax.xml.validation.Validator;
public class SDKInvoke {
    public  GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
        Generation gen = new Generation();
        Message systemMsg = Message.builder()
        .role(Role.SYSTEM.getValue())
        .content("You are a helpful assistant.")
        .build();
        Message userMsg = Message.builder()
        .role(Role.USER.getValue())
        .content("今天三明的天气怎么样？")
        .build();
        GenerationParam param = GenerationParam.builder()
        // 若没有配置环境变量，请用百炼API Key将下行替换为：.apiKey("sk-xxx")
        .apiKey(AliyunConfig.accessKeyId)
        // 此处以qwen-plus为例，可按需更换模型名称。模型列表：https://help.aliyun.com/zh/model-studio/getting-started/models
        .model("qwen-plus")
        .messages(Arrays.asList(systemMsg, userMsg))
        .resultFormat(GenerationParam.ResultFormat.MESSAGE)
        .build();
        return gen.call(param);
    }
    public static void main(String[] args) {
        try {
            GenerationResult result = new SDKInvoke(). callWithMessage();
            System.out.println(JsonUtils.toJson(result));
            Map map=      JSON.parseObject(JsonUtils.toJson(result),Map.class);
            System.out.println(map.get("output"));
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            // 使用日志框架记录异常信息
            System.err.println("An error occurred while calling the generation service: " + e.getMessage());
        }
        System.exit(0);
    }
}

{
    "requestId": "64993a53-3d15-4d14-a0a9-5b1a4f8c1980",
    "usage": {
        "input_tokens": 23,
        "output_tokens": 36,
        "total_tokens": 59,
        "prompt_tokens_details": {
            "cached_tokens": 0
        }
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": "I'm functioning well, thank you for asking! I appreciate your concern. I'm here and ready to help with whatever you need. How can I assist you today? 😊"
                }
            }
        ]
    }
}

curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-plus",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user", 
            "content": "你是谁？"
        }
    ]
}'

package cn.varin.varaiagent.invoke;
//http接入大模型
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONArray;
import cn.hutool.json.JSONObject;
import cn.varin.varaiagent.config.AliyunConfig;
public class HttpInvoke {
    public static void main(String[] args) {
        // 替换为你的API密钥
        String apiKey = AliyunConfig.accessKeyId;
        if (apiKey == null || apiKey.isEmpty()) {
            System.err.println("请设置环境变量DASHSCOPE_API_KEY");
            return;
        }
        // 构建请求URL
        String url = "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions";
        // 构建请求体JSON
        JSONObject requestBody = new JSONObject();
        requestBody.put("model", "qwen-plus");
        // 构建messages数组
        JSONArray messages = new JSONArray();
        // 添加system消息
        JSONObject systemMsg = new JSONObject();
        systemMsg.put("role", "system");
        systemMsg.put("content", "You are a helpful assistant.");
        messages.add(systemMsg);
        // 添加user消息
        JSONObject userMsg = new JSONObject();
        userMsg.put("role", "user");
        userMsg.put("content", "给我介绍一本关于学习Java的书籍");
        messages.add(userMsg);
        requestBody.put("messages", messages);
        // 发送POST请求
        HttpResponse response = HttpRequest.post(url)
                .header("Authorization", "Bearer " + apiKey)
                .header("Content-Type", "application/json")
                .body(requestBody.toString())
                .execute();
        // 输出响应结果
        System.out.println("响应状态码: " + response.getStatus());
        System.out.println("响应内容: " + response.body());
    }
}

响应内容: {
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "当然可以！一本广受好评且非常适合学习Java的书籍是：\n\n**《Java核心技术 卷I：基础知识》（原书第11版）**  \n作者：[美] 凯·S. 霍斯特曼（Cay S. Horstmann）\n\n这本书被广泛认为是学习Java的经典教材之一，特别适合初学者和有一定编程基础的学习者。\n\n### 主要特点：\n- **内容全面系统**：涵盖了Java语言的核心概念，包括数据类型、控制结构、面向对象编程、异常处理、泛型、集合框架、Lambda表达式和Stream API等。\n- **结合实际案例**：书中提供了大量清晰、实用的代码示例，帮助读者理解理论知识在实际开发中的应用。\n- **紧跟Java新特性**：第11版更新了对Java 8到Java 11中新特性的讲解，如函数式编程、模块化系统（Jigsaw）简介等。\n- **语言通俗易懂**：虽然内容深入，但作者讲解清晰，循序渐进，适合自学。\n- **权威推荐**：被众多高校和培训机构用作教材，也被Java开发者社区高度认可。\n\n### 适合人群：\n- Java初学者\n- 希望系统掌握Java核心知识的程序员\n- 准备转行进入Java开发领域的学习者\n\n### 补充建议：\n如果你已经掌握基础，想进一步深入，可以继续阅读《Java核心技术 卷II：高级特性》。\n\n此外，配合这本书学习时，建议动手编写代码，结合IDE（如IntelliJ IDEA或Eclipse）进行实践，效果更佳。\n\n如果你想看中文资源，这本书有高质量的中文翻译版，由机械工业出版社出版，书名是《Java核心技术 卷I：基础知识》。\n\n希望这本书能帮助你扎实掌握Java编程！如果你有特定学习目标（如准备面试、做Web开发等），我也可以推荐更有针对性的书籍。"
            },
            "finish_reason": "stop",
            "index": 0,
            "logprobs": null
        }
    ],
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 27,
        "completion_tokens": 407,
        "total_tokens": 434,
        "prompt_tokens_details": {
            "cached_tokens": 0
        }
    },
    "created": 1758975181,
    "system_fingerprint": null,
    "model": "qwen-plus",
    "id": "chatcmpl-6fa00c34-ee26-4d20-b2f4-0a6d82a90277"
}

<dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter</artifactId>
    <version>1.0.0-M6.1</version>
</dependency>

package cn.varin.varaiagent.invoke;
import jakarta.annotation.Resource;
import org.springframework.ai.chat.messages.AssistantMessage;
import org.springframework.ai.chat.model.ChatModel;
import org.springframework.ai.chat.prompt.Prompt;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;
@Component
public class SpringAiInvoke  implements CommandLineRunner {
    @Resource
    private ChatModel dashScopeChatModel;
    @Override
    public void run(String... args) throws Exception {
        AssistantMessage hello = dashScopeChatModel.call(new Prompt("解释AI一词"))
                .getResult()
                .getOutput();
        System.out.println(hello.getText());
    }
}

<!-- https://mvnrepository.com/artifact/dev.langchain4j/langchain4j-community-dashscope -->
<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-community-dashscope</artifactId>
    <version>1.5.0-beta11</version>
</dependency>

package cn.varin.varaiagent.invoke;
import cn.varin.varaiagent.config.AliyunConfig;
import dev.langchain4j.community.model.dashscope.QwenChatModel;
import dev.langchain4j.model.chat.ChatModel;
public class Langchaiin4jInvoke {
    public static void main(String[] args) {
// AliyunConfig.accessKeyId为在阿里云申请的key
        ChatModel build = QwenChatModel.builder().apiKey(AliyunConfig.accessKeyId)
        .modelName("qwen-plus")
        .build();
        String helloWorld = build.chat("hello world");
        System.out.println(helloWorld);
    }
}