> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# 使用 PrivateGPT 和 Qdrant RAG 查询 PDF

> 将 PDF 导入本地向量存储，并使用 Arka 的 PrivateGPT 和 Qdrant 驱动的检索增强生成流水线用自然语言提问。

使用 PrivateGPT + Qdrant 向量搜索询问关于你的 PDF 的问题。

## 命令

| 命令           | 示例                                            |
| ------------ | --------------------------------------------- |
| `pdf_ingest` | `pdf_ingest ~/Documents/resume.pdf`           |
| `pdf_list`   | 列出已导入的文档                                      |
| `pdf_ask`    | `pdf_ask --doc resume.pdf "summarize skills"` |

## 自然语言

```bash theme={null}
arka "ask Profile.pdf about main skills"
arka "summarize ENGLSH-2 weeks 1 to 3"
```

## 设置

需要 [PrivateGPT](https://github.com/zylon-ai/private-gpt) 和用于 Qdrant 的 Docker。当 `PDF_RAG_AUTO_START=1` 时，Arka 会自动启动服务。

```env theme={null}
PDF_RAG_URL=http://127.0.0.1:8080
PRIVATEGPT_HOME=~/Projects/private-gpt
PDF_RAG_AUTO_START=1
```

```bash theme={null}
pip install "arka-agent[pdf]"
arka pdf status    # 检查 PrivateGPT + Qdrant
```


## Related topics

- [安全模型与提示注入防御](/cn/concepts/security.md)
- [Arka 故障排查：LLM、路由、语音与 RAG 修复](/cn/reference/troubleshooting.md)
- [快速开始：安装 Arka 并运行第一条命令](/cn/quickstart.md)
- [配置、环境变量与 API 密钥设置](/cn/reference/configuration.md)
- [Arka 简介](/cn/index.md)