> **pinecone-assistant** — skill 1 of 9 in [pinecone-io/skills](https://skillsdocs.com/pinecone-io/skills).
>
> Book (all skills, one file): https://skillsdocs.com/pinecone-io/skills.md
> Machine manifest: https://skillsdocs.com/pinecone-io/skills/.well-known/agent-skills/index.json
> Install the book: `npx skills add pinecone-io/skills`
> Upstream: https://github.com/pinecone-io/skills/blob/main/skills/pinecone-assistant/SKILL.md @ `main`
> Raw bytes, no header: https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/SKILL.md
> Base for relative paths: https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/
> Licence: MIT — https://spdx.org/licenses/MIT.html
>
> Bundled files (12), referenced from this skill's directory:
>   - `references/chat.md` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/references/chat.md
>   - `references/context.md` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/references/context.md
>   - `references/create.md` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/references/create.md
>   - `references/list.md` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/references/list.md
>   - `references/sync.md` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/references/sync.md
>   - `references/upload.md` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/references/upload.md
>   - `scripts/chat.py` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/scripts/chat.py
>   - `scripts/context.py` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/scripts/context.py
>   - `scripts/create.py` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/scripts/create.py
>   - `scripts/list.py` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/scripts/list.py
>   - `scripts/sync.py` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/scripts/sync.py
>   - `scripts/upload.py` — https://raw.githubusercontent.com/pinecone-io/skills/main/skills/pinecone-assistant/scripts/upload.py
>
> Content © its authors, served unmodified. Takedown: https://github.com/DreambaseAI/skillsdocs/issues/new?labels=takedown&title=Takedown+request

<!-- Verbatim upstream SKILL.md follows, YAML frontmatter included. -->

---
name: pinecone-assistant
description: Create, manage, and chat with Pinecone Assistants for document Q&A with citations. Handles all assistant operations - create, upload, sync, chat, context retrieval, and list. Recognizes natural language like "create an assistant from my docs", "ask my assistant about X", or "upload my docs to Pinecone".
---

# Pinecone Assistant

Pinecone Assistant is a fully managed RAG service. Upload documents, ask questions, get cited answers. No embedding pipelines or infrastructure required.

> All scripts are in `scripts/` relative to this skill directory.
> Run with: `uv run scripts/script_name.py [arguments]`

<<clarify_style>>

## Operations

| What to do | Script | Key args |
|---|---|---|
| Create an assistant | `scripts/create.py` | `--name` `--instructions` `--region` |
| Upload files | `scripts/upload.py` | `--assistant` `--source` `--patterns` |
| Sync files (incremental) | `scripts/sync.py` | `--assistant` `--source` `--delete-missing` `--dry-run` |
| Chat / ask a question | `scripts/chat.py` | `--assistant` `--message` |
| Get context snippets | `scripts/context.py` | `--assistant` `--query` `--top-k` |
| List assistants | `scripts/list.py` | `--files` `--json` |

For full workflow details on any operation, read the relevant file in `references/`.

---

## Natural Language Recognition

Proactively handle these patterns without requiring explicit commands:

**Create:** "create an assistant", "make an assistant called X", "set up an assistant for my docs"
→ See [references/create.md](references/create.md)

**Upload:** "upload my docs", "add files to my assistant", "index my documentation"
→ See [references/upload.md](references/upload.md)

**Sync:** "sync my docs", "update my assistant", "keep assistant in sync", "refresh from ./docs"
→ See [references/sync.md](references/sync.md)

**Chat:** "ask my assistant about X", "what does my assistant know about X", "chat with X"
→ See [references/chat.md](references/chat.md)

**Context:** "search my assistant for X", "find context about X"
→ See [references/context.md](references/context.md)

**List:** "show my assistants", "what assistants do I have"
→ Run `uv run scripts/list.py`

---

## Conversation Memory

Track the last assistant used within the conversation:
- When a user creates or first uses an assistant, remember its name
- If user says "my assistant", "it", or "the assistant" → use the last one
- Briefly confirm which assistant you're using: "Asking docs-bot..."
- If ambiguous and multiple exist → ask the user to clarify

---

## Multi-Step Requests

Handle chained requests naturally. Example:

> "Create an assistant called docs-bot, upload my ./docs folder, and ask what the main features are"

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?"`

---

## Prerequisites

- `PINECONE_API_KEY` must be available:
<<api_key_setup>>
- `uv` must be installed — [install uv](https://docs.astral.sh/uv/getting-started/installation/)
- Get a free API key at: https://app.pinecone.io/?sessionType=signup