千问Agent模式使用指南：自动执行任务详解

想让千问的Agent模式真正“自动化”运行，指令发出后却只得到文字描述而非实际执行？这通常意味着Agent的执行链路未被激活，或指令未能精确触发其工具调用逻辑。按照以下步骤操作，即可解锁其自动化处理能力。

一、环境确认：启用Agent执行链路

自动化执行的前提，是确保当前对话已加载Agent的完整工具调用链路。该链路允许模型自主判断并调用外部工具，如联网搜索、代码执行或文档解析。

操作路径：在千问App、网页版或PC客户端中新建对话。直接在输入框内输入“启用Agent模式”，或点击输入框左下角的Agent功能图标。当界面右上角出现“Agent已就绪”状态提示时，即表示环境准备就绪。若提示设备不支持，请检查账号是否已完成实名认证，并确保客户端为最新版本。

二、指令触发：使用自然语言驱动工具

Agent模式的优势在于无需记忆复杂命令。使用明确的动词和任务目标下达指令，模型将自动解析意图并匹配相应工具。

在已启用Agent的对话中，尝试输入：“查询上海今日的实时天气”、“将这份PDF文档转换为可编辑的Excel表格”或“统计表格中销售额超过10万元的客户数量”。指令发出后，观察界面变化——若出现“正在调用工具…”的状态提示，则表明Agent已识别到可执行动作并进入工作流程。稍后，结构化结果（如天气信息卡片、处理完成的文件下载链接）将直接呈现。若指令未触发执行，可追加“请直接执行操作，无需解释步骤”进行引导。

三、文件处理：驱动Agent分析本地文档

当需要处理本地文件时，此功能尤为高效。无论是格式转换、数据提取还是逻辑计算，Agent均可基于文件内容自动构建并执行操作链。

操作流程：在对话界面点击附件图标，上传目标文件（支持Excel、PDF、图片、Word等格式，单次最多100个）。上传后，直接提出具体任务，例如：“自动分析这份季度财报，找出毛利率环比下降超过5%的产品线，并高亮标注”。随后，Agent将自动加载文件，执行数据比对与趋势分析，最终生成一份带有条件格式标记的修订版表格。点击“导出结果”即可下载处理完成的文件，全程无需手动操作单元格或编写公式。

四、API集成：开发者端的自动化调度方案

对于需要将自动化能力集成至自有系统的开发者，可通过API调用实现服务端的Agent推理与工具调度。

确保已配置DASHSCOPE_API_KEY环境变量，并安装1.22.0及以上版本的dashscope SDK。在Python脚本中，调用Generation.call方法，传入model="qwen-max"及tool_choice="auto"等核心参数。将完整任务指令构造成prompt字段，例如：“从指定URL中提取所有邮箱地址，去重后按域名分类输出JSON格式”。只要在tools参数中注册了相应工具（如网页抓取与邮箱解析器），Agent将在响应中返回function_call字段，指明具体执行动作与参数，随后自动完成调用并返回最终结果。