上图中可以明显看见通义千问除了有大语言模型,还有通义千问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
@Component
public 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调用后,控制台的输出
最后附上该文章的语雀地址:博主语雀