MiniMax Agent API处理表格数据教程

MiniMax Agent API可批量处理Excel销售数据：安装SDK、配置API密钥后，上传文件并解析表格；用自然语言指令新增列与公式，自动校验并注入；调用minimax-xlsx技能生成带条件格式的汇总报表；最后导出结果。

你需要用MiniMax Agent API批量处理Excel表格里的销售数据、自动填充公式、生成带条件格式的报表，但每次都要手动写VBA或反复调试pandas脚本，效率极低。

准备API环境与基础连接

打开终端，执行pip install minimax-agent-sdk安装最新SDK。这一步必须完成，否则后续所有调用都会报ModuleNotFoundError。

从agent.minimax.io/console进入控制台，在“API Keys”页生成新密钥，复制保存——

。

新建Python文件，填入以下初始化代码：

from minimax_agent import AgentClient
client = AgentClient(api_key="your_api_key_here")

上传文件并触发表格解析

方法一：直接上传本地.xlsx文件
调用client.upload_file("sales_q2_2026.xlsx")，返回file_id形如"file_abc123"，该ID是后续所有操作的唯一凭证。

方法二：从URL拉取远程表格
client.upload_file("https://example.com/data/export.xlsx")，注意URL必须公开可访问且响应头含Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet。

上传后立即执行client.parse_table(file_id=file_id, sheet_name="明细表")，系统将自动识别字段名、数据类型和空行断点——

。

用自然语言生成并注入公式

第一步：明确指令语义
向client.send指令时，必须包含“新增列名”+“计算规则”+“生效范围”三要素。例如：“新增‘毛利率’列，公式为=(F2-E2)/F2，保留两位小数，从第2行开始应用。”

第二步：等待公式生成与校验
接下来，Agent会返回一份结构化结果，里面包含三项关键信息：formula_string、target_range 和 error_rate。怎么判断结果靠不靠谱？看 error_rate 就行。若它等于 0.00，意味着所有单元格的公式地址偏移都准确无误；如果高于 0.05，通常就不是公式本身的问题了，而是原始数据里存在合并单元格或空行干扰，这种情况下需要先把数据清理干净。

第三步：写入并校验结果
接下来执行client.apply_formula(file_id=file_id, formula_dict={"G2": "=(F2-E2)/F2", "G3": "=(F3-E3)/F3"})。这里有个关键点：不需要传整列范围，只要给出这些单元格公式，Agent就会结合上下文，自动判断并补全后续的填充逻辑。

调用MiniMax-xlsx技能生成结构化报表

执行skill install https://github.com/MiniMax-AI/skills/minimax-xlsx，安装后即可使用预置能力。

输入自然语言指令：“生成季度汇总报表，含区域分组、销售额SUM、订单数COUNT、平均客单价A VERAGE、达标率（达标订单数/总订单数），达标订单定义为金额≥5000且状态=已发货。”

Agent自动创建新工作簿，写入带SUMIFS、COUNTIFS、A VERAGEIFS公式的汇总表，并为“达标率”列添加红黄绿三色条件格式——该格式直接写入.xlsx底层XML，无需额外渲染步骤。

导出处理结果

调用client.export_file(file_id=file_id, format="xlsx")，返回下载URL。链接72小时内有效，过期需重新生成。

如需嵌入现有流程，可追加参数output_path="/data/output/report_final.xlsx"，Agent将直接写入本地指定路径。