pinecone-assistant

Pinecone Assistant

Pinecone Assistant 是一项全托管 RAG 服务。上传文档、提问，即可获得附带引用的答案。无需嵌入流程或基础设施。

所有脚本都位于此技能目录下的 scripts/ 中。 运行方式：uv run scripts/script_name.py [arguments]

<<clarify_style>>

操作

操作	脚本	关键参数
创建助手	scripts/create.py	--name --instructions --region
上传文件	scripts/upload.py	--assistant --source --patterns
同步文件（增量）	scripts/sync.py	--assistant --source --delete-missing --dry-run
聊天／提问	scripts/chat.py	--assistant --message
获取上下文片段	scripts/context.py	--assistant --query --top-k
列出助手	scripts/list.py	--files --json

如需了解任何操作的完整工作流详情，请阅读 references/ 中的相关文件。

---

自然语言识别

主动识别并处理以下模式，无需用户提供明确命令：

创建：“创建一个助手”、“创建一个名为 X 的助手”、“为我的文档设置一个助手” → 参阅 references/create.md

上传：“上传我的文档”、“向我的助手添加文件”、“为我的文档编制索引” → 参阅 references/upload.md

同步：“同步我的文档”、“更新我的助手”、“让助手保持同步”、“从 ./docs 刷新” → 参阅 references/sync.md

聊天：“询问我的助手有关 X 的内容”、“我的助手了解哪些关于 X 的信息”、“与 X 聊天” → 参阅 references/chat.md

上下文：“在我的助手中搜索 X”、“查找关于 X 的上下文” → 参阅 references/context.md

列表：“显示我的助手”、“我有哪些助手” → 运行 uv run scripts/list.py

---

对话记忆

在对话中记住最近使用的助手：

• 用户创建或首次使用助手时，记住其名称
• 用户说“我的助手”、“它”或“这个助手”时 → 使用最近使用的助手
• 简要确认正在使用的助手：“正在询问 docs-bot……”
• 如果指代不明确且存在多个助手 → 请用户 уточ清楚

---

多步骤请求

自然地处理串联请求。例如：

“创建一个名为 docs-bot 的助手，上传我的 ./docs 文件夹，并询问主要功能是什么”

1. uv run scripts/create.py --name docs-bot
2. uv run scripts/upload.py --assistant docs-bot --source ./docs
3. uv run scripts/chat.py --assistant docs-bot --message "what are the main features?"

---

先决条件

• 必须能够获取 PINECONE_API_KEY： <<api_key_setup>>
• 必须安装 uv — 安装 uv
• 在此获取免费 API 密钥：https://app.pinecone.io/?sessionType=signup