用途:Spring AI Alibaba 提供与阿里云 DashScope(通义千问)的集成,便于在 Spring 项目中使用阿里云大语言模型服务开发 AI 应用。
主要能力:支持 qwen-turbo、qwen-plus、qwen-max 等模型选择;通过 ChatClient 进行对话调用;支持流式响应;提供 Prompt Template 变量渲染;提供 Embedding 向量化(如 text-embedding-V1);支持维护历史消息实现多轮对话。
使用方式:引入依赖 com.alibaba.cloud.ai:spring-ai-starter-model-aliyun-dashscope(Maven 或 Gradle)。在 application.yml 中配置 spring.ai.alibaba.dashscope.api-key(建议用环境变量 DASHSCOPE_API_KEY),并设置 chat.options 的 model、temperature、max-tokens;Embedding 配置 model。注入 ChatClient 调用 call 获取回复,或注入 StreamingChatClient 以 Flux 流式返回;用 PromptTemplate 以 Map 变量渲染提示词;用 EmbeddingClient.embedForResponse 获取向量。
适用场景:在 Java/Spring 项目中集成通义千问进行对话、流式交互、中文提示词处理、文本向量化及多轮对话。
限制与最佳实践:API Key 应由环境变量管理并区分环境,配置合理超时与重试;对调用做异常捕获与日志;按场景选择模型以兼顾性能与成本,限制 Token 用量并监控调用;文档提到通义千问对中文支持较好,可优化中文提示词。资料未提供收费、价格、平台或效果数据。