用途:当问题需要依据 LlamaCloud Index v2 知识库中的文档作答时,使用该技能检索段落、定位已索引文件并读取内容。Index v2 是 LlamaParse 平台的托管知识库,面向智能体式检索,除语义搜索外还提供类似文件系统的文档访问能力。
主要能力:列出索引(GET /indexes);语义检索段落(POST /retrieval/retrieve,支持 index_id、query、top_k、rerank、score_threshold、static_filters、custom_filters);按文件名查找文件(POST /retrieval/files/find,支持 file_name_contains 子串或 file_name 精确匹配);在文件内按正则匹配(POST /retrieval/files/grep,支持 pattern、context_chars);读取文件片段(POST /retrieval/files/read,支持 offset、max_length)。file_id 来自 find 与 retrieve 的返回结果。
使用方式:先设置环境变量 LLAMA_BASE(EU 账户为 https://api.cloud.eu.llamaindex.ai/api/v1)与认证头,再按需调用上述接口,建议用 jq 过滤字段。典型流程为发现索引、定位文件、grep 精确模式、retrieve 语义搜索、read 读取上下文窗口。检索结果带有文件 ID 与页码范围,可用于引用来源。若环境无 shell,可通过 LlamaParse MCP 服务器(https://mcp.llamaindex.ai/mcp,或按索引限定 /index/{indexId}/mcp)使用相同操作。
适用场景:开放式或概念性问题、跨文档问题、已知文件内查找精确术语或标识符、需要某段落周边上下文、验证文档是否提及某内容。
限制与注意:每次调用应设置边界(top_k、rerank.top_n、context_chars、offset/max_length),避免无界响应进入对话;不要一次性粘贴整份文件;不要只做一次检索就停止;grep 匹配模式而非语义,空结果不代表答案不存在;不要重复相同调用;多个索引可能匹配时应询问用户;答案须基于实际检索内容并标注来源,索引中无答案时应明确说明,不得用先验知识填补。401/403 时应检查 API Key 与区域,不要循环重试。