用途:这是关于如何使用 LlamaParse MCP 工具的技能说明,指导通过 MCP 完成文件的上传、解析、分类和拆分。
认证与区域:所有工具需有效会话;若返回认证错误,应提示用户重新认证后再重试,不要自动重试。服务器有两个区域部署:云端账户使用 https://mcp.llamaindex.ai/mcp,欧洲云端账户使用 https://mcp.eu.llamaindex.ai/mcp。区域随 LlamaCloud 账户而定,不应在会话中切换;跨区域令牌会返回 401 并指明正确端点,应让用户把客户端指向错误中给出的端点。
上传:解析、分类、拆分都需先上传得到 fileId。文件可通过 URL 时用 uploadFileByUrl,传直链和描述性文件名;本地或二进制文件先调 getUploadUrl 获得预签名上传地址与 token,再 POST 上传,token 有效 10 分钟。调用 getUploadUrl 时应把 purpose 设为后续操作(parse、classify、split)以匹配存储策略。
工具选择:提取文本或 Markdown 用 parseFile;判断文档类别用 classifyFile;把多段落文档拆成带标签片段用 splitFile。三者相互独立,同一 fileId 可任意组合运行。
解析:分层级选择,cost_effective 快且便宜,适合文本干净、布局简单的标准 PDF;agentic 较慢,适合含表格、多栏或图片的文档;agentic_plus 最彻底,仅用于提取质量关键且可接受成本与延迟的场景。不确定时先用 cost_effective,若内容缺失或结构出错再升级。markdown 默认 true,需要渲染或传给 LLM 时保持;需要无格式纯文本时设为 false。
分类:让用户路由或标注文档时使用。类别定义应尽量精确并说明区分依据,含糊描述会降低置信度。
拆分:单文档含多个逻辑段落(如多份合约合一的 PDF、含不同章节的报告)时使用,类别应按预期段落定义。allowUncategorized 可选 include(默认,未知页归入未分类段)、omit(静默丢弃未分类页)或 forbid(任一点无法分类即失败)。
链式操作:可先分类确认文档类型再决定是否解析;可先拆分再对各段页面分别调用 parseFile;一个 fileId 可独立传给三个工具,无需重复上传。
速率与错误:服务器有每用户速率限制,遇到限流应读取 Retry-After 并等待指定秒数,不要立即循环重试。uploadFileByUrl 失败时检查 URL 是否公开可访问及文件类型是否支持;parseFile 内容不完整可提高层级重试;classifyFile 或 splitFile 超时可能仍在运行,应告知用户而非立即重复提交。