上图中可以明显看见通义千问除了有大语言模型,还有通义千问VL和通义千问Audio。因此注意,本文只是针对于通义千问的大语言模型。至于以上两个是做什么的,可自行查看官网。
阿里云官网提供两种提供的快速入门的方法案例:(改进)
在pom.xml文件种导入DashScope SDK的坐标
<!-- 通义千问SDK--><!-- https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java --><dependency> <groupId>com.alibaba</groupId> <artifactId>dashscope-sdk-java</artifactId> <version>2.13.0</version> <exclusions> <exclusion> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> </exclusion> </exclusions></dependency> <dependency> <groupId>com.squareup.okhttp3</groupId> <artifactId>okhttp</artifactId> <version>4.10.0</version> </dependency>
通过messages调用(推荐)
编写Controller层
package com.he.cms.blog.controller;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.he.cms.blog.service.IBlogAiSGenerateService;import io.swagger.annotations.Api;import io.swagger.annotations.ApiOperation;import lombok.extern.slf4j.Slf4j;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.PathVariable;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;/** * @ClassName BlogAiGenerateController * @Author Hym * @Date 2024/4/13 23:01 */@Slf4j@RestController//好好学习,走向巅峰!@Api(tags = "博客生成")public class BlogAiGenerateController { @Autowired private IBlogAiSGenerateService blogAiSGenerateService; /** * 生成博客 */ @RequestMapping("/generateArticle/{content}") @ApiOperation(value = "生成博客", notes = "生成博客" + "调用方式:" + "生成博客" + "传入参数:" + "content") public GenerationResult generateArticle(@PathVariable String content) throws NoApiKeyException, InputRequiredException { GenerationResult generationResult = blogAiSGenerateService.BlogAiSGenerate(content); log.info(generationResult.toString()); return generationResult; }}
2.3 Servic层及实现类
接口
package com.he.cms.blog.service;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;public interface IBlogAiSGenerateService { /** * 生成博客 * * @param title 标题 * @param content 内容 * @return 结果 */ GenerationResult BlogAiSGenerate(String content) throws NoApiKeyException, InputRequiredException;}
实现类
package com.he.cms.blog.service.impl;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.he.cms.blog.service.ICmsBlogAiSGenerateService;import com.he.cms.utils.CmsBlogQianWenGenerateUtils;import org.springframework.stereotype.Service;import javax.annotation.Resource;/** * @ClassName BlogAiSGenerateServiceImpl * @Author Hym * @Date 2024/4/13 23:06 */@Service//好好学习,走向巅峰!public class CmsBlogAiSGenerateServiceImpl implements ICmsBlogAiSGenerateService { @Resource private CmsBlogQianWenGenerateUtils cmsBlogQianWenGenerateUtils; @Override public GenerationResult BlogAiSGenerate(String content) throws NoApiKeyException, InputRequiredException { return cmsBlogQianWenGenerateUtils.callWithMessage(content); }// public static void main(String[] args) {// CmsBlogAiSGenerateServiceImpl blogAiSGenerateService = new CmsBlogAiSGenerateServiceImpl();// try {// System.out.println(blogAiSGenerateService.BlogAiSGenerate("给我写一篇java的文章").toString());// } catch (NoApiKeyException e) {// e.printStackTrace();// } catch (InputRequiredException e) {// e.printStackTrace();// }// }}
调用通义千问API的组件
package com.he.cms.utils;import com.alibaba.dashscope.aigc.generation.Generation;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.aigc.generation.models.QwenParam;import com.alibaba.dashscope.common.Message;import com.alibaba.dashscope.common.MessageManager;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.Constants;import io.swagger.annotations.ApiOperation;import lombok.extern.slf4j.Slf4j;import org.springframework.beans.factory.annotation.Value;import org.springframework.stereotype.Component;/** * @ClassName BlogQianWenGenerateUtils * @Author Hym * @Date 2024/4/13 23:13 *///好好学习,走向巅峰! @Slf4j @Componentpublic class CmsBlogQianWenGenerateUtils { @Value("${tong_yi_cloud.ai_api_Key}") private String qianWenKeyApiKey; @ApiOperation("千问生成文章" + "调用方式:" + "千问生成文章" + "传入参数:" + "content") public GenerationResult callWithMessage(String content) throws NoApiKeyException, ApiException, InputRequiredException { Constants.apiKey=qianWenKeyApiKey; Generation gen = new Generation(); MessageManager msgManager = new MessageManager(10); Message systemMsg = Message.builder().role(Role.SYSTEM.getValue()).content("你是一个写文章的大师").build(); Message userMsg = Message.builder().role(Role.USER.getValue()).content(content).build(); msgManager.add(systemMsg); msgManager.add(userMsg); QwenParam param = QwenParam.builder().model(Generation.Models.QWEN_TURBO).messages(msgManager.get()) .resultFormat(QwenParam.ResultFormat.MESSAGE) .topP(0.8) .enableSearch(true) .build(); GenerationResult result = gen.call(param); log.info("千问api回答的话语为:{}",result); return result; }}
返回结果
{ "requestId": "358d15cd-c01c-9052-aa8f-c20232a50148", "usage": { "inputTokens": 25, "outputTokens": 400, "totalTokens": 425 }, "output": { "text": null, "finishReason": null, "choices": [ { "finishReason": "stop", "index": null, "message": { "role": "assistant", "content": "标题:职场探索:打造个人品牌,成功求职之道\n\n在人生的道路上,找工作如同开启一段新的旅程,充满期待与挑战。在这个竞争激烈的市场中,找到理想的工作不仅需要实力的展现,更需要策略和技巧的巧妙运用。以下是一些关键步骤和建议,助你在求职之路上走得更稳健。\n\n首先,自我认知是基石。明确你的职业目标和兴趣,了解自己的优势与劣势,这将帮助你定位理想的职位。一份精心撰写的简历和个性化的求职信,能精准地传达你的专业技能和独特价值,让招聘者一眼看出你的潜力。\n\n其次,提升自我。不断学习和积累经验是提升竞争力的关键。无论是专业技能的精进,还是软技能的培养,如团队合作、沟通能力等,都能让你在众多应聘者中脱颖而出。参加行业研讨会、实习项目或者志愿者活动,都是拓宽视野和积累实战经验的好方法。\n\n网络的力量不容忽视。利用社交媒体平台如LinkedIn建立专业形象,定期更新你的职业动态和成就,不仅能吸引潜在雇主的注意,也能扩大你的人脉圈。同时,关注行业内的招聘信息,积极投递并参与线上面试,可以提高你的曝光率。\n\n面试时,充分准备至关重要。研究公司的文化和价值观,理解他们对岗位的期望,用实例说明你是如何满足这些要求的。展示你的热情、诚实和解决问题的能力,让面试官看到你的诚意和决心。\n\n最后,保持耐心和积极态度。找工作并非一蹴而就,可能会经历挫折,但请记住,每一次的拒绝都是向成功的一步。保持开放的心态,持续学习,不断提升自己,总有一天,机会会降临到有准备的你身上。\n\n总的来说,寻找工作是一个全方位的策略性过程,需要你的智慧、努力和时间。相信自己,坚持下去,你一定能在职场上找到属于你的那片天空。祝你好运,职场之路越走越宽广!", "toolCalls": null, "toolCallId": null } } ] }}
通过prompt调用
改良版本
package test;// Copyright (c) Alibaba, Inc. and its affiliates.import com.alibaba.dashscope.aigc.conversation.Conversation;import com.alibaba.dashscope.aigc.conversation.ConversationParam;import com.alibaba.dashscope.aigc.conversation.ConversationResult;import com.alibaba.dashscope.exception.ApiException;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.alibaba.dashscope.utils.JsonUtils;public class Main { public static void quickStart() throws ApiException, NoApiKeyException, InputRequiredException { Conversation conversation = new Conversation(); String prompt = "用萝卜、土豆、茄子做饭,给我个菜谱。"; ConversationParam param = ConversationParam .builder() .model(Conversation.Models.QWEN_TURBO) .prompt(prompt) .apiKey("你的apiKey") .build(); ConversationResult result = conversation.call(param); System.out.println(JsonUtils.toJson(result)); } public static void main(String[] args) { try { quickStart(); } catch (ApiException | NoApiKeyException | InputRequiredException e) { System.out.println(e.getMessage()); } System.exit(0); }}
返回结果
{"requestId":"b384e189-4d38-9f2e-9773-8350c1934f1a", "usage":{"input_tokens":32,"output_tokens":433,"total_tokens":465}, "output":{"text":"当然可以,这里有一个简单而美味的三蔬菜炖煮菜品谱,名为\"红烧三蔬(萝卜、土豆、茄子)\":\n\n**材料:**\n1. 萝卜1根\n2. 土豆2个\n3. 茄子2个\n4. 大葱1根\n5. 生姜2片\n6. 大蒜3瓣\n7. 食用油适量\n8. 料酒1汤匙\n9. 生抽酱油2汤匙\n10. 红糖2茶匙\n11. 清水适量\n12. 盐适量\n13. 胡椒粉适量\n14. 水淀粉(可选,用于勾芡)\n\n**步骤:**\n1. 萝卜、土豆和茄子分别洗净去皮,切成滚刀块。大葱切段,生姜和大蒜切末备用。\n2. 锅中加入适量食用油,放入红糖小火慢慢炒化,炒至红色泡沫状。\n3. 加入切好的姜蒜末,翻炒出香味。\n4. 倒入切好的萝卜块,翻煎均匀,让每一块都裹上糖色。\n5. 加入土豆块,继续翻煎至表面微黄。\n6. 将茄子块加入锅中,翻煎至所有蔬菜都略微软化。\n7. 倒入料酒,翻炒均匀后加入生抽酱油,翻炒均匀使蔬菜充分吸收调料。\n8. 加入足够的清水,水量以刚好没过蔬菜为宜。盖上锅盖,转中小火慢炖约15-20分钟,直到蔬菜熟软。\n9. 期间可根据口味加入适量的盐和胡椒粉调味。\n10. 如果喜欢汤汁浓稠,可在最后加入少量水淀粉,快速搅拌均匀即可。\n\n这道菜色泽诱人,营养丰富,是家常便饭的好选择。你可以根据个人口味调整食材份量和调料。Enjoy your meal!","finish_reason":"stop"}}
官方提供的版本
// Copyright (c) Alibaba, Inc. and its affiliates.import java.util.concurrent.Semaphore;import com.alibaba.dashscope.aigc.generation.Generation;import com.alibaba.dashscope.aigc.generation.GenerationResult;import com.alibaba.dashscope.aigc.generation.models.QwenParam;import com.alibaba.dashscope.common.ResultCallback;import com.alibaba.dashscope.exception.ApiException;import com.alibaba.dashscope.exception.InputRequiredException;import com.alibaba.dashscope.exception.NoApiKeyException;import com.alibaba.dashscope.utils.JsonUtils;public class Main { private final static String PROMPT = "就当前的海洋污染的情况,写一份限塑的倡议书提纲,需要有理有据地号召大家克制地使用塑料制品"; public static void qwenQuickStart() throws NoApiKeyException, ApiException, InputRequiredException { Generation gen = new Generation(); QwenParam param = QwenParam.builder().model(Generation.Models.QWEN_TURBO).prompt(PROMPT) .topP(0.8).build(); GenerationResult result = gen.call(param); System.out.println(JsonUtils.toJson(result)); } public static void qwenQuickStartCallback() throws NoApiKeyException, ApiException, InputRequiredException, InterruptedException { Generation gen = new Generation(); QwenParam param = QwenParam.builder().model(Generation.Models.QWEN_TURBO).prompt(PROMPT) .topP(0.8).build(); Semaphore semaphore = new Semaphore(0); gen.call(param, new ResultCallback<GenerationResult>() { @Override public void onEvent(GenerationResult message) { System.out.println(message); } @Override public void onError(Exception ex){ System.out.println(ex.getMessage()); semaphore.release(); } @Override public void onComplete(){ System.out.println("onComplete"); semaphore.release(); } }); semaphore.acquire(); } public static void main(String[] args) { try { qwenQuickStart(); qwenQuickStartCallback(); } catch (ApiException | NoApiKeyException | InputRequiredException | InterruptedException e) { System.out.println(String.format("Exception %s", e.getMessage())); } System.exit(0); }}
前端最终实现效果图
后端使用通义千问SDK调用后,控制台的输出
最后附上该文章的语雀地址:博主语雀