通义千问API接入：从零搭建智能客服
通义千问是阿里云的大语言模型，通过API可以快速搭建智能客服系统。本文完整介绍从申请API Key到搭建一个具备多轮对话、知识库问答、意图识别能力的智能客服系统。
一、申请API Key
登录阿里云百炼平台（bailian.console.aliyun.com），开通模型服务。在API Key管理中创建密钥。通义千问提供多种模型：qwen-max（最强，适合复杂任务）、qwen-plus（均衡，推荐日常使用）、qwen-turbo（最快最便宜，适合简单场景）。新用户有免费额度，可以先用qwen-plus测试。
二、基础接入
使用DashScope SDK接入（Python示例）：from dashscope import Generation; response = Generation.call(model='qwen-plus', messages=[{'role':'user','content':'你好'}])。返回结果包含生成的文本和token使用量。
HTTP API方式：POST请求到 https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation，Header中带上 Authorization: Bearer YOUR_API_KEY。支持流式输出（SSE），适合实时对话场景。
三、多轮对话
智能客服需要支持上下文记忆。通义千问的messages参数支持传入历史对话：messages=[{role:'system',content:'你是XX公司的客服...'},{role:'user',content:'...'},{role:'assistant',content:'...'},{role:'user',content:'...'}]。建议保留最近10轮对话，超过的截断。
四、System Prompt设计
System Prompt决定了AI的角色和行为。好的System Prompt应该包含：角色定义（你是XX公司的客服）、能力边界（你只能回答和产品相关的问题）、回答风格（友好、简洁、专业）、限制条件（不讨论政治、不提供医疗建议）。
五、结合知识库
单纯的LLM无法回答企业内部知识。结合RAG（检索增强生成）：将企业文档向量化存入向量数据库，用户提问时先检索相关文档片段，将检索结果作为上下文传入LLM。百炼平台提供了知识库功能，上传文档后自动构建RAG系统。
六、上线注意事项
设置内容审核（通义千问内置了安全审核）。配置fallback策略——AI无法回答时转人工。记录所有对话日志用于后续优化。设置token用量监控，防止异常调用导致费用暴增。