智谱清言API不支持直接上传文件，需先用pandas/PyPDF2/python-docx等库将Excel、PDF、Word转为文本或Markdown，控制在80K token内，再构造prompt调用；复杂格式推荐代码沙盒预处理；全自动分析应使用智能体模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让智谱清言API自动读取并解析上传的Excel、PDF或Word文件内容，但发现直接调用chat.completions接口只返回“请先上传文件”这类提示——这是因为API本身不支持文件上传功能，必须先将文件内容转为文本或结构化数据，再作为prompt传入。
把本地文件转成文本送进API
这一步是绕过上传限制的核心。你不能把.xlsx文件直接塞给API，但可以自己用Python读出来，抽成纯文本或Markdown表格，再拼进问题里。
第一步：用pandas读Excel，用PyPDF2或pdfplumber读PDF，用python-docx读Word。例如处理销售表：df = pd.read_excel("sales.xlsx", sheet_name="Q2") → text_content = df.to_markdown(index=False)。
第二步：把提取出的文本控制在128K token以内。GLM-4-flash模型上下文上限是128K，但实际建议压缩到80K以下——超长文本会导致截断、字段错位或推理失效。【超过长度限制时API不会报错，而是静默丢弃后半部分内容】
第三步：构造prompt，明确指令。比如：“以下是从销售报表中提取的数据：\n{table_text}\n请统计华东区6月销售额总和，并指出环比变化最大的产品线。”
用代码沙盒预处理再调API（推荐）
如果你的文件含复杂格式（合并单元格、多表联动、PDF图表），手动解析容易漏数据。这时应优先走智谱清言内置的代码沙盒路径，让它代劳清洗，再把结果喂给API。
方法一：网页端触发沙盒→获取清洗后文本→复制粘贴进API调用脚本。操作路径：上传文件→输入“用pandas读取‘订单’表，填充缺失值，输出前5行Markdown”→运行→复制输出结果→粘贴到你的API请求data["prompt"]中。
方法二：用API调用沙盒能力（需开通企业版权限）。向https://open-api.glm.ai/v1/sandbox/execute发送POST请求，body含Python代码字符串，响应返回stdout和DataFrame.head()截图base64编码。注意：该接口不返回原始CSV，需自行base64解码图片后OCR识别数字——仅当必须保留PDF原图中的表格样式时才用此法。
对接智能体实现全自动分析
真正想做到“上传即分析”，就得跳过单次API调用，改用智能体（Agent）模式。它能接管文件上传、格式识别、逻辑判断、多步调用全过程。
- 登录智谱清言Web端，进入“创建智能体”页面
- 选择“数据分析教练”模板，上传你的历史销售报表样例（.xlsx/.csv），系统自动学习字段含义与常用分析口径
- 在“知识库”中添加业务规则，例如：“毛利率=（售价-成本）/售价；低于30%标为预警”
- 发布智能体后，获取其专属agent_id。后续只需向
/v1/agents/{agent_id}/run发送含文件URL的JSON请求，无需再做文本转换
这一步不需要你写任何解析逻辑。智能体内部已封装pdfplumber+openpyxl+pandas链路，且自动启用AutoGLM沉思模式进行多步归因——比如发现“华北区销量下跌”，会主动追溯是否与促销结束、竞品上新、物流停摆三类事件时间重合。
